• /
  • EnglishEspañolFrançais日本語한국어Português
  • EntrarComeçar agora

Send events to New Relic

|View as Markdown (English)

Reports custom events to New Relic.

For prerequisites, see New Relic Ingest actions.

Send events to New Relic

The action identifier is newrelic.ingest.sendEvents.

Reports a custom event to New Relic.

The following table describes all available input fields for this action.

Input

Type

Description

Example

attributes

Map

Optional. Common attributes included in all events when provided.

Merges with each event item; event-level values override common attributes when conflicts occur.

"{\"page\": \"1\", \"limit\": \"10\"}"

events

List

Required. The list of event data.

Importante

Events require an eventType field that represents the custom event type. The maximum events allowed per request is 100.

"[{\"eventType\":\"XYZ\",\"attributes\":{\"foo\":\"bar\"}}, {\"eventType\":\"ABC\",\"value\":\"1234\",\"attributes\":{\"color\":\"red\"}}]"

licenseKey

String

Optional. The New Relic Account License Key specifies the target account for your events. If not provided, the system uses the default license key from the account executing the workflow.

Read more about our API keys to create and manage your New Relic Account License Key.

"{{ .secrets.secretName }}", where secretName is the key under which the license key is stored.

selectors

List

Optional. The selectors to get only the specified parameters as output.

[{\"name\": \"success\", \"expression\": \".success\"}]

The following table describes all output fields returned by this action.

Output

Type

Description

success

Boolean

true on success, false on failure.

errorMessage

String

Failure reason as message. null on success.

The following example sends multiple custom events with shared and per-event attributes, then retrieves them with a NRQL query.

Workflow example

name: heartbeat_newrelicIngestSendEvents
workflowInputs:
cellName:
type: String
steps:
- name: runAction
type: action
action: newrelic.ingest.sendEvents
version: 1
inputs:
attributes:
colour: red
id: 1234
events:
- eventType: HeartBeat
test: "OK"
attributes:
foo: bar
- eventType: HeartBeat1234
test: "OK1234"
attributes:
foo: bar
- eventType: HeartBeat12345
test: "OK12345"
attributes:
foo: bar
colour: yellow
- eventType: HeartBeat12345678
test: "OK12345678"
selectors:
- name: success
expression: ".success"

Expected output:

{
"success": true
}

Retrieve events:

After successfully executing a workflow, you can retrieve the associated event by running a query under the account that executed the workflow:

SELECT * FROM HeartBeat
Copyright © 2026 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.