Notification Plugins

Configure notification channels to receive alerts from your clusters.

Notification channels live under Monitoring > Alerting, on the Notification Channels tab. The tab shows summary counters (Total Channels, Active, Inactive, Healthy) and an Add Channel button (or Create First Channel when no channels exist yet).

Creating a channel is a 4-step wizard:

Select Integration Type - choose one of the 7 integration types below
Configure Connection - set the common fields (Internal Name, Display Name, Description) plus the type-specific connection fields
Configure delivery options - such as alert filters (severity, cluster, namespace), where available
Review - confirm your settings and create the channel

After creating a channel, use Send Test from its actions menu to verify it.

Supported Integrations

Slack Integration

Send alerts to Slack channels using incoming webhooks.

Step 1: Select Integration Type

Click Create First Channel (or Add Channel if you already have channels), then select Slack from the available integrations.

Select Slack integration — Step 1: Select Slack as the integration type

Step 2: Configure Connection

Fill in the connection details for your Slack webhook.

Configure Slack connection — Step 2: Configure the Slack webhook connection

Field	Description	Example
Internal Name	Unique identifier (no spaces)	`prod-slack-alerts`
Display Name	Friendly name	`Production Slack Alerts`
Description	Channel description	`Sends critical alerts to...`
Webhook URL	Slack incoming webhook URL	`https://hooks.slack.com/services/...`
Channel	Target channel	`#alerts`
Username	Bot display name (optional)	`SRExpert Bot`

How to get Webhook URL: (Official Slack Documentation)

Go to Slack API Apps
Create new app or select existing
Enable Incoming Webhooks
Click Add New Webhook to Workspace
Select channel and authorize
Copy the webhook URL

Step 3: Set Filters

Configure which alerts should be sent to this channel.

Set alert filters — Step 3: Configure severity, cluster, and namespace filters

Filter	Description	Example
Severity Filters	Alert severities to include	`CRITICAL`, `HIGH`, `MEDIUM`, `LOW`, `INFO`
Cluster Filters	Specific clusters (comma-separated)	`prod-cluster-1, prod-cluster-2`
Namespace Filters	Specific namespaces (comma-separated)	`production, staging`

Leave filters empty to receive all alerts.

Step 4: Review & Delivery Options

Review your settings and, where available, configure delivery options such as rate limits and quiet periods to help prevent alert fatigue.

Review and delivery options — Step 4: Review your settings and configure delivery options where available

Depending on the integration, delivery options may include settings such as a maximum number of notifications per hour or quiet hours. Review the channel summary and confirm to create the channel.

Click Create Channel to finish the setup.

Microsoft Teams Integration

Send alerts to Microsoft Teams channels.

Step 1: Select Integration Type

Click Create First Channel (or Add Channel if you already have channels), then select Microsoft Teams from the available integrations.

Select Microsoft Teams integration — Step 1: Select Microsoft Teams as the integration type

Step 2: Configure Connection

Fill in the connection details for your Teams webhook.

Configure Teams connection — Step 2: Configure the Teams webhook connection

Field	Description	Example
Internal Name	Unique identifier	`prod-teams-alerts`
Display Name	Friendly name	`Production Teams Channel`
Description	Channel description	`Sends alerts to Teams`
Webhook URL	Teams incoming webhook URL	`https://outlook.office.com/webhook/...`

How to get Webhook URL: (Official Microsoft Teams Documentation)

Open Microsoft Teams
Go to the channel where you want alerts
Click … → Connectors
Find Incoming Webhook and click Configure
Name your webhook and click Create
Copy the webhook URL

Step 3: Set Filters

Configure which alerts should be sent to this channel.

Set alert filters — Step 3: Configure severity, cluster, and namespace filters

Filter	Description	Example
Severity Filters	Alert severities to include	`CRITICAL`, `HIGH`, `MEDIUM`, `LOW`, `INFO`
Cluster Filters	Specific clusters (comma-separated)	`prod-cluster-1, prod-cluster-2`
Namespace Filters	Specific namespaces (comma-separated)	`production, staging`

Leave filters empty to receive all alerts.

Step 4: Review & Delivery Options

Review your settings and, where available, configure delivery options such as rate limits and quiet periods to help prevent alert fatigue.

Review and delivery options — Step 4: Review your settings and configure delivery options where available

Depending on the integration, delivery options may include settings such as a maximum number of notifications per hour or quiet hours. Review the channel summary and confirm to create the channel.

Click Create Channel to finish the setup.

Discord Integration

Send alerts to Discord servers.

Step 1: Select Integration Type

Click Create First Channel (or Add Channel if you already have channels), then select Discord from the available integrations.

Select Discord integration — Step 1: Select Discord as the integration type

Step 2: Configure Connection

Fill in the connection details for your Discord webhook.

