Alert Creation Flow

Alert Creation

Alert Sources

Alerts within OpsGenie can be created via different sources:

  • Incoming/Bi-Directional Integrations: Any external service or application that OpsGenie is integrated with can create alerts within OpsGenie. OpsGenie processes any received data from an external service according to the configuration of the integration that the provided API Key belongs to, and creates alerts if required to do so. Refer to the Integrations section or Integrations Page to see the list of external services that we already integrate with.
  • E-Mails: Integrate any service or software that has the capability of sending e-mails with OpsGenie. Forward these e-mails to OpsGenie after configuring an Email. OpsGenie processes any received emails according to the configuration of the email integration that the e-mail address belongs to.
  • Alert API: Create alerts via the Create Alert Requests of the Alert API, after configuring an API integration within OpsGenie. Any data within the request will be processed according to the configuration of API integration that the provided API Key belongs to.
  • Heartbeat Monitoring: Heartbeat Monitoring creates alerts within OpsGenie. If OpsGenie does not receive a Send Heartbeat Request within the defined time threshold, an alert will be created according to the configuration of the Heartbeat Integration.
  • Incoming Calls: Forward your phone calls to the number that OpsGenie provided while configuring an Incoming Call integration. When a call is received by OpsGenie, an alert is created by the Incoming Call integration that the provided call number belongs to.
  • OpsGenie Web Application: Create alerts via the Alerts->Create Alert page. By default, OpsGenie uses the Default API Integration while processing the data that was provided while creating an alert on the Web Application, but there is the option to select another API integration via the drop-down list (As shown in the screenshot below) to use in the process.
    • OpsGenie Android/iOS Mobile Applications: Create alerts via the mobile apps for iOS and Android on the alert list via the (+) sign in the bottom right corner in both applications.

Owner Team Concept

A team is assigned as the owner team of an alert according to the following conditions:

  1. If an alert is created via a team integration (an integration that is assigned to a team), the team is assigned as the owner team of the alert.

  2. If the alert creation is triggered via an incident, the team of the each responder alert is assigned as the owner team of the alert.

  3. If an alert is created via a global integration and is routed to only one team, the team is assigned as the owner team of the alert.

Alert Creation Flow

The diagram above is a clear summary of the alert creation flow from the moment of receiving Alert Create Content to the creation of the alert. The following is the step-by-step explanation:
1. OpsGenie matches the request source with the related integration configuration. If the provided content does not match any enabled integrations, OpsGenie ignores the request/data.

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

3. If the matched integration does not have any Create Alert Rules, or the received content does not satisfy at least one of the specified conditions, OpsGenie ignores the request/data. Otherwise, OpsGenie will prepare an alert template according to first matched Create Alert Rule.

4. If there is at least one Global Alert Policy whose conditions / time restrictions are satisfied by the prepared alert template, OpsGenie modifies the alert template according to the matched global alert policy/policies.

5. If the alert has an owner team and there is at least one Team Alert Policy, OpsGenie modifies the alert template according to the matched team alert policy/policies.

6. & 7. OpsGenie checks whether there is an open alert that has the same alias with the prepared and modified alert template. If there is, the existing open alert is de-duplicated . If there is not, OpsGenie creates a new open alert according to the prepared and modified alert template and starts an Alert Notifications Flow Alert Notifications Flow.