VictorOps Integration (via Email)

VictorOps is a real-time incident management and collaboration platform for IT and DevOps teams. VictorOps supports triggering and resolving incidents via email, so you can route AlertSite email alerts to VictorOps to automatically create and resolve incidents based on the status of your AlertSite monitors. This topic explains how to set up the communication between AlertSite and VictorOps.

In This Topic

Configuring VictorOps Email Endpoint

First of all, you need to enable the email endpoint in VictorOps to be able to trigger and resolve incidents via email. To do that:

The email address looks like this:


The $routing_key should be replaced with the key of a team to which you want to route the alerts. For example:

Team routing keys are configured at the bottom of the Settings > Integrations page. For details, see Routing Keys in the VictorOps knowledge base.

If you do not use routing, remove the +$routing_key part (including the plus sign) so that the email looks like this:

Configuring AlertSite

Customizing Email Templates

When using the VictorOps email endpoint, the email subject must include specific keywords - CRITICAL or PROBLEM to open a new incident, and RESOLVED or OK to resolve an incident. You can customize AlertSite email alerts to include these keywords.

Note: The email subject line must be the same in both the “error” and “clear” templates (apart from the CRITICAL/PROBLEM and RESOLVED/OK words). This is needed for VictorOps to recognize that the “clear” email is related to the incident opened by the “error” email. For example, do not use the $STATUS variable in the subject line, because the status code will be different in the “error” and “clear” alerts, and, in this case, VictorOps will not be able to match these alerts.

To create custom alert templates for VictorOps:

Adding VictorOps to Alert Recipients

Next, you need to add the VictorOps email endpoint that you generated earlier as an alert recipient in AlertSite:

Assigning Custom Templates to VictorOps Email Alerts

Now, you need to assign your custom alert templates to the VictorOps alert recipient. To do this, you need to create a recipient group that contains the VictorOps recipient, the custom templates, and the monitor whose alerts you want to send to VictorOps:

Now, the specified monitors will send alerts to VictorOps.

Viewing Alerts in VictorOps

You can view AlertSite alerts in the VictorOps Timeline and Incidents tabs:

AlertSite alert in VictorOps

Click More info to view the alert contents, including the description of the error occurred:

Alert details

The team members can then acknowledge the incidents and take action to resolve them. The incidents will also be resolved automatically when a “clear” notification arrives from AlertSite.

See Also

© 2017 SmartBear Software. All rights reserved.      Terms of Use · Privacy Policy