Configure Discord connection — Step 2: Configure the Discord webhook connection

Field	Description	Example
Internal Name	Unique identifier	`prod-discord-alerts`
Display Name	Friendly name	`Production Discord Alerts`
Description	Channel description	`Sends alerts to Discord`
Webhook URL	Discord webhook URL	`https://discord.com/api/webhooks/...`

How to get Webhook URL: (Official Discord Documentation)

Open Discord server settings
Go to Integrations → Webhooks
Click New Webhook
Select the channel
Copy the webhook URL

Step 3: Set Filters

Configure which alerts should be sent to this channel.

Set alert filters — Step 3: Configure severity, cluster, and namespace filters

Filter	Description	Example
Severity Filters	Alert severities to include	`CRITICAL`, `HIGH`, `MEDIUM`, `LOW`, `INFO`
Cluster Filters	Specific clusters (comma-separated)	`prod-cluster-1, prod-cluster-2`
Namespace Filters	Specific namespaces (comma-separated)	`production, staging`

Leave filters empty to receive all alerts.

Step 4: Review & Delivery Options

Review your settings and, where available, configure delivery options such as rate limits and quiet periods to help prevent alert fatigue.

Review and delivery options — Step 4: Review your settings and configure delivery options where available

Depending on the integration, delivery options may include settings such as a maximum number of notifications per hour or quiet hours. Review the channel summary and confirm to create the channel.

Click Create Channel to finish the setup.

Telegram Integration

Send alerts via Telegram bot.

Step 1: Select Integration Type

Click Create First Channel (or Add Channel if you already have channels), then select Telegram from the available integrations.

Select Telegram integration — Step 1: Select Telegram as the integration type

Step 2: Configure Connection

Fill in the connection details for your Telegram bot.

Configure Telegram connection — Step 2: Configure the Telegram bot connection

Field	Description	Example
Internal Name	Unique identifier	`prod-telegram-alerts`
Display Name	Friendly name	`Production Telegram Alerts`
Description	Channel description	`Sends alerts via Telegram`
Bot Token	Telegram bot API token	`123456:ABC-DEF...`
Chat ID	Target chat/group ID	`-1001234567890`

How to set up: (Official Telegram Bot Documentation)

Message @BotFather on Telegram
Create new bot with /newbot
Copy the bot token
Add bot to your group/channel
Get chat ID using @userinfobot

Step 3: Set Filters

Configure which alerts should be sent to this channel.

Set alert filters — Step 3: Configure severity, cluster, and namespace filters

Filter	Description	Example
Severity Filters	Alert severities to include	`CRITICAL`, `HIGH`, `MEDIUM`, `LOW`, `INFO`
Cluster Filters	Specific clusters (comma-separated)	`prod-cluster-1, prod-cluster-2`
Namespace Filters	Specific namespaces (comma-separated)	`production, staging`

Leave filters empty to receive all alerts.

Step 4: Review & Delivery Options

Review your settings and, where available, configure delivery options such as rate limits and quiet periods to help prevent alert fatigue.

Review and delivery options — Step 4: Review your settings and configure delivery options where available

Depending on the integration, delivery options may include settings such as a maximum number of notifications per hour or quiet hours. Review the channel summary and confirm to create the channel.

Click Create Channel to finish the setup.

PagerDuty Integration

Create PagerDuty incidents automatically from alerts.

Step 1: Select Integration Type

Click Create First Channel (or Add Channel if you already have channels), then select PagerDuty from the available integrations.

Select PagerDuty integration — Step 1: Select PagerDuty as the integration type

Step 2: Configure Connection

Fill in the connection details for your PagerDuty integration.

Configure PagerDuty connection — Step 2: Configure the PagerDuty integration

Field	Description	Example
Internal Name	Unique identifier	`prod-pagerduty`
Display Name	Friendly name	`Production PagerDuty`
Description	Channel description	`Creates PagerDuty incidents`
Integration Key	PagerDuty Events API key	`abc123def456...`
Severity	Default severity level	`critical`, `error`, `warning`, `info`

How to get Integration Key: (Official PagerDuty Documentation)

Log in to PagerDuty
Go to Services → Select your service
Go to Integrations tab
Click Add Integration
Select Events API v2
Copy the Integration Key

Step 3: Set Filters

Configure which alerts should be sent to PagerDuty.

Set alert filters — Step 3: Configure severity, cluster, and namespace filters

Filter	Description	Example
Severity Filters	Alert severities to include	`CRITICAL`, `HIGH`, `MEDIUM`, `LOW`, `INFO`
Cluster Filters	Specific clusters (comma-separated)	`prod-cluster-1, prod-cluster-2`
Namespace Filters	Specific namespaces (comma-separated)	`production, staging`

Leave filters empty to receive all alerts.

