Rotadeck Docs

Appearance

Alerts ​

Alerts are notifications sent to your team when something requires attention. They flow through integrations and are dispatched to on-call team members.

Alert Lifecycle ​

  1. Created: Alert is received through an integration
  2. Open: Alert is sent to on-call contacts
  3. Acknowledged: A team member has seen the alert
  4. Closed: The underlying issue has been fixed

Viewing Alerts ​

Navigate to the Alerts page to see all alerts for your account.

Alert List View ​

The alerts list shows:

  • Title: Summary of the issue
  • Description: Info about the issue
  • Status: Current state
  • Created At: When the alert was received

Alert Details ​

Click on any alert to view full details:

  • Description: Complete information about the issue
  • Alert Actions: Acknowledge or Close the alert
  • Open Source Integration: View the source of the alert

Alert Deduplication ​

Rotadeck automatically deduplicates alerts using a deduplication key. If the same alert is sent multiple times, it will:

  1. Update the existing alert instead of creating duplicates
  2. Reset notification timers if configured
  3. Maintain the alert history

Deduplication Key ​

The deduplication key is automatically generated when each alert is created.

Acknowledging Alerts ​

To acknowledge an alert:

  1. Open the alert details
  2. Click Acknowledge

This signals to your team that someone is working on the issue.

Resolving Alerts ​

To mark an alert as resolved:

  1. Open the alert details
  2. Click Resolve

Resolved alerts remain in history for auditing and analysis.

Alert Notifications ​

Alerts are automatically sent to:

  • All on-call users in attached schedules
  • Through their enabled contact methods (email, SMS, Slack)

Notification Timing ​

  • Immediate: Alerts are sent as soon as they're received

Best Practices ​

  • Acknowledge promptly: Let your team know you're on it
  • Add context: Use notes to document your investigation
  • Resolve completely: Don't resolve until the root cause is fixed
  • Review history: Learn from past incidents to improve monitoring

Alert API ​

You can also manage alerts programmatically. See the API documentation for details on:

  • Creating alerts via webhook
  • Updating alert status