Opsgenie

You can install the Opsgenie integration to to enabled bidirectional communication between Moogsoft Enterprise and Opsgenie. Notes you add to an Opsgenie alert appear in Moogsoft Enterprise as collaboration posts in related Situations. Likewise, posts you add to a Situation appear in the Opsgenie alert notes.

See the Opsgenie documentation documentation for details on Opsgenie components.

When you configure the Opsgenie integration, Moogsoft Enterprise automatically creates a 'Notify Opsgenie' Situation workflow which notifies Opsgenie of new Situations. See Workflow Engine for more information.Workflow Engine

You can also use the following workflow engine functions in alert and Situation workflows to interact with this integration:

  • createNotification: Triggers this integration to create an Opsgenie alert for the related alert or Situation.

  • ackNotification: Acknowledges any associated Opsgenie alerts for the related alert or Situation.

  • resolveNotification: Closes any associated Opsgenie alerts for the related alert or Situation.

Before you begin

The Opsgenie integration has been validated against Opsgenie's Alerts v2 REST API. Before you start to set up your integration, ensure you have created an API integration (REST API HTTPS over JSON) in Opsgenie that meets the following requirements:

  • The integration name is Moogsoft Enterprise API.

  • The integration is not assigned to a team.

  • Both Read Access and Create and Update Access is enabled.

  • The integration is enabled.

  • The integration has generated an API key.

Configure the Opsgenie integration

To configure the Opsgenie integration:

  1. Navigate to the Integrations tab.

  2. Click Opsgenie in the Notification and Collaboration section.

  3. Provide a unique integration name. You can use the default name or customize the name according to your needs.

  4. Provide connection details for your Opsgenie system and configure team mappings. If your Opsgenie system is in the EU region, you must edit the Alerts Endpoint URL, located under Endpoints, to reflect the EU URLs.

Configure Opsgenie

Configure a Webhook integration in Opsgenie for outgoing requests to Moogsoft Enterprise. See the Opsgenie Webhook documentation for instructions.

Opsgenie Webhook Field

Value

Name

Moogsoft Enterprise Webhook

Assigned to Team

[No Team]

Enabled

True

Custom Header

Header: 'Authorization'

Value: 'Basic' + Base64 Encoding of a valid Grazer user and password.

Add Alert Description to Payload

False

Add Alert Details to Payload

True

Webhook URL

Enter the URL Moogsoft Enterprise generates after you install the Opsgenie integration.

In the "Opsgenie to Webhook" section, enable Post to Webhook URL for Opsgenie Alerts and add the following actions:

  • If alert is created in Opsgenie, post to url in Webhook

  • If alert is acknowledged in Opsgenie, post to url in Webhook

  • If alert is unacknowledged in Opsgenie,  post to url in Webhook

  • If a note is added to the alert in Opsgenie,  post to url in Webhook

  • If alert is closed in Opsgenie,  post to url in Webhook

  • If a user executes "Assign Ownership" in Opsgenie,  post to url in Webhook

  • If a user takes ownership in Opsgenie,  post to url in Webhook

After you complete the Opsgenie Webhook configuration, Moogsoft Enterprise receives alert data from Opsgenie.