Rotadeck Docs

Appearance

Integrations ​

Integrations are the core of Rotadeck, allowing you to connect external monitoring tools and services to receive alerts.

What are Integrations? ​

Integrations serve as the entry point for alerts into Rotadeck. When you create an integration, you receive a unique webhook URL that external services can send alerts to.

Creating an Integration ​

  1. Navigate to the Integrations page from the sidebar
  2. Click the Add Integration button
  3. Fill in the integration details:
    • Title: A descriptive name for your integration (e.g., "Production API Monitoring")
    • Description: Optional details about what this integration monitors
    • Type: Select the integration type (Generic, CloudWatch, etc.)
  4. Click Save

After creation, you'll receive a unique webhook URL that looks like:

https://api.rotadeck.com/api/v1/integration/{integration_key}/event

Integration Types ​

Generic Integration ​

The most flexible integration type that accepts custom JSON payloads. Perfect for custom monitoring tools or scripts.

CloudWatch Integration ​

Specifically designed to receive alerts from AWS CloudWatch. Automatically parses CloudWatch alarm formats.

Viewing Integration Details ​

Click on any integration from the list to view:

  • Integration Type: The type of integration this is
  • Integration URL: Copy this to configure in your external service
  • Attached Schedules: Schedules that will receive alerts from this integration

Best Practices ​

  • Use descriptive names: Clearly identify what each integration monitors
  • Attach multiple schedules: Ensure redundancy by routing critical alerts to multiple teams
  • Test before production: Always send a test alert before relying on an integration
  • Monitor integration health: Check the integration details page regularly for any issues

Deleting an Integration ​

⚠️ Warning: Deleting an integration will stop all alerts from that source.

  1. In the integration list, tick the box next to the integration
  2. Click the Delete button in the action bar at the bottom of the screen
  3. Confirm the deletion

The integration URL will be immediately invalidated.