PagerDutySays catches a PagerDuty webhook (triggered incident) and sends the event description to a Text To Speech Program.
- Mac OS 10.8.5, 10.9
- PHP 5.3+ (comes with mac osx)
- say (Speech Synthesis Manager - comes with mac osx)
- Apache 2.x (optional)
- PagerDuty Account with appropriate privledges
- setup your webserver and ensure you can receive requests: http://brianflove.com/2013/10/23/os-x-mavericks-and-apache/
- clone
[email protected]:avatarnewyork/pagerdutysays.gitinto your webroot - make sure pagerdutysays directory has proper permissions (you can verify this by making a request to index.php. If successful, you should see a
200status in your access log - Login to PagerDuty
- Goto Services and click on the service you wish to be notified on
- Click
Add a webhookbutton - Type in the name 'pagerdutysays' and enter the URL or IP of your webserver followed by
/pagerdutysays/index.php. (for example: http://mymac.mydomain.com/pagerdutysays/index.php) - Bump up the volume!
There is NO built-in security. This script is highly insecure as it executes the say program on your Mac, please treat it as such. It's highly recommended you ensure you have setup proper restrictions and firewall settings on your server. Ensure only pagerduty has access to this URL after you have verified it works.
If you wish to contribute to this project, please be sure to checkout the development branch. We will only accept pull requests made in this branch.
- GitHub Projet: https://github.com/avatarnewyork/pagerdutysays
- PagerDuty Webhook API: http://developer.pagerduty.com/documentation/rest/webhooks
- Setup Apache / PHP on OSX Mavericks: http://brianflove.com/2013/10/23/os-x-mavericks-and-apache/
- Runscope for testing webhooks: https://www.runscope.com/
- Avatar New York Workshop: http://workshop.avatarnewyork.com