New Relic Ingest actions

preview

We're still working on this feature, but we'd love for you to try it out!

This feature is currently provided as part of a preview program pursuant to our pre-release policies.

This page provides a comprehensive reference for new relic ingest actions available in the workflow automation actions catalog. These actions enable you to send events and logs to new relic.

Prerequisites

Before using New Relic actions in workflow automation, ensure you have:

A New Relic account with appropriate permissions.
A New Relic license key (if sending data to a different account).
The necessary permissions for the specific New Relic services you plan to use.

See License Key for information on how to create and manage your New Relic Account License Key.

Data ingest actions

Reports a custom event to New Relic.

Input Field	Optionality	Type	Description	Example
attributes	Optional	Map	Common attributes which is part of all the events when provided. Merging for each event item when needed event item overrides common definition.	`"{\"page\": \"1\", \"limit\": \"10\"}"`
events	Required	List	The list of event data. Important Events requires the use of 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	Optional	String	The New Relic Account License Key (required) 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	Optional	List	The selectors to get only the specified parameters as output.	`[{\"name\": \"success\", \"expression\": \".success\"}]`

Output Field	Type
success	Boolean
errorMessage	string

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`

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

Send logs to New Relic

Input Field	Optionality	Type	Description	Example
attributes	Optional	Map	Common attributes are included in all logs when provided. These merge with each log item, with log-specific values overriding common attributes when conflicts occur.	`"{\"page\": \"1\", \"limit\": \"10\"}"`
logs	Required	List	List of logs. Each log requires a `message` field. Maximum of 100 logs per request.	`"[{\"message\":\"XYZ\",\"attributes\":{\"foo\":\"bar\"}}, {\"message\":\"ABC\",\"value\":\"1234\",\"attributes\":{\"color\":\"red\"}}]"`
licenseKey	Optional	String	The New Relic Account License Key (required) 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	Optional	List	The selectors to get only the specified parameters as output.

Output Field	Type
success	Boolean
errorMessage	string

Workflow example
`name: heartbeat_newrelicIngestSendLogs workflowInputs: cellName: type: String steps: - name: runAction type: action action: newrelic.ingest.sendLogs version: 1 inputs: attributes: colour: red id: 1234 logs: - message: 'Heartbeat sendLogs Action Test Message' attributes: foo: bar - message: 'HeartBeat1234' attributes: foo: bar - message: 'HeartBeat12345' attributes: foo: bar colour: yellow - message: 'HeartBeat12345678' selectors: - name: success expression: ".success"` Expected output: `{ "success": true }` Retrieve logs: After successfully executing a workflow, you can retrieve the associated log by running a query under the account that executed the workflow: `SELECT * FROM Log`

Workflow example

name: heartbeat_newrelicIngestSendLogs

workflowInputs:
cellName:
  type: String

steps:
- name: runAction
  type: action
  action: newrelic.ingest.sendLogs
  version: 1
  inputs:
    attributes:
      colour: red
      id: 1234
    logs:
      - message: 'Heartbeat sendLogs Action Test Message'
        attributes:
          foo: bar
      - message: 'HeartBeat1234'
        attributes:
          foo: bar
      - message: 'HeartBeat12345'
        attributes:
          foo: bar
          colour: yellow
      - message: 'HeartBeat12345678'
    selectors:
      - name: success
        expression: ".success"

Expected output:

{
  "success": true
}

Retrieve logs:

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

SELECT * FROM Log

preview

Prerequisites.css-21sua1{background:none;border:none;width:0;padding:0;}

Data ingest actions

Send logs to New Relic

Prerequisites