Documentation is now available for the Fall 2020 Update release!

SolarWinds Orion

Describes how to setup an integration to receive alerts from SolarWinds Orion monitoring events.

Leave Feedback

Introduction

SolarWinds Orion Platform, provides a single, unified, application-centric view and experience.

SolarWinds Orion verified integration: Orion Platform 2019.4

OpsRamp configuration

Configuration involves the following:

  1. Installing the integration.
  2. Configuring the integration.

Step 1: Install the integration

To install:

  1. From All Clients, select a client.
  2. Go to Setup > Integrations > Integrations.
  3. From Available Integrations, select Monitoring > SolarWinds Orion.
  4. Click Install.

Step 2: Configure the integration

To configure the integration:

  1. From the API tab, do the following:
    1. Authentication: Copy the tenant id, token, Webhook URL, and cURL command.
      This information is used for the third-party configuration.
    2. Map Attributes: Provide the following mapping information:
      1. Select the required OpsRamp property from the drop-down.
      2. Click Add Mapping Attributes to map attributes for the specific OpsRamp alert property.
      3. Provide the entity and property value.
  2. From the Monitoring of Integration tab, click Assign Templates to assign templates.
  3. From the Audit Logs, set up audit log criteria and time frame.
SolarWinds Orion Integration

SolarWinds Orion Integration

Attribute mappings

The following table shows the attribute mappings for alert types and macros.

Attribute Mappings
SolarWinds Orion PropertyOpsRamp Property
descriptionAlert description
object_typeAlert metric
statusAlert state
SolarWinds Orion Property ValueOpsRamp Property Value
CriticalCritical
WarningWarning
InformationalInfo
SeriousCritical
NoticeOk
subjectAlert subject
resourceNameAlert ResourceName

SolarWinds configuration

To configure:

  1. Log into SolarWinds Orion.
  2. Go to Alerts & Activities > Alerts, click Manage Alerts.
  3. Click Add New Alert and configure the following:
    • Properties: Provide name, description, trigger frequency, and alert severity.
    • Trigger conditions: Specify the condition used to trigger the alert.
    • Trigger action: Select an action to execute on the alert and click Add Action.
      1. Select the Execute an External Program action and click Configure Action to configure the plugin.
      2. Name the Action: Paste the Webhook URL received from OpsRamp inbound configuration.
        SolarWinds Orion Configuration Alert

        SolarWinds Orion Configuration Alert

      3. Select the method as HTTPS/POST and enter the following payload:
  4. Click Submit.

The new alert is displayed on the Manage Alert screen.

Payload syntax

{ 
    "status": "${N=Alerting;M=Severity}", 
    "subject": "${N=Alerting;M=AlertMessage}", 
    "object_type": "${N=Alerting;M=ObjectType}", 
    "resourceName":"${N=SwisEntity;M=NodeWarrantyAlert.HostName}", 
    "description": "${N=Alerting;M=AlertDescription}", 
    "acknowledged": "${N=Alerting;M=Acknowledged}", 
    "acknowledged_by": "${N=Alerting;M=AcknowledgedBy}", 
    "timestamp": "${N=SWQL;M=SELECT GETUTCDATE() as a1 FROM Orion.Engines}", 
    "incident_id": "${N=Alerting;M=AlertObjectID}", 
    "solarwinds_url": "${N=Alerting;M=AlertDetailsUrl}" }

Payload example

{
"status":"Critical",
"subject":"Test-Service-Alert was triggered.115 Test-Service-Alert testing my local Critical",
"object_type":"Node",
"resourceName":"EC2AMAZ-1DC6910",
"description":"testing my local",
"acknowledged":"Not Acknowledged",
"acknowledged_by":"",
"timestamp":"3/18/2020 2:58:41 AM",
"incident_id":"10",
"solarwinds_url":"[http://EC2AMAZ-1DC6910:8787/Orion/View.aspx?NetObject=AAT:10](http://ec2amaz-1dc6910:8787/Orion/View.aspx?NetObject=AAT:10)"
}

Viewing alerts

To view the alerts in OpsRamp:

  1. Go to the Alerts page, search with the source name as Solarwinds Orion.
    Related alerts are displayed.
  2. Click Alert ID to view.
SolarWinds Orion Alert

SolarWinds Orion Alert