Automatically trigger incidents in PagerDuty when Cloudmon alarms fire, and optionally resolve them when the alarm clears.
The PagerDuty integration allows Cloudmon to trigger incidents in a PagerDuty service when an alarm fires. If automatic resolution is enabled, Cloudmon also resolves the incident when the alarm clears, so on-call responders are paged for active alarms and the incident closes when the alarm does.
Collect the following details in PagerDuty before you configure the integration in Cloudmon.
| Field | Description |
| Integration Key | Created by adding an Events API v2 integration to a PagerDuty service. See Services and Integrations. |
| Escalation Policy | Set on the service. It controls who is paged when this integration triggers an incident. See Escalation Policies and Schedules. |
The Integration Key is stored encrypted and is never shown again after saving. Test Connection sends a test event to PagerDuty and immediately resolves it, so verifying the key may briefly show a "Cloudmon test connection" entry in the service's activity timeline. This is safe to ignore.
PagerDuty Service
| Field | Description |
| Integration Name | A display name to identify this integration in Cloudmon, such as "On Call Escalation". |
| PagerDuty URL | Optional. Your PagerDuty URL, for example acme.pagerduty.com. |
| Integration Key | The Events API v2 Integration Key copied from the PagerDuty service. |
| Sender Name | The sender name used for incidents from Cloudmon. The default is Cloudmon. |
Incident Settings
| Field | Description |
| Incident Summary | The text used as the incident summary. The default is $device_name is $severity - $title. Type $ to pick a replaceable tag from the list, and use the reset icon beside the field to restore the default. |
| Trigger Incidents For Severities | Select the alarm severities that trigger an incident: Down, Critical, Trouble and Attention. At least one must be selected. |
| Resolve Incident Automatically When Alarm Clears | Enabled by default. When enabled, Cloudmon resolves the incident when the alarm clears. When disabled, the incident must be resolved manually. |
| Incident Tags | Optional. Type a tag and press Enter to add it. Add as many as you need. |
The Reset button restores the form to its default values, and Close exits without saving.
When this alarm fires, Cloudmon creates an incident in PagerDuty automatically, for the severities selected in the integration.