Skip to content

New Relic integration

Connecting New Relic lets DXDT query your account via NerdGraph — run NRQL over metrics, events, logs and spans, search entities with alert severity, and list open incidents. The integration is strictly read-only.
Setup time ~6 minutes
Difficulty Moderate

Access required: A user that can create a User API key and read the target account

Prerequisites

  • Your New Relic numeric Account ID
  • Knowing whether your account is on the US or EU data center

Setup

1. Find your Account ID

In New Relic, open the account dropdown (bottom-left user menu) under Administration > Access management, or read it from any New Relic URL as the number after /accounts/. It is an all-numeric value.

Note

DXDT needs the Account ID for nrql and list incidents — those commands cannot run without it.

2. Create a User API key

Go to the user menu > API keys (https://one.newrelic.com/admin-portal/api-keys/home) and click Create a key. Set Key type to User, select the account, and give it a name like dxdt-readonly.

  • Copy the key (it begins with NRAK-).
  • The key is sent in the API-Key header to NerdGraph.

Note

Create the User key under a user whose role is a read-only / standard role — a User key inherits that user's permissions, so a read-only user keeps the integration least-privilege.

3. Note your region

Set the region to US (default, api.newrelic.com) or EU (api.eu.newrelic.com). If you sign in at one.eu.newrelic.com, use EU.

Note

Region is optional and defaults to US.

Configuration fields

Field Where to find it
Account ID (account_id) Your numeric New Relic account id (from Administration > Access management or the account URL). Required for NRQL and incident queries.
User API Key (api_key) A User API key (NRAK-...) created under a read-only user. Required. Sent in the API-Key header.
Region (region) US (default, api.newrelic.com) or EU (api.eu.newrelic.com). Optional; defaults to US.

Verify the connection

Enter the Account ID, User API key, and region in the New Relic plugin's Configuration tab and click Install & Configure; the Live Status panel should show a healthy connection and the authenticated user.

Security

Your New Relic User API key and account details are stored encrypted per-tenant and are used only for read-only NerdGraph operations.

Troubleshooting

401 / authentication error from NerdGraph

The key is not a User key, is malformed, or was revoked. Create a new User API key (NRAK- prefix) and re-save.

NRQL returns no data or an account error

The account_id is missing, non-numeric, or the key's user cannot access that account. Provide the correct numeric Account ID and ensure the key's user has read access to it.

Queries hit the wrong data center

Region mismatch — an EU account queried against the US endpoint. Set the Region field to EU.

Vendor documentation: https://docs.newrelic.com/docs/apis/intro-apis/new-relic-api-keys/