Note: This project is no longer actively maintained by Pinterest.
The scripts in this repository are wrappers for the PagerDuty API which will open and close PagerDuty incidents from the command line. These scripts are designed to help you integrate monit with PagerDuty.
Copyright (c) 2012 Cold Brew Labs, Inc. See LICENSE for details.
Usage: pagerduty-trigger <service-name>
Example: pagerduty-trigger nginx on the server "webserver1.example.com"
will trigger a PagerDuty incident with the subject "nginx failed on
webserver1".
Prerequisites: Requires pagerduty library for Python. You can download this
from http://pypi.python.org/pypi/pagerduty/0.2.1, or run pip install pagerduty to download and install automatically.
To configure PagerDuty: To configure PagerDuty, login as an administrator
and go to the Services tab; then click "Add New Service". You can give the
service any name you'd like, and choose "Generic API system." PagerDuty will
give you an API service key for this service. Be sure to set the
PAGERDUTY_SERVICE_KEY variable in both scripts.
To configure Monit: To configure Monit to trigger an event with this script, save the script in a location like /etc/monit; make sure it's executable; and use an action like this in your monitrc file:
exec "/etc/monit/pagerduty-trigger <service-name>"
Example monit stanza to trigger an incident if nginx is not present:
check process nginx with pidfile /var/run/nginx.pid
if does not exist for 3 cycles
then exec "/etc/monit/pagerduty-trigger nginx"
else if passed for 3 cycles
then exec "/etc/monit/pagerduty-resolve nginx"