Skip to main content

๐Ÿ’ฌ Slack

Use the interactive kwatch manager to configure Slack alerts. It stores credentials in Kubernetes Secrets and verifies the installation. The configuration fragments below explain provider settings; they are not separate installation steps.

If you want to enable Slack, provide either a webhook URL or a bot token with channel.

Webhook mode:

ParameterDescriptionRequired
alert.slack.webhookSlack webhook URLYes
alert.slack.channel๐Ÿ“ข Override channelNo
alert.slack.titleโœ๏ธ Custom titleNo
alert.slack.textโœ๏ธ Custom textNo
alert.slack.compact๐Ÿ“ Single-line modeNo

Bot Token mode:

ParameterDescriptionRequired
alert.slack.tokenSlack bot token (xoxb-...)Yes
alert.slack.channel๐Ÿ“ข Channel to post toYes
alert.slack.titleโœ๏ธ Custom titleNo
alert.slack.textโœ๏ธ Custom textNo
alert.slack.compact๐Ÿ“ Single-line modeNo

๐Ÿ’ก Pro tip: When using bot token mode, alerts become threaded conversations โ€” root message on first alert, updates as replies. Clean and organized! ๐Ÿงน

Compact modeโ€‹

alert:
slack:
webhook: "${file:/config/slack-webhook}"
compact: true

Routing & Retryโ€‹

alert:
slack:
webhook: "${file:/config/slack-webhook}"
routes:
- namespaces: ["production"]
severities: ["high", "critical"]
retry:
maxAttempts: 3
delay: 5s

Fallback providerโ€‹

alert:
slack:
webhook: "${file:/config/slack-webhook}"
fallback: "pagerduty"
retry:
maxAttempts: 3

Configuration example (Webhook)โ€‹

alert:
slack:
webhook: "${file:/config/slack-webhook}"
title: "optional customized title"
text: "optional customized text"

Configuration example (Bot Token)โ€‹

alert:
slack:
token: "${file:/config/slack-token}"
channel: "#alerts"
title: "optional customized title"
text: "optional customized text"

Screenshotโ€‹

Slack notification screenshot