Documentation forSolarWinds Observability

Notification Services Settings

Alert notification methods are versatile. SolarWinds Observability supports several methods for sending notifications.

SolarWinds Observability allows you to establish multiple notification services and configure alerts to terminate at different services. Alert notification services are shared across your account so you can use notification services other users have set up.

Click Settings > Notification Services to manage existing configurations or add new configurations.

Email Notifications

An email will be sent to any users configured to receive a notification on a triggered event. If the alert is configured to check for events every minute, an email will be sent every minute while the alert is triggered.

Set up Email notifications

  1. Click Settings > Notification Services > Email.

  2. Click Create configuration.

  3. Enter the name and description of the configuration.

  4. Select email recipients from the list or manually enter the email addresses.

  5. Click Notification test to verify the email is sent.

  6. Click Create.

Microsoft Teams

SolarWinds Observability provides Microsoft Teams integration for sending static alerts to a Teams channel. SolarWinds Observability can also insert data from the alert into the message.

Set up a Teams integration

  1. Click Settings > Notification Services > Microsoft Teams.

  2. Click Create configuration.

  3. Enter the name and description of the configuration.

  4. Add an Incoming Webhook to a Teams Channel:

    1. Follow Microsoft's instructions on how to Create an Incoming Webhook.

    2. In SolarWinds Observability, enter the Webhook URL in the field Microsoft Teams Webhook URL.

  5. Click Notification test to verify the notification is sent.

  6. Click Create.

OpsGenie

SolarWinds Observability can send alerts via email or using a webhook. Either method can be used to forward SolarWinds Observability alerts to OpsGenie.

Set up an OpsGenie integration

  1. Create an OpsGenie account if you haven’t done so already.

  2. Navigate to the Integrations tab and click Add new integration. You will be presented with a new API key. Copy the API key string.

  3. In SolarWinds Observability, click Settings > Notification Services > OpsGenie.

  4. Click Create configuration.

  5. Enter the name and description of the configuration.

  6. Select the API Hostname.

  7. Enter the API key you copied in OpsGenie in the field provided.

  8. Use the Recipients and Teams fields to specify who should be notified by email for the alert.

  9. Enter any possible tags.

  10. Click Notification test to verify the notification is sent.

  11. Click Create.

PagerDuty

SolarWinds Observability provides PagerDuty integration. PagerDuty is a third-party service that aggregates monitoring tools into a single point of ingestion. If you already have a PagerDuty account, integration with SolarWinds Observability will help keep your notifications in one place.

Set up a PagerDuty integration

  1. PagerDuty Support provides instructions for setting up alerts and integrations through PagerDuty. Follow the instructions on the PagerDuty Support page. When presented with the option to select Integrations, select SolarWinds Observability. When creation of the new service with integration is complete, PagerDuty provides you with an integration key. Copy the key.

  2. In SolarWinds Observability, click Settings > Notification Services > PagerDuty.

  3. Click Create configuration.

  4. Enter the name and description of the configuration.

  5. In the Routing Key field, enter the integration key you copied in step 1.

  6. In the Summary field, provide a summary of the issue causing the alert to trigger.

  7. In the Dedup Key field, enter the deduplication key for correlating trigger conditions.

ServiceNow

ServiceNow integration with SolarWinds Observability creates new incidents based on SolarWinds Observability alerts. To integrate, set up an OAuth JSON Web Token (JWT) endpoint in ServiceNow, and use the web token and instance name to configure a new notification service in SolarWinds Observability. See Create an OAuth JWT API endpoint for external clients for detailed instructions on how to set up a JWT endpoint in ServiceNow.

