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.

HINT: Want to set up alerting for the Next-Gen WAF? Check out our Next-Gen WAF guides.

Accessing alert definitions

To view a list of your alert definitions, follow these steps:

  1. Log in to the Fastly control panel.
  2. Go to Observability > Alerts > Definitions. The Alert definitions page appears.

Creating alert integrations

To create an alert integration, follow these steps:

the Add integration page

  1. Slack
  2. Email
  3. PagerDuty
  4. Microsoft Teams
  5. New Relic
  6. Webhook
  1. In Slack, add an incoming webhook and copy the URL for the webhook.
  2. Log in to the Fastly control panel.
  3. Go to Observability > Alerts > Integrations.
  4. Click Add alert integration.
  5. Fill out the Add integration controls as follows:
    • Click Slack.
    • 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 notification channel.
  6. Click Save integration. The integration is added to the Alert integrations page.

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 alert fires or resolves, Fastly sends a structured notification payload to your configured integrations. Each integration type receives a payload formatted specifically for that platform's API or webhook format, containing details about the alert, the metric that triggered it, and links to view more information in the Fastly control panel.

  1. Slack
  2. Email
  3. PagerDuty
  4. Microsoft Teams
  5. New Relic
  6. Webhook

Slack notifications use the Slack API attachment format with color-coded messages: red for firing alerts and green for resolved alerts.

{
  "username": "Fastly Alerts",
  "icon_url": "https://manage.fastly.com/observe/logo.png",
  "attachments": [
    {
      "color": "#dd2530 | #36a64f",
      "title": "Alert title with link",
      "title_link": "URL to alert history",
      "mrkdwn_in": ["Details"],
      "fields": [
        {"title": "Field name", "value": "Field value", "short": false}
      ]
    }
  ]
}

For example, this is a Slack notification that was sent when the origin bandwidth exceeded 100Mbps:

{
  "username": "Fastly Alerts",
  "icon_url": "https://manage.fastly.com/observe/logo.png",
  "attachments": [
    {
      "color": "#dd2530",
      "title": "[FIRING] all_bandwidth high on critical origins",
      "title_link": "https://manage.fastly.com/observability/alerts/history/def_XyZ9kL3mN8pQ2vR7wB4tJ?id=hist_A7bC2dE9fG3hJ8kL5m",
      "mrkdwn_in": ["Details"],
      "fields": [
        {
          "title": "High Origin Bandwidth Alert",
          "value": "125Mbps",
          "short": false
        },
        {
          "title": "Started (UTC)",
          "value": "2026-02-27T10:30:00Z",
          "short": false
        },
        {
          "title": "Details",
          "value": "- *name:* High Origin Bandwidth Alert\n- *description:* Triggers when origin bandwidth exceeds 100Mbps\n- *metric:* all_bandwidth\n- *service:* svc_M4nP7qR2sT9vW3xY8zA\n- *evaluation type:* above_threshold\n- *threshold:* 750000000\n- *evaluation period:* 5m\n- *sources:* origin1, origin3",
          "short": false
        }
      ]
    }
  ]
}
Fastly
© Fastly 2026