How to Integrate SolarWinds NPM with PagerDuty
SolarWinds Network Performance Monitor (NPM) is a powerful network fault and availability management system that makes it easy to quickly detect, diagnose, and resolve performance issues before outages occur. SolarWinds NPM tracks response time, availability, uptime of routers and displays performance statistics in real time, and notifies users when something goes awry. PagerDuty and SolarWinds NPM work together to provide better incident alerting and easy-to-manage on-call schedules to SolarWinds’ network monitoring. PagerDuty alerts can be sent by a wide breadth of contact methods to ensure quick and reliable responses. This guide will walk you through the process of integrating SolarWinds NPM with PagerDuty. If you run into any issues with this integration, please contact our support.
- Login to your PagerDuty account, and select Services > Add New Service.
- Enter a service name, select an escalation policy, select Solarwinds NPM as the Service Type, then press Add Service.
In SolarWinds NPM:
- From your Solarwinds NPM server, login to your PagerDuty account. Go to the SolarWinds NPM service that you just created and download the Trigger Action and Reset Action files.
- Open the Advanced Alert Manager (Start > Programs > SolarWinds Orion > Alerting, Reporting, and Mapping > Advanced Alert Manager)
- Either select an existing alert or create a new alert. If configuring a new alert, set up the Alert Name, Trigger Condition and Reset Condition fields.
- Go to the Trigger Actions tab. Click on Import Actions.
- Select the Trigger.AlertActions file and click Open.
- Go to the Reset Actions tab. Click on Import Actions.
- Select the Reset.AlertActions file and click on Open.
- Click on OK to save your alert.
- If you would like to test your alert, select it from the list and click on the Test button.
- Select a node for the test, and then click on Test Alert Trigger.
It takes a moment for the test to initialize, but you will get an alert within PagerDuty.
- You can now run a test to clear the alert, so click on the Clear Alert Test button and then click on the Test Alert Reset button.
The incident within PagerDuty will now resolve.
Congratulations! You’ve now configured SolarWinds NPM to integrate with PagerDuty. Please contact firstname.lastname@example.org with any questions or issues.
How do I setup SolarWinds NPM to use multiple PagerDuty services?
In order to tie SolarWinds NPM to multiple PagerDuty services, you will repeat all of the steps of this guide. The only things that you will do differently are that you will create multiple services within PagerDuty, download the new actions and use those for your alert within SolarWinds NPM.
Can I customize the message that I receive from SolarWinds & PagerDuty?
Yes, you can customize the message that is sent to you. The AlertAction files that are generated for you are simply text configuration files. Below is a sample AlertAction file:
<AlertAction ActionType='GetURL' DOW='1,2,3,4,5,6,7' EndTime='11:59:59 PM' ExecuteIfAcknowledged='True' NetObjectType='' RepeatInterval='0' SortOrder='1' StartTime='12:00:00 AM' Target='https://events.pagerduty.com/generic/2010-04-15/create_event.json' TimeOffset='0' Title="Trigger PagerDuty 'SolarWinds' service" TriggerAction='False'>
<!-- Additional fields may be added to the 'details' dictionary. See: -->
<!-- http://www.solarwinds.com/NetPerfMon/SolarWinds/wwhelp/wwhimpl/js/html/wwhelp.htm#href=OrionAGBasicAlertEngineVariables.htm -->
The message that is sent to you in PagerDuty is the description field. You can modify this field to include other SolarWinds Macros. The full list of available macros can be found here.
If you would like to change how your incidents are de-duplicated, you can modify the incident_key as well.