Notify your team about APM application deployments

After you record a deployment for an APM application entity, you can keep your team informed about those changes through the use of a webhook. These are available whether you record your deployment using the change tracking feature or the older REST API.

Required permissions

Change tracking notification settings require specific permissions:

• To create the webhook: Modify permissions for Applied intelligence > Destinations and Applied intelligence > Channels.
• To view and test the webhook: View permissions for Applied intelligence > Destinations and Applied intelligence > Channels.
• To modify the webhook: View permissions for Applied intelligence > Destinations and Applied intelligence > Channels, and Modify on Applied intelligence > Destinations.
• To delete the webhook: Delete permissions for Applied intelligence > Destinations and Applied intelligence > Channels.

Get your webhook destination URL

You can send deployment data to a variety of webhook destinations. Follow the instructions for the tool you're using to get the webhook URL. Once you have the URL, complete the steps in the next section to configure webhook notifications.

If you're using Slack, follow the instructions here to set up the legacy New Relic alerts app:

1. Log in to your Slack account as an admin, and then go to Apps.
2. Search for New Relic Alerts, and click on that tile.
3. In the New Relic Alerts listing, click the Configuration button below the New Relic icon.
4. Click the Configuration tab below the heading New Relic Alerts.
5. On the Configuration tab, click the pencil icon.
6. Scroll down to the Webhook URL section, and click Copy URL.

Configure webhook notifications for tracked changes

Insert the webhook URL in the New Relic UI:

1. Go to the deployment notifications configuration screen: one.newrelic.com > (user menu) > Administration > Integrations > Deploy notifications.
2. Paste your webhook URL into the Webhook URL field and click Save.
3. Click Send a test request to send an example payload with artificial data to your webhook URL.
4. Under Toggle this webhook, you can disable or re-enable the webhook notification by sliding the toggle.
5. To permanently delete the webhook notification configuration, click Delete this webhook.

Notification payload structure

When your deployment notification is enabled and you start tracking a change, your webhook will receive a POST request with a payload of type application/x-www-form-urlencoded. The keys and values are encoded in key-value tuples separated by an &, with an = symbol between the key and the value. Non-alphanumeric characters in both keys and values will be URL-encoded.

The following keys and values will be sent, based on the attributes of the deployment and of the APM application entity that was deployed.