• Log inStart now

NerdGraph tutorial: alert policies

For New Relic alerting, you can manage your alert policies using our NerdGraph API.

Tip

For how to get started with NerdGraph, see Introduction to NerdGraph.

List and filter policies

The policiesSearch query allows you to paginate through all of your alert policies per account. It also allows some filtering functionality on the account policies.

Create a policy

In order to create a policy, supply a name and an incidentPreference.

The incident preference will configure how incidents get created for each condition created in the policy. For more information, refer to the documentation about choosing your incident preference.

mutation {
  alertsPolicyCreate(accountId: YOUR_ACCOUNT_ID, policy: {
    name: "Your Policy Name"
    incidentPreference: PER_CONDITION
  }) {
    id
    name
    incidentPreference
  }
}

Update a policy

When you update a policy, note that you don't need to supply all of the attributes on the policy. For example, you only need to supply the name if you only intend to update the name:

mutation {
  alertsPolicyUpdate(accountId: YOUR_ACCOUNT_ID, id: YOUR_POLICY_ID, policy: {
    name: "Updated Policy Name"
  }) {
    id
    name
    incidentPreference
  }
}

Delete a policy

You can delete policies via the NerdGraph API. Note that only the id may be requested back from a deleted resource:

mutation {
  alertsPolicyDelete(accountId: YOUR_ACCOUNT_ID, id: YOUR_POLICY_ID) {
    id
  }
}
Copyright © 2022 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.