New Relic connector
The New Relic connector connects directly to New Relic's NerdGraph (GraphQL) API. It lets a workflow or agent claim and close New Relic AI issues, read issues and their underlying incidents, suppress notifications during a deploy or maintenance window with muting rules, record deployment markers, and run arbitrary NRQL queries for enrichment.
This is a custom connector that uses New Relic's NerdGraph GraphQL API with API-key authentication.
You can create a New Relic connector in Stack Management > Connectors.
- User API Key
- A New Relic User API key (prefixed
NRAK-). Create one under your user profile → API keys. - Account ID
- The numeric New Relic account ID this connector operates against. Found in the New Relic UI under your account name, or in account-scoped URLs as
one.newrelic.com/accounts/<accountId>. To manage another account, create a separate connector instance. - Region
- The data center hosting your New Relic account:
us(default),eu, orjp. Determines which NerdGraph endpoint is used.
All actions below operate on the account ID configured on the connector.
| Action | Description |
|---|---|
acknowledgeIssue |
Acknowledge an AI issue via aiIssuesAckIssue. Parameters: issueId (required). |
unacknowledgeIssue |
Reverse an acknowledgment via aiIssuesUnackIssue. Parameters: issueId (required). |
resolveIssue |
Resolve/close an AI issue via aiIssuesResolveIssue. Parameters: issueId (required). |
listIssues |
List AI issues with optional states, priority, entityGuids, since/until, and cursor filters. |
listIncidents |
List the individual incidents grouped under issues, with the same filter shape as listIssues. |
createMutingRule |
Create a muting rule via alertsMutingRuleCreate. Parameters: name, condition (both required), description, enabled. |
updateMutingRule |
Update an existing muting rule via alertsMutingRuleUpdate. Parameters: mutingRuleId (required), name, description, enabled, condition. |
deleteMutingRule |
Delete a muting rule via alertsMutingRuleDelete. Parameters: mutingRuleId (required). |
listMutingRules |
List existing muting rules for the account. |
runNrqlQuery |
Run an NRQL query and return the results. Parameters: nrql (required), timeoutSeconds. |
createDeploymentMarker |
Record a change event via changeTrackingCreateEvent. Parameters: entityGuid, version (both required), description, user, deploymentType, groupId, timestamp. |
listAlertPolicies |
List alert policies, optionally filtered by name. Parameters: nameFilter, cursor. |
listNrqlConditions |
List the NRQL conditions under a policy. Parameters: policyId (required). |
createAlertPolicy |
Provision a new alert policy via alertsPolicyCreate. Parameters: name (required), incidentPreference. |
createNrqlCondition |
Create a static NRQL alert condition via alertsNrqlConditionStaticCreate. Parameters: policyId, name, nrql, thresholdOperator, thresholdValue, thresholdDurationSeconds (all required), enabled. |
Use the Action configuration settings to customize connector networking, such as proxies, certificates, or TLS settings. You can set configurations that apply to all your connectors or use xpack.actions.customHostSettings to set per-host configurations.
- Log in to your New Relic account.
- Go to your user profile menu > API keys.
- Create a new User key.
- Copy the key and store it securely.
- Note your account ID (visible in the New Relic UI under your account name, or in account-scoped URLs) and which region your account is hosted in (US, EU, or JP) — you'll need both when configuring the connector.
- When configuring the connector, enter the key as the User API Key, and set the Account ID and Region fields.