https://github.com/pinterest/pagerduty-monit

Wrapper scripts to integrate monit and PagerDuty.
https://github.com/pinterest/pagerduty-monit

archived monit pagerduty

Last synced: 3 months ago
JSON representation

Wrapper scripts to integrate monit and PagerDuty.

• Host: GitHub
• URL: https://github.com/pinterest/pagerduty-monit
• Owner: pinterest
• License: mit
• Archived: true
• Created: 2012-01-07T11:21:25.000Z (about 13 years ago)
• Default Branch: master
• Last Pushed: 2017-05-12T22:18:32.000Z (over 7 years ago)
• Last Synced: 2024-08-03T01:38:10.968Z (6 months ago)
• Topics: archived, monit, pagerduty
• Language: Shell
• Homepage:
• Size: 3.91 KB
• Stars: 60
• Watchers: 11
• Forks: 24
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-repositories - pinterest/pagerduty-monit - Wrapper scripts to integrate monit and PagerDuty. (Shell)

README

        
**Note:** This project is no longer actively maintained by Pinterest.

---

## pagerduty-monit

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 `

**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 "

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"