Docs

Setting up alert channels and alert conditions

Required role and plan

View
Viewer or higher
Add or delete channels, change conditions
Admin or higher
Send test
Developer or higher
Plan
All plans

Add an alert channel

  1. Open Alerts in the menu and select + Add channel.
  2. Under Send to, choose Slack, Teams, Chatwork, Email or Webhook.
  3. Enter the destination (Incoming Webhook URL, Workflows URL, “room ID:API token”, email address or destination URL). See How to get each URL or token in the dialog.
  4. Optionally enter a Display name, and under Applies to choose the whole organization or one project.
  5. Select Add, then select Send test in the list to check that alerts arrive.

Webhook alerts are signed (webhook-signature). Verify them with the Webhook signing secret shown on the page (visible to Admin or higher).

Developers and Viewers do not see + Add channel or Delete, and alert conditions are view-only for them (Developers can still use Send test).

Alert conditions

There is one set of conditions per organization, shared by all channels. Turn each condition on or off and choose its threshold.

ConditionWhen it alertsThresholds
Failed deliveriesAt the time you choose, and when retries run out. At most once an hour per endpointRight away, after 5 minutes, 15 minutes or 1 hour
Endpoint disabledAn endpoint was disabled after failing for 5 days—
Retry backlogAn environment has more messages waiting to retry than you choose (once a day)100, 1,000 or 10,000
Monthly usageThis month’s messages pass the share of your limit you choose50%, 80% or 100%
Polling endpoint not polledNo one has polled a polling endpoint for the time you choose1, 6, 24 or 72 hours

Delete an alert channel

  1. Select Delete on the channel.
  2. Select Delete in the confirmation dialog.