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 Skylar One events and xMatters incidents between xMatters and Skylar One. The integration is bidirectional and synchronizes Skylar One 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 Skylar One events and xMatters incidents between xMatters and Skylar One. The integration is bidirectional and synchronizes Skylar One and xMatters.

This SyncPack includes the following integrations:

  • Collect acknowledged or resolved incident data from xMatters, and then acknowledge or clear the corresponding Skylar One events.
  • Collect acknowledged or resolved event data from Skylar One, and then acknowledge or clear the corresponding xMatters incidents.
  • Collect event details from Skylar One 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 Skylar One event notes with on-call details.

Contents of the SyncPack

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

PowerFlow Applications

  • Bulk Resolve Skylar One Events. This application collects resolved incident data from xMatters and clears the corresponding Skylar One event. To use this application, the incident description must include the event ID.
  • Get Acknowledged Incidents and Post Data to Skylar One. This application collects acknowledged incident data from xMatters and acknowledges the corresponding Skylar One 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 Skylar One. This application collects event details from Skylar One 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 Skylar One. This application collects xMatters oncall details and populates the corresponding Skylar One event notes with oncall details.
  • Pass Acknowledgment details from Skylar One to xMatters. This application collects acknowledged event data from Skylar One 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 Skylar One 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 Skylar One. The user's email address is used by the "Pass Acknowledgment details from xMatters to Skylar One" application to match the acknowledging user in xMatters to the Skylar One 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 Skylar One 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 Skylar One events and xMatters incidents including, the default acknowledged user, whether an xMatters link should be added to the Skylar One 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 Skylar One Payloads
  • Converting Xmatters Incident Response into Skylar One Payload
  • Post Event Details To Xmatters
  • Get Acknowledger Details From XM
  • Get Acknowledgment From Skylar One And Pass to Xmatters
  • Get Acknowledged Incidents
  • Get Event Details from Skylar One Create Xmatters Alert
  • Get Resolved Incidents And Pass To Skylar One
  • Get Oncall Details from Xmatters