---
title: Managing alert integrations
summary: null
url: >-
https://www.fastly.com/documentation/guides/observability/alerts/managing-alert-integrations
---
Alert integrations are external channels that receive notifications when alerts are triggered. When creating an [alert definition](https://www.fastly.com/documentation/guides/observability/alerts/managing-alert-definitions), you specify the alert integrations that should be used. Multiple alert definitions can use the same alert integration.
## Accessing alert integrations
To view a list of your alert integrations, follow these steps:
1. Log in to the [Fastly control panel](https://manage.fastly.com).
2. Go to **Observability** > **Alerts** > [**Integrations**](https://manage.fastly.com/observability/alerts/integrations). The Alert integrations page appears.
## Creating alert integrations
You can create several different types of alert integrations.
### Observability alert integrations
To create observability alert integrations, follow these steps:
### Datadog
1. In Datadog, [create a new API key](https://docs.datadoghq.com/cloudcraft/getting-started/generate-api-key/) with read and write access, then save it and copy it.
2. Log in to the [Fastly control panel](https://manage.fastly.com).
3. Go to **Observability** > **Alerts** > [**Integrations**](https://manage.fastly.com/observability/alerts/integrations).
4. Click **Add alert integration**.
5. From the **Integration type** menu, select **Datadog**.
6. Fill out the integration details as follows:
- In the **Name** field, enter the name of the integration.
- In the **API key** field, enter the API key you created in the first step.
- From the **Site** menu, select a [Datadog site](https://docs.datadoghq.com/getting_started/site/) through which data should be handled.
- In the **Description** field, enter a description of the integration.
7. Click **Save integration**. The integration is added to the Alert integrations page.
### New Relic
1. In New Relic, [create a new License key](https://docs.newrelic.com/docs/apis/intro-apis/new-relic-api-keys/) on the account where you want to ingest data. Make note of both the License key and Account ID.
2. Log in to the [Fastly control panel](https://manage.fastly.com).
3. Go to **Observability** > **Alerts** > [**Integrations**](https://manage.fastly.com/observability/alerts/integrations).
4. Click **Add alert integration**.
5. From the **Integration type** menu, select **New Relic**.
6. Fill out the integration details as follows:
- In the **Name** field, enter the name of the integration.
- In the **Account ID** field, enter the account ID you obtained in the first step.
- In the **License key** field, enter the license key you created in the first step.
- In the **Description** field, enter a description of the integration.
7. Click **Save integration**. The integration is added to the Alert integrations page.
### Incident response and on-call alert integrations
To create incident response and on-call alert integrations, follow these steps:
### Jira Service Management
1. In Jira Service Management, [create an API integration](https://support.atlassian.com/jira-service-management-cloud/docs/configure-the-jira-service-management-api/) and copy the generated API key.
2. Log in to the [Fastly control panel](https://manage.fastly.com).
3. Go to **Observability** > **Alerts** > [**Integrations**](https://manage.fastly.com/observability/alerts/integrations).
4. Click **Add alert integration**.
5. From the **Integration type** menu, select **Jira Service Management**.
6. Fill out the integration details as follows:
- In the **Name** field, enter the name of the integration.
- In the **JSM API Key** field, enter the API key you copied from the integration configuration.
- In the **Description** field, enter a description of the integration.
7. Click **Save integration**. The integration is added to the Alert integrations page.
### Opsgenie
> **WARNING:** On March 4, 2025 Atlassian announced that Opsgenie would no longer be available for purchase, effective June 4, 2025. Existing customers are able to continue using Opsgenie, without interruption, until the end of support on April 5, 2027. Opsgenie customers have until this date to move their data and configurations to Jira Service Management, which Fastly provides an alert integration for. For more information about Atlassian's end-of-life announcement and what to do about it, read their guidance on [managing your Opsgenie account](https://www.atlassian.com/licensing/opsgenie#managing-my-opsgenie-account).
1. In Opsgenie, [create an API integration](https://support.atlassian.com/opsgenie/docs/api-integration/) and copy the API key.
2. Log in to the [Fastly control panel](https://manage.fastly.com).
3. Go to **Observability** > **Alerts** > [**Integrations**](https://manage.fastly.com/observability/alerts/integrations).
4. Click **Add alert integration**.
5. From the **Integration type** menu, select **Opsgenie**.
6. Fill out the integration details as follows:
- In the **Name** field, enter the name of the integration.
- In the **API Key** field, enter the API key you copied from the integration configuration.
- In the **Description** field, enter a description of the integration.
7. Click **Save integration**. The integration is added to the Alert integrations page.
### PagerDuty
1. In PagerDuty, [create a new service](https://support.pagerduty.com/docs/services-and-integrations#section-create-a-new-service) and copy the integration key. Be sure to set the escalation policy and integration method to **Use Our API Directly**.
2. Log in to the [Fastly control panel](https://manage.fastly.com).
3. Go to **Observability** > **Alerts** > [**Integrations**](https://manage.fastly.com/observability/alerts/integrations).
4. Click **Add alert integration**.
5. From the **Integration type** menu, select **PagerDuty**.
6. Fill out the integration details as follows:
- In the **Name** field, enter the name of the integration.
- In the **Service API Key** field, enter the integration key you created in the first step.
- In the **Description** field, enter a description of the integration.
7. Click **Save integration**. The integration is added to the Alert integrations page.
### Splunk On-Call
1. In Splunk On-Call (VictorOps), [enable the REST – Generic integration](https://help.victorops.com/knowledge-base/rest-endpoint-integration-guide/) and copy the REST Endpoint URL with your routing key configured.
2. Log in to the [Fastly control panel](https://manage.fastly.com).
3. Go to **Observability** > **Alerts** > [**Integrations**](https://manage.fastly.com/observability/alerts/integrations).
4. Click **Add alert integration**.
5. From the **Integration type** menu, select **Splunk On-Call**.
6. Fill out the integration details as follows:
- In the **Name** field, enter the name of the integration.
- In the **Webhook URL** field, enter the REST Endpoint URL you copied from the integration configuration.
- In the **Description** field, enter a description of the integration.
7. Click **Save integration**. The integration is added to the Alert integrations page.
### Team communication alert integrations
To create team communication alert integrations, follow these steps:
### Email
1. Log in to the [Fastly control panel](https://manage.fastly.com).
2. Go to **Observability** > **Alerts** > [**Integrations**](https://manage.fastly.com/observability/alerts/integrations).
3. Click **Add alert integration**.
4. From the **Integration type** menu, select **Email**.
5. Fill out the integration details as follows:
- In the **Name** field, enter the name of the integration.
- In the **Email** field, enter the email address that should receive the alert notifications.
- In the **Description** field, enter a description of the integration.
6. Click **Save integration**. An email asking you to confirm the address you entered in the **Email** field is sent to the email address you entered.
7. Navigate to the relevant email account and open the confirmation email from Fastly.
8. Click **Confirm email address**. Your email address is verified and the integration is added to the Alert integrations page.
### Jira Issue
1. In Jira, [create an API token](https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/) for the account that will create alert issues.
2. Log in to the [Fastly control panel](https://manage.fastly.com).
3. Go to **Observability** > **Alerts** > [**Integrations**](https://manage.fastly.com/observability/alerts/integrations).
4. Click **Add alert integration**.
5. From the **Integration type** menu, select **Jira Issue**.
6. Fill out the integration details as follows:
- In the **Name** field, enter the name of the integration.
- In the **Jira instance URL** field, enter the URL of your Jira instance (e.g., `yourcompany.atlassian.net`).
- In the **Email** field, enter the email address of the Jira account that will authenticate and create issues.
- In the **API Token** field, enter the API token for the Jira account specified above.
- In the **Project Key** field, enter the project key where alert issues should be created (e.g., `PROJ` or `OPS`).
- In the **Issue Type** field, enter the type of issue to create (e.g., `Task`, `Bug`, or `Incident`).
- In the **Description** field, enter a description of the integration.
7. Click **Save integration**. The integration is added to the Alert integrations page.
### Microsoft Teams
1. In Microsoft Teams, [add an incoming webhook](https://support.microsoft.com/en-us/office/post-a-workflow-when-a-webhook-request-is-received-in-microsoft-teams-8ae491c7-0394-4861-ba59-055e33f75498) and copy the URL for the webhook.
2. Log in to the [Fastly control panel](https://manage.fastly.com).
3. Go to **Observability** > **Alerts** > [**Integrations**](https://manage.fastly.com/observability/alerts/integrations).
4. Click **Add alert integration**.
5. From the **Integration type** menu, select **Microsoft Teams**.
6. Fill out the integration details as follows:
- In the **Name** field, enter the name of the integration.
- In the **Webhook URL** field, enter the URL of the webhook you created in the first step.
- In the **Description** field, enter a description of the integration.
7. Click **Save integration**. The integration is added to the Alert integrations page.
### Slack
1. In Slack, [add an incoming webhook](https://api.slack.com/messaging/webhooks) and copy the URL for the webhook.
2. Log in to the [Fastly control panel](https://manage.fastly.com).
3. Go to **Observability** > **Alerts** > [**Integrations**](https://manage.fastly.com/observability/alerts/integrations).
4. Click **Add alert integration**.
5. From the **Integration type** menu, select **Slack**.
6. Fill out the integration details as follows:
- In the **Name** field, enter the name of the integration.
- In the **Webhook URL** field, enter the URL of the webhook you created in the first step.
- In the **Description** field, enter a description of the integration.
7. Click **Save integration**. The integration is added to the Alert integrations page.
### Custom webhook integrations
To create custom webhook alert integrations, follow these steps:
1. Log in to the [Fastly control panel](https://manage.fastly.com).
2. Go to **Observability** > **Alerts** > [**Integrations**](https://manage.fastly.com/observability/alerts/integrations).
3. Click **Add alert integration**.
4. From the **Integration type** menu, select **Custom webhook**.
5. Fill out the integration details as follows:
- In the **Name** field, enter the name of the integration.
- In the **Webhook URL** field, enter the webhook URL that should receive the alert notifications.
- In the **Description** field, enter a description of the integration.
6. Click **Save integration**. The integration is added to the Alert integrations page.
> **HINT:** Using a Slack webhook URL won't work with this integration. Use the Slack integration instead.
## Editing alert integrations
To edit an alert integration, follow these steps:
1. Log in to the [Fastly control panel](https://manage.fastly.com).
2. Go to **Observability** > **Alerts** > [**Integrations**](https://manage.fastly.com/observability/alerts/integrations).
3. Click the pencil 
to the right of the alert integration that you want to edit.
4. Edit the necessary fields. Override locked fields by clicking **Override** then confirming you want to edit the field.
> **HINT:** If you change the type of integration, you may need to fill out additional fields. Refer to [Creating alert integrations](https://www.fastly.com/documentation/guides/observability/alerts/managing-alert-integrations#creating-alert-integrations) for field descriptions for each integration.
5. Click **Save integration**.
## Deleting alert integrations
To delete an alert integration, follow these steps:
1. From the [**Alert integrations**](https://manage.fastly.com/observability/alerts/integrations) page, click the trash 
to the right of the alert integration that you want to delete.
2. Click **Confirm and delete**. The alert integration is removed from the Alert integrations page.
## Notification payloads
When an observability metrics alert fires or resolves, or when an audit log event matches an audit log alert's conditions, Fastly sends a structured notification payload to your configured integrations. For the payload format of each integration type and examples for common scenarios, check out our [notification payloads](https://www.fastly.com/documentation/guides/observability/alerts/alert-notification-payloads) reference.