• Products
  • Get started
  • Documentation
  • Resources

Integrate Opsgenie with ThousandEyes

ThousandEyes logo

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. Go to Opsgenie’s ThousandEyes Integration page.

Under the Free and Essentials plans, the tabs under the Team dashboard are limited to Main, Integrations, Members, and Activity Stream.

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

An alternative for Step 1) and Step 2) 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.

3. Copy the API URL.

4. Click Save Integration.

ThousandEyes integration settings

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.

ThousandEyes add new alert rule

5. Click Add New Webhook.

6. Paste the API URL into "URL" field.

ThousandEyes Edit Webhook

7. Click Save Webhook.

8. Return to the alert configuration page, choose the webhook recently added from the "Select Webhooks" dropdown.

9. Click Create.

Sample payload sent from ThousandEyes

Create Alert payload:

JSON

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 { "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:

JSON

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 [ "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

ThousandEyes sample alert
Last modified on Feb 11, 2021
Cached at 10:55 PM on Apr 14, 2021 |

Additional Help

Ask the Community