Slack and HipChat Integration

Last updated: Fri Nov 16 14:31:12 GMT 2018

The ThousandEyes platform integrates with the popular messaging applications Slack and HipChat. When an Alert is raised, notification can be sent to a channel automatically.

Slack Integration

In order to integrate ThousandEyes Alerts into Slack, you need to generate a webhook URL for your Slack channel as follows:

1. Sign into <your-domain>.slack.com
2. Click the option to add an Incoming Webhooks integration (https://my.slack.com/services/new/incoming-webhook/)
3. Choose a channel you want Alert notifications to be posted
4. Get the Webhook URL from the integration settings.

From ThousandEyes, under Alert Settings, expand the Alert rule you wish to integrate into Slack, then click the Notifications tab. Click Configure Integrations > Add New Integration, to open the below popup window. If you already have one or more integration services configured, click on Edit Integrations > Add New Integration

AddNewInegration.png

1. Type: Choose your integration type.
2. Name: Enter a name for your integration
3. URL: Enter the channel Webhook URL (per step 4 above)
4. Channel: Enter the channel name
5. Add New Integration: Once all fields are  are finalized, click to add a new integration

A configured Slack integration example is shown below.

sample_integration.png

Now when an alert is triggered, the alert details will be posted as a message within the integrated channel, as shown below. Clicking on the Alert message link will open ThousandEyes Views webpage at the alert start time.

alert_triggered.png

If you have the "Send an email when clears" box checked, under the Alert Rule > Notifications tab, and Alert Rule conditions are no longer met by your test (or the Alert Rule is updated such that the conditions no longer meet the criteria of the alert), the Alert Rule cleared message will be posted within your Slack channel. Clicking on the Alert message link will open ThousandEyes Views webpage at the alert cleared time.

alert_cleared.png
 

HipChat Integration 

In order to integrate ThousandEyes Alerts into HipChat, you need to generate a URL and AuthToken for your HipChat room as follows:

1. Sign in to <your_domain>.hipchat.com
2. Navigate to https://<your_domain>.hipchat.com/addons/
3. Select a room, and click "Build your Own Integration"
4. Enter a name for your integration and click Create
5. Within the "Send messages to this room by posting to this URL" box, save the                                                                                                                 URL https://<your_domain>.hipchat.com/v2/room/XXXXX/notification and the auth_token=<value>

From ThousandEyes, under Alert Settings, expand the Alert rule you wish to integrate into HipChat, then click the Notifications tab. Click Configure Integrations > Add New Integration, to open the below popup window. If you already have one or more integration services configured, click on Edit Integrations > Add New Integration

HipChat.png

1. Type: Choose your integration type.
2. Name: Enter a name for your integration
3. URL: Enter the HipChat room URL (from step 5 above)
4. Auth token: Enter HipChat room auth_token (from step 5 above)
5. Add New Integration: Once all fields are  are finalized, click to add a new integration

A configured Hipchat integration example is shown below.

HipChat.png

Now when an alert is triggered, alert details will be posted as a message within the integrated channel, as shown below. Clicking on the Alert message link will open ThousandEyes Views webpage at the alert start time.

hipchat_alert_triggered.png

If you have the "Send an email when clears" box checked, under the Alert Rule > Notifications tab, and Alert Rule conditions are no longer met by your test (or the Alert Rule is updated such that the conditions no longer meet the criteria of the alert), the Alert Rule cleared message will be posted within your HipChat room. Clicking on the Alert message link will open ThousandEyes Views webpage at the alert cleared time.

hipchat_alert_cleared.png