New Relic

To add a New Relic step to your flow:

1.   Go to the Apps tab of the palette, expand New Relic section, and drag the Acknowledge or Close Issue step onto the canvas.
   • For instructions on using the New Relic trigger, see New Relic Incidents trigger.
2. Connect the step to the previous step in the flow. This gives you access to the alert properties and outputs of previous steps when you configure this step's inputs.
3. Double-click the step to edit it, and use the Setup tab to configure the inputs. You can use plain text and input variables (or both). See the following section for detailed information on the inputs, including which are required.
4. On the Endpoint tab, configure the step to point to your New Relic instance.
   • You can select a pre-existing endpoint or create a new endpoint.
   • To set up an endpoint with an Authentication Type of None, add one of the following URLs in the Base URL field:
     • New Relic North America data region: https://api.newrelic.com
     • New Relic EU data region: https://api.eu.newrelic.com

Using the Acknowledge or Close Issue step does not resolve the issue in New Relic; you may continue to receive notifications until the issue is resolved.

Inputs

Inputs with an asterisk* are required.

Outputs

1. In New Relic, go to Alerts and AI > Workflows and click Add a workflow.

   

2. On the Configure your workflow page, fill in the following fields:
   • Name: Give the workflow a unique name.
   • Filter data: Set at least one filter parameter using the Tag, Policy, and Priority drop-down menus.

   

3. In the Notify section, select Webhook.
4. On the Edit notification message screen go to the Destination drop-down menu. Select an existing destination or create a new one.

   

   • If you select an existing destination, skip to Step 7.
   • If you need to create a new destination go to Step 5.
5. To create a new destination, fill in the following fields on the Add a destination screen:
   • Webhook name: Give the webhook a unique name.
   • Endpoint URL: Paste the URL you copied from the xMatters trigger. Add the target names of any recipients you want to notify when the alert fires to the end of the URL.
     • For URL authentication, use an ampersand to attach recipients. For example, if you want to notify Emma Pearson and the on-call members in the group responsible for the Antares service, you'd add &recipients=epearson,antares to the URL.
     • For other authentication types, use a question mark to attach recipients. For example, if you want to notify Barry Gull and the on-call members in the group responsible for the Cassiopeia service, you'd add ?recipients=bgull,cassiopeia to the URL.
     • You must URL-encode any special characters or spaces in the target names.

   

6. Click Save destination.
7. On the Edit notification message screen, go to Payload. In the Template section, enter the payload you copied from the trigger in xMatters.

   

8. Optional: Click Send test notification to send a test alert and confirm the configuration is correct.
9. Click Save message.

You're ready to use the webhook to trigger automated flows, including steps such as sending alerts and initiating incidents, though we always recommend testing before putting things into use.

The trigger has the following outputs you can use as inputs to steps further along the flow.