SolarWinds Orion Platform provides a single, unified, application-centric view and experience. Webhooks are used to ingest alerts from SolarWinds Orion monitoring events.

Supported version: Orion Platform 2019.4

Configure OpsRamp

Step 1: Install the integration

  1. From All Clients, select a client.
  2. Go to Setup > Account.
  3. Select the Integrations and Apps tab.
  4. The Installed Integrations page, where all the installed applications are displayed. Note: If there are no installed applications, it will navigate to the ADD APP page.
  5. Click + ADD on the Installed Integrations page. The Available Integrations and Apps page displays all the available applications along with the newly created application with the version.
    Note: You can even search for the application using the search option available. Also yu can use the All Categories option to search.
  6. Click ADD in the SolarWinds Orion application and click Install.
  7. Select authentication type as WEBHOOK and click Save.
  8. Make a note of Tenant ID, Token and Webhook URL.
    These details are used while creating an HTTP Request template during SolarWinds Orion configuration.
  9. Click Save.

WebHooks is automatically selected as the authentication mechanism.

Step 2: Configure the integration

  1. From the API tab, copy and save:

    • tenant id
    • token
    • Webhook URL
    • cURL command

    This information is used for the SolarWinds configuration.

  2. To enter the mapping information, select the required OpsRamp property from the drop-down.

  3. Click Add Mapping Attributes to map attributes for the specific OpsRamp alert property.

  4. Enter the entity and property value.

  5. From the Monitoring of Integration tab, click Assign Templates to assign templates.

  6. From the Audit Logs, set up audit the log criteria and time frame.

Inbound configurations capture all of the information needed to call OpsRamp APIs from SolarWinds Orion.

SolarWinds Orion Integration

Attribute mappings

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

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

Configure SolarWinds

  1. Log into SolarWinds Orion.

  2. Go to Alerts & Activities > Alerts and click Manage Alerts.

  3. Click Add New Alert and enter the following properties:

    • name
    • description
    • trigger frequency
    • alert severity.
  4. Specify the condition used to trigger the alert.

  5. Select a trigger action to execute on the alert and click Add Action.

  6. Select the Send a GET or POST Request to a Web Server action.

  7. Click Configure Action to configure the plugin.

  8. Paste the saved Webhook URL from OpsRamp inbound configuration.

    SolarWinds Orion Configuration Alert
  9. Select the method as HTTPS/POST and enter the following payload:

    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)"
        }
        
  10. Click Submit.

The Manage Alert screen displays the new alert.

View alerts

  1. Go to the Alerts page and search with Solarwinds Orion as the source name to display related alerts.
  2. Click Alert ID to view.
SolarWinds Orion Alert