New Relic

Run NRQL queries and manage alerts via the New Relic NerdGraph GraphQL API.

Operations

API Key Setup

1. Log into New Relic and go to Profile > API keys (top-right avatar menu).
2. Create a key of type User — this is the key accepted by NerdGraph.
3. Copy the key value; pass it as apiKey in every tool invocation.

Note: Ingest (license) keys do NOT work with NerdGraph.

Parameters

Examples

Run a NRQL query

[
  {
    "name": "count-transactions",
    "type": "tool",
    "toolName": "new-relic",
    "input": {
      "apiKey": "{{credential.nrApiKey}}",
      "operation": "run_nrql",
      "accountId": "1234567",
      "nrql": "SELECT count(*) FROM Transaction SINCE 1 HOUR AGO"
    }
  }
]

Search for APM application entities

[
  {
    "name": "find-app",
    "type": "tool",
    "toolName": "new-relic",
    "input": {
      "apiKey": "{{credential.nrApiKey}}",
      "operation": "search_entities",
      "entityQuery": "name LIKE 'checkout' AND domainType IN ('APM-APPLICATION')"
    }
  }
]

List alert policies

[
  {
    "name": "list-policies",
    "type": "tool",
    "toolName": "new-relic",
    "input": {
      "apiKey": "{{credential.nrApiKey}}",
      "operation": "list_alert_policies",
      "accountId": "1234567"
    }
  }
]

Create an alert policy and NRQL condition

[
  {
    "name": "create-error-alert",
    "type": "tool",
    "toolName": "new-relic",
    "input": {
      "apiKey": "{{credential.nrApiKey}}",
      "operation": "create_nrql_condition",
      "accountId": "1234567",
      "policyName": "High Error Rate Policy",
      "conditionName": "Transaction errors exceed threshold",
      "conditionNrql": "SELECT count(*) FROM TransactionError SINCE 5 MINUTES AGO",
      "threshold": "50",
      "thresholdDuration": "300"
    }
  }
]

Output

All operations publish:

• result — raw JSON response body from NerdGraph (string)
• status — HTTP status code (string, normally "200")
• truncated — set to "true" if the response exceeded 5 MB and was capped

Publishes

The keys a later task may reference as {{taskName.key}}. Referencing anything not listed here resolves to nothing at run time.

• error
• result
• status
• truncated

Input Properties

Every property this tool accepts, from its own tool.iml.