Alert Workflows
Alert workflows are triggered on changes to the alerts data. The Rootly platform is capable of receiving incoming events, known as alerts. These alerts are streamed in from a number of integrations (e.g. Jira, PagerDuty, Datadog, Grafana, etc.). You can leverage the power of workflows to auto declare incidents, send Slack notifications, etc. from these alerts.
Alert workflows are particularly useful for...
- Auto declaring incidents based on an incoming alert
- Updating an incident or action item based on changes to a corresponding Jira ticket
- Alerting common team channels (e.g. #alerts, #sre, #security) of critical events
In order to use an alert workflow, you must first ensure that you have alerts flowing into Rootly. See the Alerts page to learn more.
Follow the navigation below to begin configuring an alert workflow.
Workflows > Create Workflow > Alert
![Document image Document image](https://images.archbee.com/8_w24B7qUsOA0oEkiqb_I/S8wxeHcnAyy7qup8oMM06_afvfhyk-qk6ouvlx8kz4a-cleanshot-2023-11-26-at-002722.png?format=webp)
There is only one trigger event available for alert workflows. Select the Alert Created option as the trigger event. This will cause the workflow to initiate as soon as an alert is received in your Rootly organization.
![Document image Document image](https://images.archbee.com/8_w24B7qUsOA0oEkiqb_I/3HZJwUg-UNRwqPNF9lTrP_jnv8wrm4wyjnrama88ypa-cleanshot-2023-11-26-at-002919.png?format=webp)
Alert workflows have three properties that you condition off of.
![Document image Document image](https://images.archbee.com/8_w24B7qUsOA0oEkiqb_I/zfpmvIdFY8EwU3BjvTC9D_ejyvhrun6zxynelwdo3vh-cleanshot-2023-11-26-at-003956.png?format=webp)
The source represents where the alert originated from.
In the example above, the source condition will only pass if the alert came from PagerDuty.
You can find the source of an alert on the main Alerts page.
![Document image Document image](https://images.archbee.com/8_w24B7qUsOA0oEkiqb_I/CkoaouU13YnQ64ziCGD98_or2r9vjj1ffsrldoa6ggp-cleanshot-2023-11-26-at-004816.png?format=webp)
Each alert comes with a series of labels. The labels differ depending on the source (e.g an alert from Jira will have a different set of labels from an alert from Datadog). Alert labels are stored as an array of values.
In the example above, the label condition will only pass if the alert contains both the service_id:PLVWMVW AND action:incident.triggered labels.
You can find the labels for each alert on the alert details page. Alerts > select a specific alert.
![Document image Document image](https://images.archbee.com/8_w24B7qUsOA0oEkiqb_I/PcWBY62JsIDz3YV3OxiIJ_297zls3hf8npws1n04o-w-cleanshot-2023-11-26-at-004532.png?format=webp)
Each alert comes with a payload. The payload also differs depending on the source. Alert payload is stored as a JSON structure. JSONPath syntax can be used to filter for a specific value within the payload. Ruby regular expression (regexp) can be used to match the value filtered via JSONPath.
In the example above, the payload condition will only pass if the type field (within the data object in the payload) equals to incident, irregardless of the case (e.g. Incident is okay, INCIDENT is also okay, InCiDeNt is okay as well).
As with the label, you can also find the payload for each alert on the alert details page. Alerts > select a specific alert.
![Document image Document image](https://images.archbee.com/8_w24B7qUsOA0oEkiqb_I/2U35qa7aypVfAPzR80aJB_vtn-ijf6t-sp7r74fpyqt-cleanshot-2023-11-26-at-010450.png?format=webp)
Unlike other types of workflows, the available actions in alert workflows are fixed and not dependent on the integrated applications.
In the example below, the workflow will declare an incident in Rootly.
![Document image Document image](https://images.archbee.com/8_w24B7qUsOA0oEkiqb_I/SbhFVvrY3JXZM9DVBFG7V_k2yik0ty1dzaqnf8ezxu7-cleanshot-2023-11-26-at-011022.png?format=webp)
Once this alert workflow runs and creates an incident, it will result in an Incident Created event. Thus kicking off any incident workflows conditioned to initiate on an Incident Created event.
Be careful when setting up alert workflows as it might cause subsequent incident workflows to trigger unintentionally.
It is highly recommended that you disable your incident workflows before configuring and testing an alert workflow.
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.
![Doc contributor](https://s3.amazonaws.com/archbee-animals/cat.png)
![Doc contributor](https://s3.amazonaws.com/archbee-animals/koala.png)
![Doc contributor](https://s3.amazonaws.com/archbee-animals/dog.png)
![Doc contributor](https://s3.amazonaws.com/archbee-animals/cat.png)