Last updated Dec 13, 2024

This article highlights a new alerting feature that's natively available in Compass which is gradually rolling out to some Compass customers. It may not yet be visible or available on your site.

How alerts are created

An alert typically is not created manually but generated from various sources. Here are the different sources and their functionalities:

  1. Incoming/Bi-Directional Integrations: You can integrate your external services or applications, and allow them to trigger alerts in Compass. By configuring an integration and providing an API key, Compass processes the received data, based on the integration’s configuration and generates alerts. Read more about integrations.

  2. Emails: You can integrate services or software capable of sending emails. By forwarding these emails to Compass and configuring the Email integration, the received emails are processed according to the integration configuration associated with the email address, resulting in the creation of alerts. Read more about email integrations.

  3. Alert API: You can use the Alert API integration to generate alerts. All the data you provide in the request is then processed according to the configuration of the API integration associated with your API Key.

  4. Manual alert creation: You can also manually create alerts from the alerts listing page. By default, Compass utilizes the Default API Integration to process the data provided during alert creation. However, users have the option to select another API integration from the drop-down list, if available.

What happens after the alert is created?

The time between the alert being generated in Compass and the relevant responders being notified is shorter than the blink of an eye. However, a lot happens in between. The following is a step by step explanation of the process.

  1. First, Compass matches the request source with the related integration configuration. If the provided content does not match any existing integrations, Compass ignores the request/data.

  2. If the matched integration has ignore rules and the received content meets the conditions for at least one of these ignore rules, Compass ignores the request/data.

  3. If the matched integration doesn’t have any Create Alert Rules, or the received content does not meet at least one of the conditions, Compass ignores the request/data. Otherwise, it will prepare the alert’s template according to first matched Create Alert Rule.

  4. Compass checks whether there is an open alert that has the same alias with the prepared and modified alert template. If there is, the existing alert is deduplicated. If not, Compass creates a new open alert according to the prepared and modified alert template and starts a new alert notification flow.

Rate this page: