SolarWinds Integration

With the ilert SolarWinds Integration you can easily integrate SolarWinds Orion products (eg NPM and SAM) into ilert. The integration extends SolarWinds with SMS, push and voice notification as well as on-call schedules from ilert. Alerts are created in ilert and automatically resolved. Furthermore, alerts in ilert that were created by SolarWinds contain links to the respective alerts in SolarWinds.

In ilert: Create a SolarWinds alert source

1. Go to Alert sources → Alert sources and click on Create new alert source

   
2. Search for SolarWinds in the search field, click on the SolarWinds tile, and click on Next.

   
3. Give your alert source a name, optionally assign teams, and click Next.

4. Select an escalation policy by creating a new one or assigning an existing one.

   
5. Select your Alert grouping preference and click Continue setup. You may click "Do not group alerts for now" and change it later.

   
6. The next page show additional settings such as customer alert templates or notification prioritiy. Click on Finish setup for now.

7. On the final page, an API key and / or webhook URL will be generated that you will need later in this guide.

   

In SolarWinds: Create an alert definition

1. Go to the Settings → All Settings tab and click Manage Alerts

1. Click on ADD NEW ALERT

1. Fill out the Alert Properties according to your requirements and click on NEXT

1. Define the trigger condition on the next page and click on NEXT. The trigger condition defines the conditions under which you want to be alerted via ilert. You can use the full flexibility of SolarWinds here. In this example we define the following condition: Immediate alarm for all nodes that are not in the status up.

1. Define reset condition and click on NEXT. As soon as the reset condition occurs, the associated alert is resolved in ilert.

1. Select Time of Day according to your requirements and click on NEXT.

1. TRIGGER ACTIONS: Click Add Action and select Send a GET or POST Request to a Web Server to add trigger action.

1. Enter the HTTP POST Action URL generated in ilert in the URL field and select Use HTTP / S POST . Enter the following in the Body to POST field:

iLertEventType=ALERT&
iLertIncidentKey=${N=Alerting;M=AlertObjectID}-${N=Alerting;M=AlertActiveID}&
iLertEventSummary=${N=SwisEntity;M=DisplayName} (${N=SwisEntity;M=IP_Address}): ${N=SwisEntity;M=StatusDescription}&
iLertUrl=${N=Alerting;M=AlertDetailsUrl}&
AcknowledgeUrl=${N=Alerting;M=AcknowledgeUrl}&
AlertName=${N=Alerting;M=AlertName}&
AlertActiveID=${N=Alerting;M=AlertActiveID}&
AlertObjectID=${N=Alerting;M=AlertObjectID}&
ObjectType=${N=Alerting;M=ObjectType}&
Severity=${N=Alerting;M=Severity}

1. Optional: Activate the Repeat this action action every X minutes until the alert is acknowledged option in the execution settings. This is for safety, if an alert could not be sent to ilert (e.g. due to a network problem).

1. On ADD ACTION and then click NEXT.

2. RESET ACTIONS: Click Add Action and select Send a GET or POST Request to a Web Server to add Reset Action. Enter the HTTP POST Action URL generated in ilert in the URL field and select Use HTTP / S POST . Enter the following in the Body to POST field :

iLertEventType=RESOLVE&
iLertIncidentKey=${N=Alerting;M=AlertObjectID}-${N=Alerting;M=AlertActiveID}&
iLertEventSummary=${N=SwisEntity;M=DisplayName} (${N=SwisEntity;M=IP_Address}): ${N=SwisEntity;M=StatusDescription}

1. On ADD ACTION and then click NEXT.

2. Click SUBMIT on the SUMMARY page.

FAQ

Are alerts automatically resolved in ilert?

Yes, as soon as the reset condition for an alert has occurred in SolarWinds, the associated alert in ilert is resolved.

What if an alert is acknowledged in SolarWinds, is the associated alert also acknowledged in ilert?

No, in SolarWinds, it is unfortunately not possible to perform an action after an acknowledgment.

Can I link SolarWinds to multiple alert sources in ilert?

Yes, create several alert definitions in SolarWinds and store the corresponding URL of the alert source from ilert in the HTTP URL.

What if my internet connection is lost? Are the alerts generated in SolarWinds lost?

No, no alerts are lost if you have activated the option Repeat this action every X minutes until the alert is acknowledged in SolarWinds (see above). We also recommend that you monitor your Internet connection with an external monitoring service.

Can I change the content of the alert in ilert (e.g. the summary)?

Yes, you can configure this in the definition of the trigger action. In the HTTP Post Body, several variables in the format variable1=value1&variable2=value2&variable3=value3... are sent to ilert. To change the summary text of the alert, change the definition of the variable iLertEventSummary . All other variables that you add below iLertEventSummary inserted in the description of the alert.

The integration doesn't work. How do I find the issue?

If you do not find the error, please contact our support at [email protected].