Rootly Integration

​

Rootly + Metoro Integration Benefits

• Automatically create incidents in Rootly when Metoro alerts are triggered
• Page on-call responders through Rootly’s incident response workflows
• Auto-resolve incidents when alerts recover in Metoro
• Centralize incident management while leveraging Metoro’s deep observability

​

How it Works

​

Requirements

• A Rootly account with webhook access
• Admin access in Metoro to configure integrations
• A webhook URL and authentication token from Rootly

​

Support

​

Integration Walkthrough

​

Step 1: Create a Webhook in Rootly and Add it to Metoro

1

Access Rootly Settings

Log into your Rootly account and navigate to Alerts → Sources (or directly go to https://rootly.com/account/alerts?tab=alert-sources)

2

Create New Webhook

Search for Generic Webhook. Click on Add source.

Alert Sources Page in Rootly with Generic Webhook

3

Configure Webhook Name and Owning Team

• Name: Give your webhook a descriptive name (e.g., “Metoro Alerts”)
• Owning Team: Select the team that will manage this webhook

Rootly webhook create screen

4

Configure Webhook Routing

Follow the directions to set up the alert routing method in Rootly.

Rootly webhook alert routing screen

5

Copy Webhook URL and Token

After selecting the routing method, Rootly will provide you with a webhook URL (with placeholders) and a Bearer token.

Rootly webhook URL and token

Make sure to replace the placeholder sections in the webhook URL with what is provided in the Notification Target Type and Target ID section in Rootly.

Once you securely store the webhook URL and Bearer token, make sure to save the current configuration in Rootly and proceed to adding the webhook in Metoro.

6

Add Copied Webhook in Metoro

We will add the copied webhook URL and Bearer token in Metoro. Make sure to copy the webhook URL and Bearer token from Rootly before proceeding.Go to the Integrations page in Metoro and next to the Webhooks, click on the Add Webhook button.

Metoro Add Webhook button

7

Fill in the Webhook Details

Fill in the details of the webhook that you copied from Rootly:

• Name: “Rootly Alert Webhook” (or your preferred name, can be the same as in Rootly)
• URL: Paste the webhook URL from Rootly (make sure to replace any placeholders with actual values)
• HTTP Method: POST
• Headers: Add the Authorization header
  • Click Add Header
  • Header Name: Authorization
  • Header Value: Bearer YOUR_ROOTLY_TOKEN (replace with your actual token)
• Body Template: Leave empty to use the default JSON payload, or customize it as needed.

We recommend customizing the body template to include specific fields that you can use on the Rootly side to name alerts, create links to the alerts in Metoro, define alert severity, and auto-resolve behavior.

Please check Webhook Integration documentation to see what variables you can use in the webhook body template.

Metoro Webhook Configuration Page

For the purpose of this guide, we will use the following body template:

Copy

Ask AI

{
    "priority": "P1",
    "metoro_alert_uuid": "$alert_uuid",
    "state": "$alert_state",
    "metoro_alert_fire_uuid": "$alert_fire_uuid",
    "alert_name": "$alert_name",
    "metric_name": "$metric_name",
    "metoro_alert_link": "$deep_link"
}

Any field that starts with $ is an alert template variable and will be populated dynamically depending on the alert.

8

Define Alert Content in Rootly

Now that we know how the webhook body will look like, we can define how the alert will be created in Rootly (such as the alert name, description, link to source, etc.). Go back to the Rootly webhook configuration page and fill in the Alert Content details by clicking on the Edit button.Alert Title: Enter {{alert.data.alert_name}}. This will use the alert_name JSON field from the Webhook body that we defined earlier. Alert Description: Enter any details you want to include in the alert description. You can use fields from the webhook body like {{alert.data.alert_name}}, {{alert.data.state}}, etc. Alert Source Link: Enter {{alert.data.metoro_alert_link}}. This will create a link to the alert in Metoro.Click Save to save the alert content configuration.

Rootly Alert Content Preview Page

It might be useful to send a test notification to Rootly by creating a test alert in Metoro with Alert Destination as the Rootly Webhook that we created earlier. This way, Rootly will auto-complete template/liquid variables and will show you a preview of how the alert will look like when it is created.

9

Define Alert Urgency in Rootly

By using the webhook JSON body, you can create a custom alert urgency in Rootly. This is useful to define how urgent the alert is and how it should be handled by the on-call team.

Rootly Alert Urgency Configuration

10

Configure Auto-Resolve in Rootly

To enable auto-resolve for alerts, you can configure the webhook to automatically resolve incidents when the alert state changes to “resolved”. This is done by setting the alert_state field in the webhook body to “resolved”.

This is optional, but recommended to ensure that incidents are automatically resolved when the underlying alert recovers.

From the webhook body that we defined earlier, we can use the metoro_alert_fire_uuid to identify alert triggers that are sent to Rootly and state field to identify the alert state. When the alert state changes to “resolved”, Rootly will automatically resolve the incident. Enter the following details in the Auto-Resolve section: Identifier: $.metoro_alert_fire_uuid Field location: $.state Field Value: resolved

Rootly Auto-Resolve Configuration

Click Save Changes.

Alternatively, you can use the $metoro_alert_uuid field as the identifier. Please read more in Handling Grouped Alerts section below to pick the best option that suits your use case.

​

Step 2: Use Rootly Webhook as Alert Destination in Metoro

1

Create or Edit Alert

Navigate to Alerts in Metoro and create a new alert or edit an existing one

2

Add Webhook Destination

In the Select Destination section:

• Click Add Destination
• Select Webhook from the dropdown
• Choose your Webhook from the list (the one you created in Rootly and added to Metoro in the previous step)

Selecting Rootly webhook as alert destination

3

Save Alert

Complete the alert configuration and save

​

Configuring Auto-Resolve (Recovery Notifications)

​

Enable Recovery Notifications

​

Rootly Auto-Resolve Configuration

​

Important: Handling Grouped Alerts

​

Understanding Alert UUIDs

• $alert_uuid: The unique identifier for the alert definition. This is the same for all firing instances of the alert you created in Metoro.
• $alert_fire_uuid: The unique identifier for a specific firing instance (each group by attribute value) of the alert. This is generated each time the alert fires.

​

Troubleshooting

​

Monitoring Integration Health

1. Check Webhook Logs in Metoro
   • Go to Metoro Logs
   • Filter: environment=metoro-internal and service.name=metoro-webhooks
   • Look for successful deliveries and any errors
2. Verify in Rootly
   • Check the webhook activity log in Rootly
   • Confirm incidents are being created and resolved as expected

​

Related Documentation