Skip to main content

Alert Channels

Receive alerts where your team works.

Overview​

Alert notifications are delivered through named destinations and personal email subscriptions. Each destination is a named integration (e.g. "Ops Slack", "PagerDuty Critical") configured at the organization or project level.

Supported Channels​

  • Slack - Post to channels via incoming webhook
  • Discord - Webhook-based notifications
  • Microsoft Teams - Incoming webhook integration
  • Mattermost - Self-hosted chat notifications
  • Webhooks - Custom integrations
  • Email - Personal per-member subscription

Destination Groups​

Each destination belongs to a delivery group:

GroupDescription
PrimaryReceives notifications immediately when an incident is created or updated
BackupReceives critical escalation after 30 minutes without acknowledgment

Backup destinations require Critical severity. They do not imply provider-failure failover.

Managing Destinations​

View Destinations​

  1. Go to Monitoring > Alerts > Notifications
  2. View all destinations configured in the current scope (organization or project)

Team channel destinations and your personal email subscription are shown in separate sections.

Create a Destination​

  1. Go to Monitoring > Alerts > Notifications
  2. Click Add destination
  3. Enter a name, select the channel type and delivery group
  4. Choose which severities trigger this destination (at least one required)
  5. Paste the webhook URL (HTTPS required)
  6. Save the destination

The webhook URL is write-only — it is never returned by the API after creation.

Edit a Destination​

  1. Click a destination to open its settings drawer
  2. Update name, enabled state, delivery group or severities
  3. Optionally replace the webhook URL (omit to keep the existing URL)
  4. Save changes

Changing the channel type requires creating a new destination.

Delete a Destination​

  1. Open the destination settings
  2. Click Delete
  3. Confirm the deletion

Test a Destination​

  1. Open the destination settings
  2. Click Test
  3. Review the result: Accepted, Failed or Uncertain

An accepted result means the provider accepted the request, not that a person received it. Uncertain means delivery could not be confirmed.

Enable / Disable​

Toggle the enabled state on a destination to pause or resume notifications without deleting the configuration.

Slack Integration​

Setup Steps​

  1. Go to your Slack workspace
  2. Create an incoming webhook:
    • Go to Apps > Incoming Webhooks
    • Or visit https://your-workspace.slack.com/apps/A0F7XDUAZ
  3. Click Add to Slack
  4. Choose a channel
  5. Copy the webhook URL

Configure in SailOps​

  1. Go to Monitoring > Alerts > Notifications
  2. Click Add destination
  3. Select Slack as the channel
  4. Paste the webhook URL
  5. Choose severities and delivery group
  6. Test and save

Discord Integration​

Setup Steps​

  1. Open Discord
  2. Go to channel settings
  3. Select Integrations > Webhooks
  4. Click New Webhook
  5. Copy the webhook URL

Configure in SailOps​

  1. Go to Monitoring > Alerts > Notifications
  2. Click Add destination
  3. Select Discord as the channel
  4. Paste the webhook URL
  5. Choose severities and delivery group
  6. Test and save

Microsoft Teams Integration​

Setup Steps​

  1. Open Microsoft Teams
  2. Go to the channel for alerts
  3. Click ... > Connectors
  4. Find Incoming Webhook
  5. Click Configure
  6. Name the connector and copy URL

Configure in SailOps​

  1. Go to Monitoring > Alerts > Notifications
  2. Click Add destination
  3. Select Microsoft Teams as the channel
  4. Paste the webhook URL
  5. Choose severities and delivery group
  6. Test and save

Mattermost Integration​

Setup Steps​

  1. Go to Mattermost Integrations
  2. Click Incoming Webhooks
  3. Create new webhook
  4. Select channel
  5. Copy the webhook URL

Configure in SailOps​

  1. Go to Monitoring > Alerts > Notifications
  2. Click Add destination
  3. Select Mattermost as the channel
  4. Paste the webhook URL
  5. Choose severities and delivery group
  6. Test and save

Email Subscriptions​

Each member can subscribe to email notifications independently:

  1. Go to Monitoring > Alerts > Notifications
  2. In the email subscription section, toggle your subscription on or off
  3. Enabling requires a verified email address on your identity

Email subscriptions are personal — you can only manage your own, and your subscription state is never visible to other members. Disabling records an explicit opt-out for the current scope. Organization and project subscriptions are independent; an opt-out at the project level does not affect the organization subscription.

Webhooks (Custom Integration)​

Use Cases​

  • Custom alerting systems
  • SIEM integration
  • PagerDuty, Opsgenie
  • Internal tools
  • Automation triggers

Configure Webhook​

  1. Go to Monitoring > Alerts > Notifications
  2. Click Add destination
  3. Select Webhook as the channel
  4. Enter your webhook endpoint URL (HTTPS required)
  5. Choose severities and delivery group
  6. Test and save

Alerts are sent as HTTP POST requests to your endpoint.

Delivery Behavior​

Parallel Delivery​

All enabled destinations receive notifications in parallel. A failure in one destination does not block others.

Delivery Statuses​

StatusDescription
PendingNotification queued for delivery
AcceptedProvider accepted the request
FailedDelivery failed after retries
UncertainDelivery could not be confirmed
CancelledDelivery was cancelled (e.g. maintenance window)
SuppressedDelivery was suppressed (e.g. duplicate)

Scope and Inheritance​

Destinations are configured at the organization or project level. The Notifications page in the Alert Center shows destinations in the selected scope. When viewing a resource's alerts, the page explains that organization or project configuration may also apply.

Maintenance Windows​

Maintenance windows pause notification delivery while observation continues. See Alerts Overview for details on creating and managing maintenance windows.

Best Practices​

1. Use Primary and Backup Groups​

Primary: Slack #ops-alerts → All severities
Backup: PagerDuty → Critical only (escalates after 30 min)

2. Test Before Relying on Destinations​

Always test after creating or updating a destination.

3. Separate Critical from Noise​

Create separate destinations for different severity levels:

  • A Slack channel for all alerts
  • A PagerDuty integration for critical only

4. Review Delivery Outcomes​

Check the delivery section in the incident inspector to confirm notifications reached your team.

5. Review Periodically​

  • Remove unused destinations
  • Update webhook URLs if changed
  • Verify email subscriptions after team changes

Troubleshooting​

Not Receiving Notifications​

  1. Check that the destination is enabled
  2. Verify notifications are activated on the relevant rules (seven-day observation required for metric rules)
  3. Test the destination
  4. Check that no maintenance window is suppressing delivery

Delivery Shows "Uncertain"​

The provider accepted the request but SailOps could not confirm final delivery. This does not mean the notification failed — check the destination directly.

Delivery Shows "Failed"​

  1. Check the webhook URL is correct and accessible
  2. Verify the provider is not rejecting the request
  3. Review the error message in the delivery details