Set up a ServiceNow integration

  1. In your ServiceNow instance, navigate to System OAuth > Application Registry > Create an OAuth JWT API endpoint for external clients. Complete the required fields in the form.

    Set an access token lifespan value large enough to persist for the duration of this integration.

  2. Find your ServiceNow access token and instance name for this integration.

    1. To identify your ServiceNow instance name, find the URL used to log into ServiceNow. The instance name can be found in the subdomain of the URL. For example, if you use https://swo123.service-now.com/ to log into ServiceNow, swo123 would be the instance name.

    2. Open the OAuth JWT API endpoint you just created and toggle the password visibility of the Client Secret to on.

    3. Run the following curl command, replacing:

      • YourClientID with the Client ID found in the new JWT endpoint's details.
      • YourClientSecret with the Client Secret found in the new JWT endpoint's details.
      • YourUsername and YourPassword with the username and password you use to log into ServiceNow.
      • YourInstanceName with the instance name for your ServiceNow instance.
      curl -d"grant_type=password&client_id=YourClientID&client_secret=YourClientSecret&username=YourUsername&password=YourPassword" https://YourInstanceName.service-now.com/oauth_token.do
    4. Locate the access token in the curl response. In the following example curl response, KynMY2H0uwWkRc8g8YLXjnQxWbH5_wbnSiLsnaOoKw61GZkkV0ytZP74uF7hJyjfsWfaaFijqQzq2kcABNJxNA is the access token:

      {
          "access_token": "KynMY2H0uwWkRc8g8YLXjnQxWbH5_wbnSiLsnaOoKw61GZkkV0ytZP74uF7hJyjfsWfaaFijqQzq2kcABNJxNA",
          "refresh_token": "rXlb1sHjxMhmt4cBFJw0jr1XllVlOClQgjL9445NVmPZ8ZrbVt10sqRc0htNNFc64MchAwjMrjDOMRy6C4y97A",
          "scope": "useraccount",
          "token_type": "Bearer",
          "expires_in": 17999999
      }
  3. In SolarWinds Observability, navigate to Settings > Notifications Services > ServiceNow.

  4. Click Create Configuration.

  5. Enter a name and description for the ServiceNow notification service.

  6. In the App Token field, enter the access token identified in step 2.

  7. In the Instance field, enter your ServiceNow instance name identified in step 2.

  8. Click Notification Test to send a test incident to ServiceNow and verify the configuration is correct.

  9. Click Create.

Slack

SolarWinds Observability provides Slack integration for sending static alerts to a Slack channel. SolarWinds Observability can also insert data from the alert into the message. To set up a Slack integration, click Notification Services > Slack > Create configuration. A pop-up will be displayed informing you that you will be connected to Slack to complete the configuration.

SolarWinds Service Desk

SolarWinds Service Desk integration with SolarWinds Observability creates new incidents based on SolarWinds Observability alerts.To integrate, you must set up a web token in SolarWinds Service Desk, and use that token to configure a new notification service. See Token authentication for API integration for instructions on how to set up token authentication in SolarWinds Service Desk.

Set up a SolarWinds Service Desk integration

  1. Follow the SolarWinds Service Desk instructions to Set up token authentication.

  2. In SolarWinds Observability, navigate to Settings > Notifications Services > SolarWinds Service Desk.

  3. Click Create Configuration.

  4. In the Create SolarWinds Service Desk Configuration dialog:
    1. Provide a name and description.
    2. Select the host region.
    3. Under App Token, paste the token copied from SolarWinds Service Desk.
    4. Click Notification Test to test. If test is successful, click Create. If test is unsuccessful, repeat the process to try again.

Webhook

SolarWinds Observability alerts can be integrated with your existing notification services. Provide a URL and choose whether to send a POST or GET request. SolarWinds Observability will send an event as a JSON object.

Zapier

SolarWinds Observability provides integration with Zapier. Zapier is a third-party service enabling you to integrate your web applications and automate workflows. To use Zapier as a notification service, you need to have a Zapier account. Before you create a new configuration in SolarWinds Observability, log in to your Zapier account and create a new Zap, select Webhooks by Zapier as the Trigger app and Catch Hook as the Trigger.