Configuring VictorOps (Splunk On-Call)

VictorOps, now Splunk On-Call, 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 Splunk On-Call account at https://www.splunk.com

Integration Functionality

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

Table of Contents

• Integration Setup
• Obtaining a Routing Key
• Assign Integration to Contacts
• Assign Integration Contact to a Check
• Test Your Integration

Integration Setup

Return

First, login to your Splunk On-Call Account, then click Settings > Integrations. 

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 Splunk On-Call 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

Return

From your VictorOps account, return to the Settings screen and click 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.

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 Contacts

Return

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. 

You can designate a new contact from within the integration setup. Simply enter the name of your new contact into the Assign to Contacts field, and select it as depicted below:

Uptime.com will create a new contact and assign the integration to it. You can find this contact when you click Notifications > Contact.

Assign Integration Contact to a Check

Return

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

Return

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