Alert Rules
Configure when and how your team gets notified about endpoint failures.
An alert rule connects an endpoint to a notification channel. When the endpoint fails enough consecutive checks to meet the failure threshold, OpsKitty fires the alert and sends a notification. When the endpoint recovers and meets the success threshold, the alert resolves — and optionally sends a recovery notification.
Creating an alert
- 1
Go to Dashboard → Endpoints, open an endpoint, and scroll to the Alerts section.
- 2
Click Add Alert and choose a notification type (email, Slack, Discord, PagerDuty, etc.).
- 3
Fill in the provider config (e.g., email address or webhook URL), set the thresholds, and save.
Alert fields
- Type — the notification provider (email, Slack, Discord, PagerDuty, Teams, Telegram, webhook, Twilio, OpsGenie).
- Failure threshold — number of consecutive failures required to fire. Default: 3.
- Success threshold — number of consecutive successes required to resolve. Default: 1.
- Notify on resolved — send a follow-up notification when the alert resolves. Recommended.
- Description — an optional note added to notifications (e.g., runbook link or on-call instructions).
- Enabled — toggle to temporarily disable an alert without deleting it.
Alert states
- Active — the endpoint is passing checks; no alert is currently firing.
- Triggered — the failure threshold was met; a notification was sent.
- Disabled — the alert rule exists but notifications are suppressed.
Recent events
The Dashboard → Alerts → Recent Events tab shows a history of every alert that fired or resolved, along with the delivery status (sent, failed, or pending). Use this to diagnose missed notifications or confirm that alerts are being delivered correctly.