Notifications
Kuvasz supports a variety of integrations to help you stay informed about the status of your monitors. If you're curious about the configuration options, just click on the icon, next to the integration name, and it will take you to the relevant section of the configuration documentation.
Info
Integrations can be:
- global, meaning that they can be used for all monitors by default, or
- assigned to specific monitors.
You can also configure multiple integrations of the same type, for example, multiple Slack channels, or multiple email addresses to notify.
Watched events
Every integration watches a set of events by default, which are fired by the monitors. These events are currently the following:
Uptime events
| Event | Description |
|---|---|
HTTP_UP PUSH_UP |
Fired, when a monitor is healthy now (and it was unhealthy before) |
HTTP_DOWN PUSH_DOWN |
Fired, when a monitors is unhealthy |
SSL events
| Event | Description |
|---|---|
SSL_VALID |
Fired, when an SSL certificate is valid now (and it was SSL_INVALID or SSL_WILL_EXPIRE before) |
SSL_INVALID |
Fired, when an SSL certificate is invalid or expired now |
SSL_WILL_EXPIRE |
Fired, when an SSL certificate will expire in the next X days (X is configurable per monitor) |
Excluding certain events
You can exclude certain events from triggering notifications on a per-integration basis. This allows you to, for example, only receive notifications about downtime, but not about SSL certificate issues.
Slack
You can set up Slack as a notification channel for your monitors. This allows you to receive notifications about the status of your monitors directly in your Slack channels.
Discord
The Discord integration allows you to send notifications to Discord channels. This allows you to receive notifications about the status of your monitors directly in your Discord channels.
The email integration lets you to configure an SMTP connection, with which Kuvasz can send you simple email notifications about the status of your monitors.
PagerDuty
The PagerDuty integration allows you to trigger incidents in PagerDuty when a monitor goes down or an SSL certificate is invalid or will expire soon. This way, you can ensure that your team is notified immediately about critical issues. Incidents will be automatically resolved when the monitor is back up or the SSL certificate is valid again.
Telegram
The Telegram integration allows you to send notifications to a specific Telegram chat via the Bot API. You can use it to receive notifications about the status of your monitors directly in your Telegram app.
Webhooks
The Webhook integration allows you to send notifications to any HTTP endpoint. This is a very flexible integration, as it allows you to integrate with any service that supports incoming webhooks, or even with your own custom backend.
Since you can configure which events the webhook should watch, and also the payload via custom templates, you can use this integration to build your own custom notifications or to integrate with services that are not supported out of the box.
Do you miss an integration?
If you miss an integration, please open an issue, or consider contributing it yourself! We are always open to new integrations and would love to see your contribution.