1. Home
  2. Guides
  3. Observability
  4. Alerts

Managing alert integrations

Alert integrations are external channels that receive notifications when alerts are triggered. When creating an alert definition, 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.
  2. Go to 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:

  1. Datadog
  2. New Relic
  1. In Datadog, create a new API key with read and write access, then save it and copy it.
  2. Log in to the Fastly control panel.
  3. Go to 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 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.

Incident response and on-call alert integrations

To create incident response and on-call alert integrations, follow these steps:

  1. Jira Service Management
  2. Opsgenie
  3. PagerDuty
  4. Splunk On-Call
  1. In Jira Service Management, create an API integration and copy the generated API key.
  2. Log in to the Fastly control panel.
  3. Go to 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.

Team communication alert integrations

To create team communication alert integrations, follow these steps:

  1. Email
  2. Jira Issue
  3. Microsoft Teams
  4. Slack
  1. Log in to the Fastly control panel.
  2. Go to 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.

Custom webhook integrations

To create custom webhook alert integrations, follow these steps:

  1. Log in to the Fastly control panel.
  2. Go to 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.
  2. Go to Observability > Alerts > Integrations.
  3. Click the pencil Pencil icon 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 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 page, click the trash Trash icon 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 reference.

Fastly
© Fastly 2026