SolarWinds
Company | Estimated Time | Vendor Docs | Open Source |
---|---|---|---|
SolarWinds Worldwide, LLC | 10 minutes | view | v3.rb |
What is SolarWinds?
SolarWinds gives you the tools to monitor your applications and environment through a single web console.
How It Works
SolarWinds triggers user defined alerts when (configured) network events occur.
- When an alert in SolarWinds is
triggered
, an alert is created in PagerTree automatically. - When an alert in SolarWinds is
reset
, the alert is resolved in PagerTree automatically.
Integration Walkthrough
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
- Create the integration by clicking the SolarWinds logo.
- Copy the Endpoint URL.
In SolarWinds
- Navigate to Alerts & Activity -> Alerts.
- In the upper right hand corner, click the Manage Alerts button to go to the Alert Manager.
- In Alert Manager click Add New Alert.
- In the Add New Alert Wizard
- Properties
-
Name of the alert definition - An appropriate name (e.g. High CPU)
-
Choose the severity of the alert. (PagerTree automatically maps the SolarWinds severity to the PagerTree urgency)
-
Click Next
SolarWinds Alert Properties
-
- Trigger Condition
-
Select conditions that will trigger an alert (create an alert)
-
Click Next
SolarWinds Trigger Condition
-
- Reset Condition
-
Select conditions that will reset and alert (resolve and alert)
-
Click Next
SolarWinds Reset Condition
-
- Time of Day
-
Select time of day conditions (if only applicable during certain times)
-
Click Next
Solarwinds Time of Day
-
- Trigger Action
- Message - Create an appropriate message (this will be displayed in the
title
of the alert created in PagerTree) - Trigger Actions
-
Click Add Action
-
Select the Send a GET or POST Request to a Web Server option, then click Configure Action.
-
Name of action - An appropriate name (e.g. PagerTree Trigger Action)
-
Under HTTP request settings:
-
Paste the PagerTree Endpoint URL you copied for the URL
-
Select Use HTTP/S POST
-
Body to POST - copy and paste the solarwinds_action_payload (below)
-
Click Add Action
Solarwinds PagerTree HTTP/S action configuration.
-
-
Click Next
-
-
Reset Action
- Click Add Action
- Select the Send a GET or POST Request to a Web Server option, then click Configure Action.
- Name of action - An appropriate name (e.g. PagerTree Reset Action)
- Under HTTP request settings:
-
Paste the PagerTree Endpoint URL you copied for the URL
-
Select Use HTTP/S POST
-
Body to POST - copy and paste the solarwinds_reset_payload (below)
-
Click Add Action
Solarwinds PagerTree Reset Action
-
- Click Next
- Summary
-
Review all configuration details and if correct, click Submit
Review alert configuration
-
-
- Message - Create an appropriate message (this will be displayed in the
- Properties
You have successfully completed the SolarWinds Integration.
SolarWinds Action Payload
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}
If you prefer JSON, make sure to set the Content-Type to "application/json" and use this body payload instead:
{
"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}"
}
SolarWinds Reset Payload
ActionType=Resolve&AlertID=${N=Alerting;M=AlertID}
If you prefer JSON, make sure to set the Content-Type to "application/json" and use this body payload instead:
{
"ActionType": "Resolve",
"AlertID": "${N=Alerting;M=AlertID}"
}
Troubleshooting
If you don't see integration logs being generated on the PagerTree side, check the SolarWind log files. Customers with self-managed instances have reported the following types of errors:
- Invalid Root Certificates (TLS)