Step 4: Review & Delivery Options

Review your settings and, where available, configure delivery options such as rate limits and quiet periods to help prevent alert fatigue.

Review and delivery options — Step 4: Review your settings and configure delivery options where available

Depending on the integration, delivery options may include settings such as a maximum number of notifications per hour or quiet hours. Review the channel summary and confirm to create the channel.

Click Create Channel to finish the setup.

Webhook Integration

Send alerts to any HTTP endpoint.

Step 1: Select Integration Type

Click Create First Channel (or Add Channel if you already have channels), then select Webhook from the available integrations.

Select Webhook integration — Step 1: Select Webhook as the integration type

Step 2: Configure Connection

Fill in the connection details for your webhook endpoint.

Configure Webhook connection — Step 2: Configure the Webhook endpoint

Field	Description	Example
Internal Name	Unique identifier	`custom-webhook`
Display Name	Friendly name	`Custom Alert Webhook`
Description	Channel description	`Sends alerts to custom endpoint`
URL	Webhook endpoint (receives POST requests)	`https://api.example.com/alerts`
Headers	Custom headers (optional)	`Authorization: Bearer ...`

Payload format:

{
  "alert_id": "uuid",
  "rule_name": "high-cpu-usage",
  "severity": "high",
  "status": "firing",
  "cluster_name": "production",
  "namespace": "default",
  "current_value": 85.5,
  "threshold_value": 80,
  "message": "CPU usage is at 85.5%",
  "fired_at": "2024-01-15T10:30:00Z"
}

The exact payload fields may evolve over time. Build integrations defensively and avoid assuming a fixed set of keys.

Step 3: Set Filters

Configure which alerts should be sent to this webhook.

Set alert filters — Step 3: Configure severity, cluster, and namespace filters

Filter	Description	Example
Severity Filters	Alert severities to include	`CRITICAL`, `HIGH`, `MEDIUM`, `LOW`, `INFO`
Cluster Filters	Specific clusters (comma-separated)	`prod-cluster-1, prod-cluster-2`
Namespace Filters	Specific namespaces (comma-separated)	`production, staging`

Leave filters empty to receive all alerts.

Step 4: Review & Delivery Options

Review your settings and, where available, configure delivery options such as rate limits and quiet periods to help prevent alert fatigue.

Review and delivery options — Step 4: Review your settings and configure delivery options where available

Depending on the integration, delivery options may include settings such as a maximum number of notifications per hour or quiet hours. Review the channel summary and confirm to create the channel.

Click Create Channel to finish the setup.

Email Integration

Send alerts via email.

Step 1: Select Integration Type

Click Create First Channel (or Add Channel if you already have channels), then select Email from the available integrations.

Select Email integration — Step 1: Select Email as the integration type

Step 2: Configure Connection

Fill in the email configuration details.

Configure Email settings — Step 2: Configure the Email settings

Email channels use per-channel SMTP settings, so you provide the SMTP server to send through along with the from/to addresses.

Field	Description	Example
Internal Name	Unique identifier (no spaces)	`prod-email-alerts`
Display Name	Friendly name	`Production Email Alerts`
Description	Channel description	`Sends alerts via email`
SMTP Server	Mail server host	`smtp.example.com`
SMTP Port	Mail server port	`587` (TLS) or `465` (SSL)
From Email	Sender address	`[email protected]`
To Email	Recipient address	`[email protected]`
Username	SMTP username (optional)	`[email protected]`
Password	SMTP password (optional)	`••••••••`

Email format:

Subject includes the alert name and affected cluster
Body includes alert details, severity, and direct links to SRExpert

Step 3: Set Filters

Configure which alerts should be sent via email.

Set alert filters — Step 3: Configure severity, cluster, and namespace filters

Filter	Description	Example
Severity Filters	Alert severities to include	`CRITICAL`, `HIGH`, `MEDIUM`, `LOW`, `INFO`
Cluster Filters	Specific clusters (comma-separated)	`prod-cluster-1, prod-cluster-2`
Namespace Filters	Specific namespaces (comma-separated)	`production, staging`

Leave filters empty to receive all alerts.

Step 4: Review & Delivery Options

Review your settings and, where available, configure delivery options such as rate limits and quiet periods to help prevent alert fatigue.

Review and delivery options — Step 4: Review your settings and configure delivery options where available

Depending on the integration, delivery options may include settings such as a maximum number of notifications per hour or quiet hours. Review the channel summary and confirm to create the channel.

Click Create Channel to finish the setup.

Testing Your Integration

After configuring a notification channel:

Find your channel in the list and click the … menu (Actions)
Click Send Test to verify the configuration
A test alert will be sent to your channel
Check for the test message in your notification platform

Test notification channel — Click the actions menu and select 'Send Test' to verify your integration

Overview Overview