VictorOps Integration Guide

  • 2 minute(s) read
Prev Next

VictorOps is the real-time incident management platform that combines the power of people and data to embolden DevOps pros to handle incidents as they occur. It does more than just alert, it provides teams with a virtual environment where they can prepare for, react to, and recover from each incident regardless of location or device. It’s both real-time and thoroughly agile incident management.

VictorOps features:

  • Push notifications for @mentions.
  • Re-route incidents to multiple teams.
  • Up-to-date contact information for 1-touch team member dialing (SMS, email, phone).
  • Team member private chat.
  • Control Call: In-app voice conferencing initiation.
  • Post-Mortem Reporting: Use your activity, data, and posts from the VictorOpsTimeline.

For more information about slack, go to https://victorops.com

Catchpoint Integration

Catchpoint’s Alert Webhook allows Catchpoint to integrate with other tools by pushing data when a test triggers an alert. Any tool supporting Webhooks or providing a URL to POST data can be used. Alert Webhook templates can be customized to fit a tool’s format and content-type using Macros. If a template needs modification, please contact Catchpoint Support. We are happy to assist you in creating a template meeting your requirements. Below, you will find integration guide on setting up and customizing templates. These guide is a standard workflows created by Catchpoint focused on creating and confirming a Webhook template to be consumed by this tool. Catchpoint does its best to ensure the relevance of these guides and will be happy to assist in implementing a guide as described.

Catchpoint - VictorOps Integration Steps

VictorOps Setup

  1. Login to your VictorOps account.
  2. If you are a new VictorOps user, click Complete Setup on the top left corner of the page next to your company name.
  3. Then click Integrations on the top of the page
  4. If you are an existing VictorOps user, go to the home page and click Integrations.

vect_ops.png

5. Select REST Endpoint from the integrations list.

rest_api.png

6. Click Enable Integration

Rest_Endpoint_step_6.PNG

7. Under Post URL, select the portion of the URL up until the “/$routing_key” as shown. This willbe the VictorOps REST Endpoint that you will point Catchpoint to.

Catchpoint Setup

1. VictorOps configuration completed!

2. In the Alerts Webhook section, paste in the VictorOps REST Endpoint POST URL that was provided when you enabled the REST Endpoint within VictorOps.

3. The Alert format you need to choose is Template. Click Add New and you will be taken to the Edit Template window.

4. Give the Template a name and set the Format to Text.

5. The Template format must follow the VictorOps REST Endpoint guidelines. At a minimum you only need to include a ‘message_type’ field.

6. Other fields such as the ‘entity_type’, ‘state_message’ or ‘monitoring_tool’ can include Catchpoint Alert Webhook Macros that will allow you to customize the Alert content.

Example Template:

{
"message_type": "${switch('${notificationLevelId}','0','warning','1','critical','2','recovery','recovery')}",
    "entity_id": "Catchpoint Alert",
    "monitoring_tool": "catchpoint",
    "Test Type ID": "${testTypeId}",
    "Test Name": "${testName}",
    "Product": "${productId}",
    "Test_url": "${testUrl}"
}
  1. Save your template and Save the Webhook configuration.

8. If you have any alerts configured on your tests, you will now see CatchPoint Alerts appear within your VictorOps timeline.

Alert Macro Index

A full list of the Alert Webhook Macros can be found at: https://docs.catchpoint.com/docs/Alert-Webhook-Macro-Index