ThousandEyes Integration

ThousandEyes is a tool that monitors internal and external network performance to improve application delivery and reduce service interruptions.

288

What does Opsgenie offer to ThousandEyes users?

The ThousandEyes platform allows customers to configure highly customizable Alert Rules and assign them to tests, in order to highlight or be notified of events of interest. With the ThousandEyes Integration, Opsgenie acts as a dispatcher for these alerts and determines the right people to notify based on on-call schedules– notifies via email, text messages (SMS), phone calls, and iPhone & Android push notifications, and escalates alerts until the alert is acknowledged or closed.

Functionality of the Integration

  • An alert notification is triggered when tests results assigned to the alert meets the conditions, an alert is also created in Opsgenie automatically through the integration.
  • When the alert is cleared in ThousandEyes, the alert is also closed in Opsgenie.

Add ThousandEyes Integration in Opsgenie

  1. Please create an Opsgenie account if you haven't done so already.
  2. Go to [Opsgenie's ThousandEyes Integration ](http://google.compage.

🚧

For Free and Essentials plans, you can only add the integrations from the Team Dashboards, please use the alternative instructions given below to add this integration.

  1. Specify who is notified of ThousandEyes alerts using the Teams field. Auto-complete suggestions are provided as you type.

📘

An alternative for Step 2) and Step 3) is to add the integration from the Team Dashboard of the team which will own the integration. To add an integration directly to a team, navigate to the Team Dashboard and open Integrations tab. Click Add Integration and select the integration that you would like to add.

  1. Copy the API URL.
  2. Click Save Integration.
917

Configuration in ThousandEyes

  1. In ThousandEyes, open the Alerts Screen from the side menu.
  2. Create or Edit an existing alert.
  3. Open the "Notifications" tab of the alert.
  4. Click Edit Webhooks in the Webhooks section.
957
  1. Click Add New Webhook.
  2. Paste the API URL into "URL" field.
800
  1. Click Save Webhook.
  2. Return to the alert configuration page, choose the webhook recently added from the "Select Webhooks" dropdown.
  3. Click Create.

Sample payload sent from ThousandEyes

Create Alert payload:

{
    "eventType":"ALERT_NOTIFICATION_TRIGGER",
    "eventId":"8416215-4867000",
    "alert":{
        "agents":[
            {
                "active":1,
                "metricsAtStart":"Error Type: \"Connect\"",
                "metricsAtEnd":"",
                "agentId":4522,
                "agentName":"Amsterdam, Netherlands (Trial)",
                "dateStart":"2016-06-07 08:48:08",
                "permalink":"https://app.thousandeyes.com/web/http-server?__a=50664&testId=106681&roundId=1465289288&agentId=4522"
            },
            {
                "dateStart": "2014-03-24 19:01:48",
                "active": 1,
                "metricsAtStart": "Error type: \"DNS\"",
                "metricsAtEnd": "Error type: \"DNS\"",
                "agentId": 108,
                "agentName": "Boston, MA",
                "permalink": "https://app.thousandeyes.com/web/http-server?__a=11&testId=5176&roundId=1395699129&agentId=108"
            }

        ],
        "alertId":4867000,
        "dateStart":"2016-06-07 08:48:08",
        "apiLinks":[
        {
            "rel":"related",
            "href":"https://api.thousandeyes.com/tests/106681"
        },
        {
            "rel":"data",
            "href":"https://api.thousandeyes.com/web/http-server/106681"
        }
        ],
        "permalink":"https://app.thousandeyes.com/web/http-server?__a=50664&testId=106681&roundId=1465289288",
        "ruleExpression":"Error Type is any",
        "ruleName":"Default HTTP Alert Rule",
        "ruleId": 414881,
        "testId":106681,
        "testName":"test1",
        "violationCount":1,
        "type":"HTTP Server"
    }
}

This payload is parsed by Opsgenie as:

[
    "eventId" : "8416215-4867000",
    "eventType" : "ALERT_NOTIFICATION_TRIGGER",
    "ruleExpression" : "Error Type is any",
    "type" : "HTTP Server",
    "agents" : "Agents:

    Id:4522
    Name:Amsterdam, Netherlands (Trial)
    Active:1
    MetricsAtStart:Error Type: "Connect"
    MetricsAtEnd:

    Id:108
    Name:Boston, MA
    Active:1
    MetricsAtStart:Error type: "DNS"
    MetricsAtEnd:Error type: "DNS"

    ",
    "violationCount" : "1",
    "dateStart" : "2016-06-07 08:48:08",
    "ruleName" : "Default HTTP Alert Rule",
    "testId" : "106681",
    "alertId" : "4867000",
    "permalink" : "https://app.thousandeyes.com/web/http-server?__a=50664&testId=106681&roundId=1465289288",
    "ruleId" : "414881",
    "testName" : "test1"
]
Close Alert payload:

{
    "eventType": "ALERT_NOTIFICATION_CLEAR",
    "eventId": "8416248-4867000",
    "alert": {
        "agents": [
            {
            "active": 0,
            "metricsAtStart": "Error Type: \"Connect\"",
            "metricsAtEnd": "Error Type: \"None\"",
            "agentId": 4522,
            "agentName": "Amsterdam, Netherlands (Trial)",
            "dateStart": "2016-06-07 08:48:08",
            "permalink": "https://app.thousandeyes.com/web/http-server?__a=50664&testId=106681&roundId=1465289288&agentId=4522"
            }
        ],
        "alertId": 4867000,
        "dateEnd": "2016-06-07 08:50:05",
        "dateStart": "2016-06-07 08:48:08",
        "apiLinks": [
            {
                "rel": "related",
                "href": "https://api.thousandeyes.com/tests/106681"
            },
            {
                "rel": "data",
                "href": "https://api.thousandeyes.com/web/http-server/106681"
            }
        ],
        "permalink": "https://app.thousandeyes.com/web/http-server?__a=50664&testId=106681&roundId=1465289288",
        "ruleExpression": "Error Type is any",
        "ruleName": "Default HTTP Alert Rule",
        "ruleId" : "414881",
        "testId": 106681,
        "testName": "test1",
        "violationCount": 1,
        "type": "HTTP Server"
    }
}

Sample Alert

2644