PagerDuty Integration

PagerDuty is the reference for incident and on-call management. By connecting MoniTao to PagerDuty, you get the best of both worlds: MoniTao's precise and reliable monitoring, and the power of PagerDuty's incident management platform.

This integration automatically routes MoniTao alerts to your PagerDuty escalation policies. Your on-call team receives notifications via their preferred channels, and PagerDuty's incident management workflow takes over.

Whether you use PagerDuty to orchestrate on-call for a small team or to coordinate hundreds of engineers, this integration adapts to your existing configuration without disruption.

What is PagerDuty?

PagerDuty is an incident management platform that offers:

• On-call management: On-call schedules with automatic rotations. Define who's on-call when, with absence and replacement management.
• Multi-level escalation: If the on-call person doesn't respond within the allotted time, the incident automatically escalates to the next level.
• Multi-channel: Notifications via mobile push, SMS, phone call, email, Slack. Each user configures their preferences.
• Incident timeline: Complete history of each incident: trigger, acknowledgment, resolution, notes, and MTTR metrics.

Integration Benefits

Connecting MoniTao to PagerDuty brings several benefits:

• Centralization: All your alerts (MoniTao and other tools) arrive in a single interface. Unified view of incidents.
• Reliable notifications: PagerDuty guarantees delivery. If push fails, it moves to SMS, then call. Someone will always be notified.
• Schedule compliance: Alert automatically reaches the current on-call person, without manual configuration in MoniTao.
• Team metrics: Response time, resolution time, on-call load per person. Data to optimize your processes.
• Bidirectional integration: Acknowledgments in PagerDuty are synchronized with MoniTao. Incident state is consistent everywhere.

Integration Configuration

Follow these steps to connect MoniTao to PagerDuty:

1. Create a PagerDuty service: In PagerDuty, create a new service dedicated to MoniTao alerts, or use an existing service.
2. Add an Events API integration: In the service integrations, add "Events API v2". Copy the generated Routing Key.
3. Configure in MoniTao: In MoniTao > Alerts > Webhooks, add a new PagerDuty destination and paste the Routing Key.
4. Map severities: Configure how MoniTao alert levels correspond to PagerDuty severities (critical, error, warning, info).
5. Test the integration: Use the "Send test" button in MoniTao to verify that the alert arrives properly in PagerDuty.

Payload Format

MoniTao sends alerts in PagerDuty Events API v2 format:

{
  "routing_key": "your-routing-key",
  "event_action": "trigger",
  "dedup_key": "monitao-monitor-123-incident-456",
  "payload": {
    "summary": "[DOWN] example.com - HTTP 503",
    "severity": "critical",
    "source": "MoniTao",
    "custom_details": {
      "monitor_name": "Production Website",
      "url": "https://example.com",
      "status_code": 503,
      "response_time_ms": 12500,
      "check_location": "Paris, France",
      "incident_url": "https://app.monitao.com/incident/456"
    }
  }
}

The dedup_key ensures duplicate alerts are grouped. When the monitor comes back UP, MoniTao automatically sends a "resolve" event to close the incident.

Escalation Policies

Configure your escalations in PagerDuty for MoniTao alerts:

• Level 1 - On-call team: The on-call person receives the alert immediately via their preferred channel (push, SMS).
• Level 2 - Backup after 5 minutes: If no acknowledgment, the incident escalates to a second engineer or team manager.
• Level 3 - Extended team after 15 minutes: For unresolved critical incidents, the entire team is notified simultaneously.
• Level 4 - Management after 30 minutes: If the incident persists, technical management is alerted for coordination and communication.

Best Practices

Optimize your MoniTao-PagerDuty integration:

• Separate services by criticality: Create different PagerDuty services for production vs staging, or critical vs informative. Different escalation policies.
• Enrich context: MoniTao's custom_details appear in PagerDuty. More context = faster diagnosis.
• Use Event Rules: PagerDuty event rules can route MoniTao alerts to different services based on content.
• Configure maintenance windows: Synchronize MoniTao maintenance windows with PagerDuty to avoid alerts during deployments.

Frequently Asked Questions

Conclusion

The MoniTao-PagerDuty integration combines precise monitoring with professional incident management. Your alerts are automatically routed to the right person, at the right time, via the right channel.

Configure the integration in minutes and immediately benefit from PagerDuty's power for your MoniTao alerts. Your on-call team will thank you.

Ready to Sleep Soundly?

Start free, no credit card required.

Create My Account See pricing