Turn any signal into insight and action. See how PagerDuty Digital Operations Management Platform integrates machine data and human intelligence to improve visibility and agility across organizations.
Learn how PagerDuty can accelerate your cloud migration.
Check out the latest features we’ve been working on—including event intelligence, machine learning, response automation, on-call, analytics, operations health management, integrations, and more.
Digital Operations Management arms organizations with the insights needed to turn data into opportunity across every operational use case, from DevOps, ITOps, Security, Support, and beyond.
Over 200 Integrations
Discover DevOps best practices with our library of webinars, whitepapers, reports, and much more.
Learn best practices and get support help with resources from our award-winning support team.
See how PagerDuty works with our live product demo — twice a week, every week.
Join live and on-demand webinars for product deep dives, industry trends, configuration training, and use case-specific best practices.
Interactive, simple-to-use API and technical documentation enables users to easily try updates and extend PagerDuty.
Engage with users and PagerDuty experts from our global community of 200k+ users. Become a member, connect, and share insights for success.
Get all your PagerDuty-related questions answered by exploring our in-depth support documentation and community forums.
Hi! My name is Richard and I am a software engineering intern on the Platform Team here at PagerDuty. In other times of the year...
PagerDuty helps organizations transform their digital operations. Learn more about PagerDuty's mission and what we do.
Meet our experienced and passionate executive team.
We are risk-taking innovators dedicated to delivering amazing products and delighting customers. Join us and do the best work of your career.
With the PagerDuty Foundation, we are committed to doing our part in giving back to the community.
Sensu is an open source monitoring framework for servers, services, application health, and business KPIs. Sensu was designed from the ground up to monitor systems in the cloud, such as AWS EC2 instances, and to discover systems rather than have them specified in your configuration beforehand.
This guide will walk you through the process of integrating Sensu Core with PagerDuty. If you have any trouble completing the integration please contact us.
Note: The steps in this guide are for Sensu Core, the free version of Sensu. The Enterprise version features a built-in PagerDuty integration which is officially supported by Heavy Water, so we recommend following the steps in our
Sensu Enterprise Integration Guide if you are using Sensu Enterprise.
At this time, CentOS 5 is not supported by the Sensu Core integration.
From the Configuration menu, select Services.
On your Services page:
If you are creating a new service for your integration, click +Add New Service.
If you are adding your integration to an existing service, click the name of the service you want to add the integration to. Then click the Integrations tab and click the +New Integration button.
Select Sensu from the Integration Type menu and enter an Integration Name.
If you are creating a new service for your integration, in General Settings, enter a Name for your new service. Then, in Incident Settings, specify the Escalation Policy, Notification Urgency, and Incident Behavior for your new service.
Click the Add Service or Add Integration button to save your new integration. You will be redirected to the Integrations page for your service.
Copy the Integration Key for your new integration:
This guide was written and tested on Ubuntu 16.04 and Amazon Linux 2016.09, with Sensu 0.20.2-1 and 0.26.5-2. Paths may be different for other operating systems or Sensu versions. Note that all commands provided are intended to be run as the root user.
Install the PagerDuty Agent. The agent receives events from Sensu and sends them to PagerDuty using a queue, provides logging that helps troubleshoot any problems, and automatically retries sending alerts in the event of any connection failure (i.e. if your Sensu node temporarily loses connectivity).
Save the PagerDuty handler configuration to your Sensu installation’s conf.d directory:
wget -O /etc/sensu/conf.d/pagerduty_handler.json https://raw.githubusercontent.com/PagerDuty/pdagent-integrations/master/conf.d/sensu_pagerduty_handler.json
Modify the configuration file to have your integration key obtained in step 5 of the above section:
"command": "/usr/share/pdagent-integrations/bin/pd-sensu -k YOUR-INTEGRATION-KEY-HERE"
If you want to make PagerDuty a default handler, meaning any check without a specific handler defined will notify PagerDuty when there is an alert, open the default handler configuration file and add pagerduty to the set of handlers:
If you do not want PagerDuty to be a default handler, meaning you only want alerts from specifically defined checks to be sent to PagerDuty, open the configuration file for each check you want to send alerts to PagerDuty and add pagerduty to the check’s handlers:
"handlers": ["default", "pagerduty"]
Restart Sensu for your configuration changes to take effect: service sensu-server restart; service sensu-client restart
service sensu-server restart; service sensu-client restart
Create a standard check that monitors the cron service as outlined in the Sensu guide, Getting Started with Checks. Your check will look like this if you made PagerDuty a default handler as outlined in step 2 above:
"command": "/etc/sensu/plugins/check-process.rb -p cron",
If you did not make PagerDuty a default handler, you’ll need to specify pagerduty as a in handlers like this:
"handlers": ["default", "pagerduty"]
Restart Sensu for your configuration changes to take effect: service sensu-server restart
service sensu-server restart
Confirm that Sensu is working, the cron check you’ve created is OK, and there are no other alerts that have been triggered. Your Dashboard should look like this:
Stop the cron service: service cron stop
service cron stop
Within 60 seconds you should see an alert in Sensu and a new incident triggered in PagerDuty:
Yes. You can do this by creating multiple handlers, as follows:
Choose new names for each handler, i.e. pagerduty1, pagerduty2 etc.
Make differently-named copies of the file pagerduty1_handler.json, pagerduty2_handler.json, etc.
In each file:
Change "pagerduty" to the new distinct name
Change the integration key to the distinct integration key of the service the handler will be used for in PagerDuty.
Specify, for various different checks, the distinct PagerDuty handler to use, by its name, i.e.:
"handlers": ["default", "pagerduty1"]
600 Townsend St., #200
San Francisco, CA 94103
260 Queen St W #300,
Toronto, ON M5V 1Z8, Canada
1416 NW 46th St., St. 301
Seattle, WA 98107
5 Martin Place
1 Fore St,
London EC2Y 9DT
© 2009 - 2018