1. Home
  2. Transmogrifier
  3. Transmogrifier: Transformations

Transmogrifier: Transformations

Requirements

Versions Supported: Full-Stack 

VictorOps Version Required: N/A SaaS

A transformation is a way to change alert data before it arrives at your VictorOps timeline. Typing the name of an existing field into the Transform’s ‘alert field’ box, allows you to overwrite that field with a new value of your choosing.

Transformation actions can also add entirely new fields to an alert.  This can be accomplished by simply typing the desired name of the field into the alert field section and assigning a value.


Transformation Examples


Changing the routing key

Change the routing key of a particular set of alerts that need to create incidents for a different team.  Assuming you set up an integration that sends all alerts to your Database team, but you want a particular subset of incidents related to a specific host (db03) to go to the Development team (routing_key = devs)


Adding a new alert field

Add a new unique field to an alert by a new field name to the alert field, this will automatically create a new field. The value of the new field can be set anything you want.


Muting Noisy Alerts

Some alerts coming into the timeline can be distracting and cause unnecessary paging. By transforming the message_type field to INFO these noisy alerts can be muted.


Change the Appearance of Incidents and Notifications

The below transformation changes the display name to show more details in the notification message — the entity_display_name. The below screenshot shows how using variable expansion and transformations the display name is transformed to also reflect the monitoring tool and host name of the incident.


Combining Multiple Different Alerts Into One Single Incident

To combine multiple different alerts into one single incident, first find a value to match which associates multiple different incidents. Then, transform the entity_id field to a set value. By pre-determining the entity_id, VictorOps will automatically aggregate the alerts.


For help with AND/OR logic, see this article.

Updated on April 30, 2018

Was this article helpful?

Related Articles