Configuring VictorOps

VictorOps is an incident management software built for DevOps. The integration allows you to push alerts to their platform, and we have worked together to make the integration seamless. To get started, you will first need to set up a VictorOps account at https://victorops.com/.

Integration Functionality

  • When an alert is created in Uptime.com, a corresponding alert is issued in VictorOps.

Integration Setup

First, login to your VictorOps Account, then click Settings>Alert Behavior>Integrations. Locate and click on REST Endpoint, then click Enable Integration on the next screen.

Next, locate Uptime.com and click Enable Integration. Copy the Service API Key from the next screen.

Return to Uptime.com. In order to activate the integration of VictorOps within your Uptime account, go to Notifications>Integrations, then click New Profile. Select VictorOps as the Provider Type when adding a new push notifications profile.

Paste the Service API Key copied previously into the Service API Key field, and Name the integration. For advanced usage, you may supply a routing key to send alerts to a specific team or user (see instructions below).

Obtaining a Routing Key

From your VictorOps account, return to the Settings screen and click Alert Behavior>Routing Key. Click Add Key and provide a routing key name. Copy this name.

Return to Uptime.com and paste the Routing Key into the Routing Key field. For more detailed instructions please view the VictorOps knowledgebase article on Routing Keys.

VictorOps.png

Once you've configured your VictorOps integration, you will need to assign it to a contact and make sure that contact is notified when a Check fails.

Assign Integration to Existing Contacts

To add your integration to an existing contact, click on or type the name of the contact into the Assign to Contacts field within the integration setup screen.

contacts.png

Create New Contacts for the Integration

Adding a dedicated or new contact cannot be done within the integrations screen. To do so first, click Notifications>Contacts. You can select New Contact, or add your integration to an existing contact.

Select VictorOps from the Push Notifications field within the New Contact screen.

Assign Integration Contact to a Check

If you have created a new or dedicated contact for your integration, you will need to add it to specific checks. If you have assigned the integration to a contact that is already assigned to one (or more) checks, you may skip this step.

Return to your Check’s Edit screen and assign this contact to the Contacts field to be notified of a downtime event. Alert data will appear in real time.

Test Your Integration

Test your integration with one of the following two options:

  1. Force the Check assigned to your Integration to fail by altering it (HTTPS checks can use a misspelling of the domain, for example)
  2. Click Notifications>Contacts, then click Actions>Test to send a test to the Contact

 

Test.png