1. Home
  2. Alert Behavior
  3. Alert Routing Keys

Alert Routing Keys

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.


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.

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.

Pro Tips:

  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. They are case sensitive, making all key names entirely lowercase and intuitively named will obviously indicate which team or teams the key associates with.
  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: Due to a previous issue, Admins were able to save routing keys containing currently invalid characters (such as spaces).  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 October 8, 2018

Was this article helpful?

Related Articles