SolarWinds Network Performance Monitor

The Solarwinds Orion platform powers SolarWinds’ networking and systems management products.

The integration with xMatters supports automated callout to on-call resources. Recipients can engage in a workflow to acknowledge alerts, set maintenance periods and clear alerts from the Orion console. The recipient can also escalate to other on-call resources. All workflow including notification and responses are annotated to the alert.

 

How to set up a SolarWinds configuration

Before you get started, make sure that you have already installed and configured an xMatters Agent on your SolarWinds server. This integration uses the xMatters Agent to handle communication between xMatters On-Demand and SolarWinds.

After you give your configuration a name and description, type a name to use when sending alerts (so you can easily tell which configuration or integration the alerts are from), and add all of the users and groups you want to be notified.

In the list of available xMatters Agents, select the Agent that you installed on the SolarWinds server, and then supply the following information about your SolarWinds system:

  • SolarWinds API Endpoint URL: A URL that xMatters can access to post back to your SolarWinds system via the SolarWinds API. If you use a local address (for example, localhost), make sure the hostname matches the one for the SolarWinds certificate on the machine where the xMatters Agent is installed.
  • SolarWinds API Username: The username of a SolarWinds user that can grant xMatters access to the SolarWinds API.
  • SolarWinds API Password: The SolarWinds user's password.

Once you save the configuration, xMatters displays the information you need to configure SolarWinds:

You can now create a trigger action and a reset action for an alert in SolarWinds and use the payload and URLs supplied on the configuration screen to configure them.

Use your integration

Whenever an event in SolarWinds triggers the alert, the HTTP POST will send the information to xMatters and initiate the form. The integration will send the information to the recipient specified in the HTTP request, prompting them to respond. When xMatters receives the response, the integration will send the response back to SolarWinds via the xMatters Agent, and update the original event.

Troubleshooting

SolarWinds NPM doesn't escape certain characters in the payload it sends out (& or % for example). This will cause issues when xMatters tries to parse the payload. We're looking into a permanent fix, but, if you need help adjusting the payload to work around this issue in the meantime, reach out to us at https://support.xmatters.com.