Introduction to the xMatters SyncPack

Download this manual as a PDF file 

This section describes how you can use the "xMatters" SyncPack to automatically trigger, acknowledge, and resolve SL1 events and xMatters incidents between xMatters and SL1. The integration is bidirectional and synchronizes SL1 and xMatters.

This SyncPack uses the "xMatters Incident Integration" PowerPack.

What Can I Do with this SyncPack?

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

This SyncPack includes the following integrations:

  • Collect acknowledged or resolved incident data from xMatters, and then acknowledge or clear the corresponding SL1 events.
  • Collect acknowledged or resolved event data from SL1, and then acknowledge or clear the corresponding xMatters incidents.
  • Collect event details from SL1 and create a new incident in xMatters, and optionally populate the External Ticket ID field with a link to the xMatters incident.
  • Collect xMatters on-call details and populate the corresponding SL1 event notes with on-call details.

Contents of the SyncPack

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

PowerFlow Applications

  • Bulk Resolve SL1 Events. This application collects resolved incident data from xMatters and clears the corresponding SL1 event. To use this application, the incident description must include the event ID.
  • Get Acknowledged Incidents and Post Data to SL1. This application collects acknowledged incident data from xMatters and acknowledges the corresponding SL1 event. To use this application, the incident description must include the event ID and you must run the "Save Accounts To Cache" application.
  • Get Event Details and Post Incident URL to SL1. This application collects event details from SL1 and creates a new incident in xMatters. This application can optionally populate the External Ticket ID field with a link to the xMattersincident.
  • Get Oncall Details and Post Oncall List to SL1. This application collects xMatters oncall details and populates the corresponding SL1 event notes with oncall details.
  • Pass Acknowledgment details from SL1 to xMatters. This application collects acknowledged event data from SL1 and updates the corresponding xMatters incident. To use this application, the incident description must include the event ID.
  • Pass Resolution to xMatters from RBA. This application collects resolved event data from SL1 and updates the corresponding xMatters incident. To use this application, the incident description must include the event ID.
  • Save Accounts to Cache. This application collects user details from SL1. The user's email address is used by the "Pass Acknowledgment details from xMatters to SL1" application to match the acknowledging user in xMatters to the SL1 user.

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

Configuration Object

  • Xmatters Config Template. 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 xMatters API, including the API webhook, instance URL, group ID, username, and password.
  • Details for connecting to an HTTP Proxy when communicating with xMatters, including the hostname or IP address, username, and password
  • Mapping between SL1 events and xMatters incidents including, the default acknowledged user, whether an xMatters link should be added to the SL1 event, and whether an event should be resolved from xMatters.

Steps

The following steps are included in this SyncPack:

  • Accounts to URI Mapping
  • Create Bulk SL1 Payloads
  • Converting Xmatters Incident Response into SL1 Payload
  • Post Event Details To Xmatters
  • Get Acknowledger Details From XM
  • Get Acknowledgment From SL1 And Pass to Xmatters
  • Get Acknowledged Incidents
  • Get Event Details from SL1 Create Xmatters Alert
  • Get Resolved Incidents And Pass To SL1
  • Get Oncall Details from Xmatters