Skip to content

Send alerts to your team

Every channel takes the same three steps:

  1. Connect the service on Connections (Owners and Admins).
  2. Add a channel on Notifications → New channel: the connection plus where exactly to send (a chat, a Slack channel, recipients).
  3. Route alerts to it on Notifications → Routes, then Save routes.

Below is step 1 and 2 for each service. Step 3 is at the end. Every field is in Connection types.

  1. Talk to @BotFather, create a bot, and copy its token.
  2. Add the bot to the group or channel that should get alerts.
  3. Find the chat id. Group ids start with -100; a public channel can be written @channelname.
  4. Connections → Telegram → Connect: a name, the Bot token, and optionally a Default chat id.
  5. New channel: choose the connection, name it, and set Chat id (empty: the connection’s default).

A wrong chat id, or a bot that isn’t in the chat, fails at once with Telegram’s reason, shown under Notifications on the alert.

Choose how to connect (Connect with):

  • Incoming webhook: one channel, nothing to install. In Slack, create an app with an incoming webhook for the channel and copy its URL (https://hooks.slack.com/…).
  • Bot: any channel the bot is invited to. Create a Slack app with the chat:write scope, install it, and copy the bot token (xoxb-…). Optionally set a Default channel.

Then New channel. With a bot connection, set Channel (#alerts or a channel id); invite the bot to that channel first, or delivery fails with “Invite the bot to …”.

  1. Connections → Email (SMTP): your SMTP server or provider (SES, SendGrid, Postmark, Microsoft 365): SMTP host, Port (587 with STARTTLS, or 465 with TLS from the start), username, password, and a From address such as SREInsights <alerts@example.com>.
  2. New channel: Recipients, comma-separated, such as oncall@example.com, sre@example.com.

Each notice is one email; all emails of one alert thread together.

An SNS topic passes alerts to its subscribers: email, SMS, a queue, a Lambda function.

  1. Create the topic in AWS and add subscribers.
  2. Connections → AWS SNS topic: the Topic ARN and its Region. There are no secrets: SREInsights publishes with its own AWS credentials.
  3. The instance’s role needs sns:Publish on the topic. On a serverless instance, list the topic in sns_topic_arns (AWS serverless). On the shared hosted product, ask the operator.
  4. New channel with the connection.

Subjects are plain ASCII of at most 100 characters, such as [high] checkout API: Check failing. A FIFO topic gets the alert as its message group, so one alert’s notices stay in order.

  1. In PagerDuty, add an Events API v2 integration to the service and copy its integration key.
  2. Connections → PagerDuty: the key, and the region (us or eu).
  3. New channel with the connection.

Each alert is one incident: a re-fire or escalation updates it, an acknowledgement acknowledges it, and a resolve resolves it.

  • Jira Cloud: one issue per alert, with comments when it fires again and an optional transition on resolve. The channel names the Project key.
  • Microsoft Teams, Discord, Google Chat: a webhook URL from the channel or space.
  • Webhook: your own endpoint receives each notice as JSON, signed with X-SREInsights-Signature when you set a signing secret.

On Notifications, under Routes:

  1. Add route.
  2. Severity: leave empty for all, or pick some, such as critical and high.
  3. Labels: leave empty, or match labels such as team=payments.
  4. Send to: your channel.
  5. Tick Keep matching routes below this one if later routes should also get the alert.
  6. Try an alert to check, then Save routes.

Routes are checked top to bottom, and the first match decides unless it keeps matching. An alert no route matches is recorded but notifies nobody. More in Channels and routes.

Make a monitor fail on purpose (point it at a page that doesn’t exist) and select Run now. The alert’s Notifications section shows what each channel was sent and whether it went through. Failed sends are retried for a while with back-off; bad credentials fail at once with the reason.