Knowledge base/Best practices

On-call rotation in Unimoni

Unimoni has no built-in on-call rotation (that is the job of PagerDuty/Opsgenie/Squadcast). We integrate as a channel — usually a single integration in PagerDuty is enough, with escalation handled on the PD side.

Setup

  1. PagerDuty service → Integrations → Events API v2 → copy the routing key
  2. In Unimoni /app/alerts/channels → New webhook channel:

- URL: https://events.pagerduty.com/v2/enqueue - No HMAC (PD does not verify our signature; it has its own dedup key)

  1. On the rule, set this channel in channel_routes for severity=critical
  2. Escalations (if the acknowledger does not respond within 5 minutes → a second on-call) are configured in PagerDuty

Do not forget

  • Maintenance windows on the Unimoni side — otherwise PD will call during a deploy
  • Acknowledgement back into Unimoni can be wired via a webhook from PD (resolved back)