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. Navigate 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 Available Integrations and Apps 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.
  6. Search for the application using the search option available. Alternatively, use the All Categories option to search.
  7. Click ADD on the Solarwinds Orion tile.

Inbound (Optional):

Solarwinds Orion - Inbound configuration

To configure the inbound, follow these steps:
Authentication:

  1. Select the Authentication Type as Webhook.

    • Webhook: By default, Webhook is selected as the Authentication Type.
      Make a note of Tenant ID, Token and Webhook URL.
      These details are used while creating an HTTP Request template during Solarwinds Orion configuration.

  2. Map Attributes: Map OpsRamp entity attributes with Solarwinds Orion attributes.

    1. Click +Add from the Map Attributes section.

    2. From the Add Map Attributes window, enter the below information:

      • OpsRamp Entity: Select Alert from the dropdown.
      • OpsRamp Property: Select the OpsRamp property from the dropdown.
      • Solarwinds Orion Entity: Enter the Solarwinds Orion entity value in the box and click the +value from the dropdown to add it. You can add multiple values.
      • Solarwinds Orion Property: Enter the Solarwinds Orion property.

      Parsing Condition:

      1. Click +Add and provide the parsing condition:
      2. Select an operator from the dropdown and enter a value in the fields accordingly. Based on the operator selected, the fields vary.
      3. Click Save. Click +Add to add more conditions.

      Property Values:

      1. Click +Property Value.
      2. Enter a value in the Solarwinds Orion Property Value box and select the appropriate value from the OpsRamp Property Value dropdown.
        The options in the OpsRamp Property Value dropdown appear based on the OpsRamp Property selected.
      3. Click Save.
      • Click +Property Value to add more property values.

      Default Value: Alternatively, you can enter/select a default value in the box.

      Note: To map more attributes, click +Entity.

    3. Click Add Map Attributes. The mapped attributes list is added.

      • Click the three dots icon at the end of each row to edit or remove the map attributes.
      • Use the Filter option to filter the map attributes.

  3. Additional Settings: Select the Drop alerts from unmanaged resources checkbox if you do not want to trigger alerts from unmanaged resources.

  4. Enrich and Create Alert: Select a process definition from the dropdown. You can customize the incoming alerts according to the properties defined in the process definition.

  5. Click Finish.

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