Functionality allows you to specify the impacted features during an incident. This can help you identify which responders to bring in, which on-call to page, which customers to inform, etc. Individual functionalities can be mapped to your status pages.

​

Field Type

Functionality can be customized to be either a select or multi-select field type. This means you can configure it to allow only one functionality value to be selected per incident or allow multiple functionality values to be selected per incident.

​

Attributes

Functionalities can be configured with the following attributes. Each functionality attribute can be referenced via Liquid syntax.

​

ID

This is the unique identifier of the functionality. This field cannot be customized. Rootly will automatically 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 functionality ID(s) that are selected for an incident:

{{ incident.functionality\_ids }}

OR

{{ incident.raw\_functionalities | get: 'id'}} for the select field type

{{ incident.raw\_functionalities\[i\] | get: 'id' }} for a multi-select field type

​

Name

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

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

{{ incident.functionalities }}

OR

{{ incident.raw\_functionalities | get: 'name'}} for the select field type

{{ incident.raw\_functionalities\[i\] | get: 'name' }} for a multi-select field type

​

Slug

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

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

{{ incident.functionality\_slugs }}

OR

{{ incident.raw\_functionalities | get: 'slug'}} for the select field type

{{ incident.raw\_functionalities\[i\] | get: 'slug' }} for a multi-select field type

​

Description

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

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

{{ incident.raw\_functionalities | get: 'description'}} for the select field type

{{ incident.raw\_functionalities\[i\] | get: 'description' }} for a multi-select field type

​

Color

Each functionality can be assigned a color, which will be used for color-coding on metrics graphs.

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

{{ incident.raw\_functionalities | get: 'color'}} for the select field type

{{ incident.raw\_functionalities\[i\] | get: 'color' }} for a multi-select field type

​

Slack Channels

Each functionality can be linked to one or more Slack channels. By default, Rootly does not notify the linked channel(s) when a functionality is selected for an incident. Notification needs to be explicitly called out as Attached Functionality Channels in workflow configurations.

Systematically, each Slack channel is stored as an object containing an ID and name.

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

{{ incident.raw\_functionalities | get: 'slack\_channels'}} for the select field type

{{ incident.raw\_functionalities\[i\] | get: 'slack\_channels' }} for a multi-select field type

​

Slack Aliases

Each functionality can be linked to one or more Slack user groups (aka aliases). By default, Rootly does not invite users in the linked user group(s) when a functionality is selected for an incident. Invitations need to be explicitly called out as Attached Functionality Aliases in workflow configurations.

The following Liquid syntax will allow you to list out the functionality Slack Alias(es) that are selected for an incident:

{{ incident.raw\_functionalities | get: 'slack\_aliases'}} for the select field type

{{ incident.raw\_functionalities\[i\] | get: 'slack\_aliases' }} for a multi-select field type

​

Notify Emails

Each functionality can be linked to one or more emails. By default, Rootly does not send emails to the linked address(es) when a functionality is selected for an incident. Notification needs to be explicitly called out as {{ incident.raw\_functionalities | map: 'notify\_emails' | flatten | join: ',' }} in workflow configurations.

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

{{ incident.raw\_functionalities | get: 'notify\_emails'}} for the select field type

{{ incident.raw\_functionalities\[i\] | get: 'notify\_emails' }} for a multi-select field type

​

Import Functionalities

Instead of creating functionalities from scratch, Rootly allows you to import functionalities from PagerDuty or Opsgenie. Imported functionalities will be automatically kept in sync on a daily basis.

The following Liquid syntax will allow you to list out the corresponding IDs from each of the external paging applications:

PagerDuty

{{ incident.raw\_functionalities | get: 'pagerduty\_id' }} for the select field type

{{ incident.raw\_functionalities\[0\] | get: 'pagerduty\_id' }}for a multi-select field type

Opsgenie

{{ incident.raw\_functionalities | get: 'opsgenie\_id' }} for the select field type

{{ incident.raw\_functionalities\[0\] | get: 'opsgenie\_id' }}for a multi-select field type

​

Support

If you need help or more information about this integration, please contact support@rootly.com or start a chat by navigating to Help > Chat with Us.