SolarWinds Integration Guide

SolarWinds Integration

SolarWinds gives you the tools to monitor your applications and environment through a single web console.

How SolarWinds users benefit from PagerTree

SolarWinds triggers user defined alerts when (configured) network events occur. PagerTree acts as the dispatcher for these alerts, determining the right people to notify based on on-call schedules. PagerTree notifies them via email, sms, voice, and/or push notifications until the incident is acknowledged or closed.

Functionality of Integration

The SolarWinds integration is one-way, meaning:

  • When an alert in SolarWinds is triggered, an incident is created in PagerTree automatically.
  • When an alert in SolarWinds is reset, the incident is resolved in PagerTree automatically.

Tutorial Overview

In this integration tutorial we will show you how to send alerts from SolarWinds into PagerTree. The estimated time for this integration is 10 minutes. We assume that you already have a PagerTree account and SolarWinds installation setup.

In PagerTree

  1. From the navigation menu, click the “+ Integration” button. Click Plus Integration Button
  2. In the “Create Integration” box, fill out the following:
    1. Name of the Integration,
    2. Select the Integration Type to SolarWinds
    3. Select an appropriate urgency for when this integration is triggered
    4. Select the team this incident will be assigned to Click Create
  3. Click “Create”
  4. Copy the Endpoint URL Copy Endpoint URL

In SolarWinds

  1. Navigate to Alerts & Activity -> Alerts.
  2. In the upper right hand corner, click the Manage Alerts button to go to the Alert Manager. Click Manage Alerts
  3. In Alert Manager click Add New Alert Click Add New Alert Button
  4. In the Add New Alert Wizard
    1. Properties
      1. Name of the alert definition - An appropriate name (e.g. High CPU)
      2. Choose the severity of the alert. (PagerTree automatically maps the SolarWinds severity to the PagerTree urgency)
      3. Click Next Alert Properties
    2. Trigger Condition
      1. Select conditions that will trigger an alert (create an incident)
      2. Click Next Trigger Condition
    3. Reset Condition
      1. Select conditions that will reset and alert (resolve and incident)
      2. Click Next Reset Condition
    4. Time of Day
      1. Select time of day conditions (if only applicable during certain times)
      2. Click Next Time of Day Condition
    5. Trigger Action
      1. Message - Create an appropriate message (this will be displayed in the title of the incident created in PagerTree)
      2. Trigger Actions
        1. Click Add Action
        2. Select the Send a GET or POST Request to a Web Server option, then click Configure Action. Select GET or POST Request
          1. Name of action - An appropriate name (e.g. PagerTree Trigger Action)
          2. Under HTTP request settings:
            1. Paste the PagerTree Endpoint URL you copied for the URL
            2. Select Use HTTP/S POST
            3. Body to POST - paste the following:
               ActionType=Create&NodeName=${NodeName}&AlertID=${N=Alerting;M=AlertID}&AlertMessage=${N=Alerting;M=AlertMessage}&AlertDescription=${N=Alerting;M=AlertDescription}&AlertDetailsUrl=${N=Alerting;M=AlertDetailsUrl}&AcknowledgeUrl=${N=Alerting;M=AcknowledgeUrl}&AlertTriggerCount=${N=Alerting;M=AlertTriggerCount}&AlertTriggerTime=${N=Alerting;M=AlertTriggerTime;F=DateTime}&Severity=${N=Alerting;M=Severity}
              
            4. Click Add Action Add Trigger Action
        3. Click Next Configure Trigger Action
      3. Reset Action
        1. Click Add Action
        2. Select the Send a GET or POST Request to a Web Server option, then click Configure Action. Select GET or POST Request
          1. Name of action - An appropriate name (e.g. PagerTree Reset Action)
          2. Under HTTP request settings:
            1. Paste the PagerTree Endpoint URL you copied for the URL
            2. Select Use HTTP/S POST
            3. Body to POST - paste the following:
               ActionType=Resolve&AlertID=${N=Alerting;M=AlertID}
              
            4. Click Add Action Add Reset Action
        3. Click Next Configure Reset Action
      4. Summary
        1. Review all configuration details and if correct, click Submit Review Alert Summary

You have successfully completed the SolarWinds Integration. Now when SolarWinds creates an alert, PagerTree will create an incident and route it to the correct team member that is on-call. If you have any questions please contact support@pagertree.com