Introduction to the OpsgenieSyncPack

Download this manual as a PDF file 

This section describes how you can use the "Opsgenie" SyncPack to automatically trigger, acknowledge, and resolve SL1 events and Opsgenie alerts between your Opsgenie and SL1 systems. The integration is bi-directional and synchronizes SL1 and Opsgenie.

This SyncPack uses the "Opsgenie Incident Integration" PowerPack.

What Can I Do with this SyncPack?

The "Opsgenie" SyncPack lets you automatically trigger, acknowledge, and resolve SL1 events and Opsgenie alerts between Opsgenie and SL1. The integration is bidirectional and synchronizes SL1 and Opsgenie.

You can configure this SyncPack to perform the following integrations:

  • Create an alert in Opsgenie from an SL1 event.
  • Collects on-call details from Opsgenie and add it to the notes of the corresponding SL1 event.
  • Update a synced Opsgenie alert when an event is acknowledged in SL1, including closing an alert in Opsgenie that was resolved by a corresponding SL1 event.
  • Collect resolved alert data from Opsgenie and clear the corresponding SL1 event.
  • Collect event details from SL1 and create a maintenance object in Opsgenie.
  • Connect to an input Opsgenie Heartbeat URL, and if the connection fails, create an event and send the event to SL1.

For more information about how to configure these applications, see Configuring Applications for the Opsgenie SyncPack.

Contents of the SyncPack

This section lists the contents of the "Opsgenie" SyncPack.

PowerFlow Applications

  • Bulk Clear SL1 Events. This application collects resolved alert data from Opsgenie and clears the corresponding SL1 event.
  • Close Opsgenie Alert. This application closes an alert in Opsgenie that was resolved by a corresponding SL1 event.
  • Create Alert in Opsgenie from a received SL1 event. This application collects event details from SL1 and creates a corresponding alert in Opsgenie.
  • Create Opsgenie Maintenance. This application collects event details from SL1 and creates a maintenance object in Opsgenie.
  • Get Oncall Details from Opsgenie and Send to SL1. This application collects on-call details from Opsgenie and adds it to the notes of the corresponding SL1 event.
  • Opsgenie Heartbeat. This application connects to an input Opsgenie Heartbeat URL. If the connection fails, an event is created and sent to SL1.
  • Pass Acknowledgment details from Opsgenie to SL1. This application collects acknowledged alert data from Opsgenie and updates the corresponding SL1 event. This application requires that the "Save Accounts to Cache" application has run and that user details have populated the cache.
  • Pass Acknowledgment details from SL1 to Opsgenie. This application collects acknowledged event data from SL1 and updates the corresponding Opsgenie alert.
  • Save Accounts To Cache. This application collects user details from SL1. The user's email address is used by the "Pass Acknowledged Alerts from Opsgenie to SL1" application to match the acknowledging user in Opsgenie to the SL1 user.

For more information about how to configure these applications, see Configuring Applications for the Opsgenie SyncPack.

Configuration Object

  • Opsgenie Config. This configuration object can be used as a template after the SyncPack is installed on the PowerFlow system. The configuration object includes the following:
  • Details for connecting to the SL1 API, including the URL, username, and password
  • Details for connecting to the Opsgenie API, including the base URL, private instance URL, and API keys
  • Details for connecting to an HTTP Proxy when communicating with Opsgenie, including the hostname or IP address, username, and password
  • Mapping between SL1 events and Opsgenie alerts including, device ID format, heartbeat and schedule name, default user, and maintenance object format information

Steps

The following steps are included in the SyncPack:

  • Accounts Dictionary Mapping
  • Check Opsgenie Heartbeat
  • Close the Alert from RBA
  • Create Opsgenie Maintenance
  • Create Bulk SL1 Payloads
  • Create SL1 Payload
  • Get Acknowledger Details From Opsgenie
  • Get Acked Alerts From Opsgenie
  • Get Acknowledgment From SL1
  • Get Resolved Incidents And Pass To SL1