Our next-gen architecture is built to help you make sense of your ever-growing data. Watch a 4-min demo video!

Back to All Docs

Opsgenie Outbound Webhooks Opsgenie Outbound Webhooks

Last Updated: May. 20, 2024

Enhance your observability workflows by sending real-time event notifications and log data to Opsgenie using this outbound webhook.

How it works

Alerts in Coralogix can trigger new alerts and resolve alerts in Opsgenie depending on the settings chosen for each alert.

  • When an alert in Coralogix has an Opsgenie webhook and its conditions are met, an event is sent to your service in Opsgenie.
  • Different events from Coralogix will trigger a new alert in the corresponding Opsgenie service.
  • If “Notify When Resolved” is set for the Coralogix alert, once the conditions have returned to their designated normal range, a Coralogix resolve event will be sent to the Opsgenie service, and the alert status will be changed to Closed.

Access the Opsgenie webhook URL

Access your webhook URL in your Opsgenie account.

STEP 1. From the Teams tab, select a team.

STEP 2. From the Settings tab, select Integrations in the left-hand panel.

STEP 3. Click Add Integration. Select Coralogix from within the Integration list.

STEP 4. When you hover over Coralogix, your cursor will show an Add option. Click Add.

STEP 5. Click CREATE ALERT.

STEP 6. Select an alert priority (P1 – P5). Click Save.

Notes:

  • The Opsgenie webhook will produce alerts only for the selected priority, regardless of the severity of the associated Coralogix alert.
  • Create a new webhook in your Opsgenie dashboard if you desire alerts with other priorities.
  • To make the priority dynamic according to the alert severity in the alert definition, set it as {{_payload.priority}}. The mapping is: Critical – P1, Error – P2, Warning – P3, Info – P5

STEP 7. [Optional] The Opsgenie webhook does not include several fields by default, which can be added in the integration settings within Opsgenie. Add any of the following fields in Extra Properties to be included in your alerts:

Field NameProperty
alert_value_payload.alert_value
notification_grouped_by_payload.notification_grouped_by
namename
alert_threshold_payload.alert_threshold
meta_labels_payload.meta_labels
coralogix_team_name_payload.coralogix_team_name
group_by_field_1_payload.group_by_field_1
group_by_field_2_payload.group_by_field_2
group_by_value_1_payload.group_by_value_1
group_by_value_2_payload.group_by_value_2
Alias_payload.alias
alert_url_payload.alert_url
logs_url_payload.related_logs_url
edit_alert_url_payload.edit_alert_url
alert_unique_identifier_payload.alert_unique_identifier
company_id_payload.company_id

The group_by_field_<#> and group_by_value_<#> fields are dynamic. They correspond to the specific splits defined in the alert notification settings. If your alert is not configured to trigger a message for each permutation, these fields will not be present. When enabled, these values will be populated based on the selected group-by criteria.

The notification_grouped_by field contains a JSON representation of all the selected values used for splitting notifications.

STEP 8. Copy the integration URL displayed, to be used in your webhook setup.

STEP 9. Click Save Integration.

Create an Opsgenie webhook

Create an Opsgenie webhook in your Coralogix dashboard.

STEP 1. From the Coralogix toolbar, navigate to DATA FLOW > EXTENSIONS.

STEP 2. In the Outgoing Webhooks section, click OPSGENIE WEBHOOK.

STEP 3. Click + ADD NEW.

STEP 4. Enter the following details for your webhook:

  • Webhook Name. Input a name for your webhook that will enable you to easily identify this webhook later when attaching it to one of your alerts.
  • URL. Paste the Opsgenie webhook URL.

STEP 6. Click TEST CONFIG.

The system will create a test alert in Opsgenie using the webhook URL. If the test alert is received successfully, a confirmation message is displayed.

STEP 7. Once the configuration is confirmed, configure your alert notifications.

Best Practices

  • Create a new integration in your Opsgenie dashboard for every desired priority (P1-P5).
  • Create the same number of webhooks in your Coralogix dashboard, each with a different URL.

Additional Resources

DocumentationCoralogix Integration Packages

Support

Need help?

Our world-class customer success team is available 24/7 to walk you through your setup and answer any questions that may come up.

Feel free to reach out to us via our in-app chat or by sending us an email at support@coralogix.com.

On this page