Pager Duty
| Schemes | pagerduty:// |
| Cargo feature | service-pagerduty |
| Service | https://pagerduty.com/ |
| Body formats | text (first is the default) |
| Attachments | no |
| Title length | no title (merged into the body) |
| Body length | 32,768 characters |
| Body lines | unlimited |
| Request throttle | none |
| Vendor URLs accepted | no |
URL formats
{schema}://{integrationkey}@{apikey}
{schema}://{integrationkey}@{apikey}/{source}
{schema}://{integrationkey}@{apikey}/{source}/{component}
{schema} is one of pagerduty://.
URL tokens
| Token | Meaning | Type | Required | Default | Notes |
|---|---|---|---|---|---|
{apikey} | API Key | string | yes | secret | |
{component} | Component | string | no | Notification | |
{integrationkey} | Integration Key | string | yes | secret | |
{source} | Source | string | no | defaults to the app id |
Query parameters
| Parameter | Meaning | Type | Default | Notes |
|---|---|---|---|---|
class | Class | string | ||
click | Click | string | ||
group | Group | string | ||
image | Include Image | bool | yes | |
region | Region Name | choice | us | one of us, eu |
severity | Severity | choice | one of info, warning, critical, error |
Prefixed parameters:
+name=value: Custom Details
The common URL parameters (format, overflow, verify, redirect, cto, rto, retry, wait, store, tag, tz, user, password, port, optional, emojis) apply as well.
Examples
Accepted URLs (tokens are fake):
pagerduty://myroutekey@myapikey
pagerduty://myroutekey@myapikey/mysource/mycomponent
pagerduty://myroutekey@myapikey?image=no
pagerduty://myroutekey@myapikey?region=EU
pagerduty://myroutekey@myapikey?severity=critical
pagerduty://myroutekey@myapikey?+key=value&+key2=value%2520two
pagerduty://?integrationkey=r&apikey=a&source=s&component=c
pagerduty://routekey@apikey/ms/mc?group=mygroup&class=myclass&click=http%3A%2F%2Fexample.com
Rejected URLs:
pagerduty://
pagerduty://%20@%20/
pagerduty://%20/
pagerduty://%20@abcd/
Send one from the command line:
mercurio -t 'Backup' -b 'Finished in 42s' 'pagerduty://myroutekey@myapikey'
Notes
PagerDuty (pagerduty://): events through the PagerDuty Events API.