Help and Documentation
Incident Configuration

Incident Causes

6min

Overview

Incident causes allows you to track the root cause of incidents. This is particularly helpful with identifying trends so you can prioritize areas for post-incident improvement.

Document image


Field Type

Incident causes Severity is strictly a multi-select field type. This means you'll be able to select multiple cause values for a single incident.

Attributes

Incident causes can be configured with the following attributes. Each cause attribute can be referenced via Liquid syntax.

Since the incident cause field is a multi-select field type, the Liquid reference will follow an array syntax. Where i references the specific cause object in the list of environments.

{{incident.raw_causes[i] | get: '<attribute>'}}

ID

This is the unique identifier of the environment. This field cannot be customized. Rootly will auto assign the ID upon creation. It is typically used in Liquid references and API calls.

The following Liquid syntax will allow you to list out the incident causes ID(s) that are selected for an incident:

{{ incident.cause_ids }}

OR

{{ incident.raw_causes | get: 'id'}}for select field type

{{ incident.raw_causes[i] | get: 'id' }} for multi-select field type

Name

This is the value that is displayed on the UI for the incident causes. This field is customizable.

The following Liquid syntax will allow you to list out the incident causes name(s) that are selected for an incident:

{{ incident.causes }}

OR

{{ incident.raw_causes | get: 'name'}}for select field type

{{ incident.raw_causes[i] | get: 'name' }} for multi-select field type

Slug

This is the string that is used to reference the incident causes in Liquid references. This field is auto generated by lower-casing and hyphenating the incident causes name.

The following Liquid syntax will allow you to list out the incident causes slug(s) that are selected for an incident:

{{ incident.cause_slugs }}

OR

{{ incident.raw_causes | get: 'slug'}}for select field type

{{ incident.raw_causes[i] | get: 'slug' }} for multi-select field type

Description

This value is displayed on the UI to further explain each incident cause. This field is customizable.

The following Liquid syntax will allow you to list out the incident causes description(s) that are selected for an incident:

{{ incident.raw_causes | get: 'description'}}for select field type

{{ incident.raw_causes[i] | get: 'description' }} for multi-select field type

Support

If you need help or more information about this integration, please contact [email protected] or start a chat by navigating to Help > Chat with Us.

Updated 04 Sep 2024
Doc contributor
Doc contributor
Did this page help you?