1. Home
  2. Alert Behavior
  3. Create & Manage Alert Routing Keys

Create & Manage Alert Routing Keys

Routing Keys in VictorOps

Alert routing gives you the precision required to assign specific types of alerts to specific groups. When the objective is to quickly and accurately target specific team members to deal with a particular incident without unnecessarily notifying your entire team, Routing Keys are the tool to use.

You may create and manage your Routing Keys by navigating to Settings >> Alert Behavior >> Routing Keys.

create and manage routing keys in victorops


Routing Rules in VictorOps

When an alert is delivered to VictorOps, your routing rules determine whether an incident is created, and to which team alerts and incidents will be routed. When an incident is routed to a particular escalation policy, that escalation policy determines who to notify, and who to escalate to if the incident stays unacknowledged.

create and manage routing rules in victorops

escalation policies and routing keys for REST endpoint victorops

Find the Routing Key for an Alert

All types of alerts have a routing key assigned to them by your administrator. This is the key used to map an alert to a team. To find the routing key for an alert, click on an open incident for the alert (or look in the alert’s details) in the VO mobile or web app. You will see the routing key in the list of key/values.

finding a routing key in victorops
Routing Key Tips & Tricks

  1. Each team should have one routing key that is not shared with any other teams. Keeping the naming of the routing keys identical or at least similar to the team name will also reduce confusion.
  2. Keep the names of routing keys simple. Making all key names intuitively named will obviously indicate which team or teams the key associates with. Note that routing keys are case insensitive.
  3. A well-made set of routing keys will make filtering the timeline a breeze. A filtered timeline is the easiest way to hone in on exclusively the events that are important to you.

Note: As a best practice, we recommend ensuring that all existing routing keys only possess letters, numbers, hyphens, and underscores, and changing the routing key if any other characters are found.

Updated on May 28, 2019

Was this article helpful?

Related Articles