New Relic NerdGraph actions

This page provides a comprehensive reference for new relic nerdgraph actions available in the workflow automation actions catalog. These actions enable you to execute nerdgraph queries and mutations.

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.

Executes a Graphql command against newrelic NerdGraph API. The command can either be a query or a mutation.

Input	Optionality	Type	Description	Example
graphql	Required	String	A GraphQL syntax. Use GraphiQL to build and test your command
variables	Required	Map[string]any	Any key/value pair variables to use with the GraphQL statement.
selectors	Optional	List	The selectors to get the only specified parameters as output.	`steps: - name: findingVar type: action action: newrelic.nerdgraph.execute version: 1 inputs: graphql: \| query GetEntity($entityGuid: EntityGuid!) { actor { entity(guid: $entityGuid) { alertSeverity } } } variables: entityGuid: ${{ .workflowInputs.entityGuid }} - name: findingInline type: action action: newrelic.nerdgraph.execute version: 1 inputs: graphql: \| { actor { entity(guid: "${{ .workflowInputs.entityGuid }}") { alertSeverity } } } selectors: - name: entities expression: '.data'`

Input

Optionality

Type

Description

Example

graphql

Required

String

A GraphQL syntax. Use GraphiQL to build and test your command

variables

Required

Map[string]any

Any key/value pair variables to use with the GraphQL statement.

selectors

Optional

List

The selectors to get the only specified parameters as output.

steps:
  - name: findingVar
    type: action
    action: newrelic.nerdgraph.execute
    version: 1
    inputs:
      graphql: |
        query GetEntity($entityGuid: EntityGuid!) {
          actor {
            entity(guid: $entityGuid) {
              alertSeverity
            }
          }
        }
      variables:
        entityGuid: ${{ .workflowInputs.entityGuid }}
  - name: findingInline
    type: action
    action: newrelic.nerdgraph.execute
    version: 1
    inputs:
      graphql: |
        {
          actor {
            entity(guid: "${{ .workflowInputs.entityGuid }}") {
              alertSeverity
            }
          }
        }
      selectors:
        - name: entities
          expression: '.data'

Output	Type	Description
data	`Map[string]any`	Contents of the `data` property of a NerdGraph response.
success	Boolean	Status of the request.
errorMessage	String	Failure reason as message.

Example
`steps: - name: currentUserId type: action action: newrelic.nerdgraph.execute version: 1 inputs: graphql: \| query userId { currentUser { id } } - name: logResult type: action action: newrelic.ingest.sendLogs version: 1 inputs: logs: - message: "userId: ${{ .steps.currentUserId.outputs.data.currentUser.id }}"`

Example

steps:
  - name: currentUserId
    type: action
    action: newrelic.nerdgraph.execute
    version: 1
    inputs:
      graphql: |
        query userId {
          currentUser {
            id
          }
        }

  - name: logResult
    type: action
    action: newrelic.ingest.sendLogs
    version: 1
    inputs:
      logs:
        - message: "userId: ${{ .steps.currentUserId.outputs.data.currentUser.id }}"

New Relic NerdGraph actions

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

Prerequisites