New Relic NerdGraph 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 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.

NerdGraph actions

Execute a GraphQL query or mutation against New Relic NerdGraph API

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: sayHello type: action action: example.messaging.sayHello version: 1 inputs: name: ${{ .steps.currentUserId.outputs.data.currentUser.id }}`