PagerDuty SyncPack Release Notes, version 1.0.1

Version 1.0.1 of the "PagerDuty" SyncPack removes and replaces some applications, and addresses various application and step issues included in the SyncPack.

This SyncPack uses the "PagerDuty Incident Integration" PowerPack.

Issues Addressed in this Release

The following issues were addressed in this release:

  • The "Get alert data and alert count from PagerDuty" and "Get user details from PagerDuty and ScienceLogic" applications were removed from the SyncPack and the "Get alert and user data from PagerDuty and ScienceLogic" application was added.
  • An issue was addressed that was causing a 404 error when a user clicked on a PagerDuty incident ID in Skylar One.
  • An issue was addressed that was causing an exception in the applications included in the SyncPack if the input for the "Sl1_host" parameter did not include "https://". The applications will now perform as expected whether or not a user inputs "https://" in the "Sl1_host" parameter.
  • An issue was addressed in which the format for an event log collected from PagerDuty was causing a match failure when Skylar One created and sent an associated event to PagerDuty.
  • An issue was addressed in which the "Get PagerDuty log and incident data" application was not correctly updating the log entry timestamp when the application was run multiple times.
  • An issue was addressed in which an exception was occurring in the "Get Incident and User Data" step if there were no acknowledged incidents in PagerDuty.

Features

The following applications are included in this SyncPack:

  • Create Event in PagerDuty from Skylar One Event. This application sends Skylar One event information to PagerDuty. The application translates and formats the event data from Skylar One so that it can be consumed by PagerDuty to create a PagerDuty incident.
  • Get PagerDuty log and incident data. This application queries the PagerDuty API to collect log entries and incident data. The collected entries are formatted and passed to subordinate applications that process the data to update, acknowledge, and clear events in Skylar One.
  • Clear resolve event from ScienceLogic. This application clears an event in Skylar One that was resolved in PagerDuty. This application is called by the "Create resolve alert data from PagerDuty" application for each event that needs to be cleared.
  • Get resolve alert data from PagerDuty. This application is called by the "Get PagerDuty log and incident data" application to process log messages that indicate that an incident has been resolved. This application queries the PagerDuty API for the alerts associated with the resolved incidents. If the alert was triggered from an Skylar One event, the application calls the "Clear resolve event from ScienceLogic" application to clear the event.
  • Get trigger alert data from PagerDuty. This application is called by the "Get PagerDuty log and incident data" application to process log messages that indicate that an incident has been triggered. This application queries the PagerDuty API for the alerts associated with those triggered incidents. If the alert was triggered from an Skylar One event, the application calls the "Post event updates to ScienceLogic" application to add the incident ID to the event.
  • Get alert and user data from PagerDuty and ScienceLogic.This application is called by the "Get PagerDuty log and incident data" application to process log messages that indicate that an incident has been acknowledged. This application queries the PagerDuty API for the alerts associated with acknowledged incidents. If the alert was triggered from an SL1 event, the application updates the SL1 event so that the acknowledgment matches PagerDuty. This application also determines the date of the most recently processed alert and stores that value to be used by the next execution of the "Get PagerDuty log and incident data" application.
  • Post event updates to ScienceLogic. This application updates Skylar One events using the data collected from the PagerDuty API.

The following configuration object is included in the SyncPack:

  • PagerDuty Base Config. This configuration object can be used as a template after the SyncPack is installed on the Skylar Automation system. The configuration object includes the following:
    • Details for connecting to the Skylar One API, including the hostname or IP address, username, and password
    • Details for connecting to the PagerDuty API, including the URL and integration key
    • Details for connecting to the PagerDuty REST API, including the URL and API key
    • Details for connecting to the HTTP Proxy when communicating with PagerDuty, including the hostname or IP address, username, and password
    • An optional identifier that appends the event ID to create a PagerDuty dedup key. This can be used to avoid routing key collisions when multiple Skylar One platforms connect to the same PagerDuty instance.
    • Mapping between Skylar One events and PagerDuty incidents including, event summary formats, event data, and indictations to resolve or link incidents between Skylar One and PagerDuty

The following steps are included in this SyncPack:

  • Acknowledge the alert by user
  • Check for since parameter after Query
  • Check conditional
  • Get alert count and acknowledge the alert by user
  • Get incident and user data
  • Get resolve incident data
  • Get trigger incident data
  • Get user email from user details
  • Convert ScienceLogic event data to PagerDuty event

To view the latest manuals for the Skylar Automation (formerly Skylar Automation) Platform, see the Skylar Automation  page. To view the latest release notes for Skylar Automation, see Skylar Automation Release Notes.

System Requirements

Version 1.0.1 of the "PagerDuty" SyncPack requires:

  • SL1 Skylar Automation platform version 2.4.0 or later.
  • Skylar One version 11.2.0 or later. For details on upgrading Skylar One, see the relevant SL1 Platform Release Notes.
  • "PagerDuty Incident Integration" PowerPack version 100 or later.

The following table lists the port access required by the Skylar Automation platform and this SyncPack:

Source IP Skylar Automation Destination Skylar Automation Source Port Destination Port Requirement
Skylar Automation Skylar One API Any TCP 443 Skylar One API Access
Skylar Automation PagerDuty API Any TCP 443 PagerDuty API Access
Skylar Automation Skylar One Database Any TCP 7706 Skylar One Database Access

Installing or Upgrading the SyncPack

A SyncPack file has the .whl file extension type. You can download the SyncPack file from the ScienceLogic Support Center.

To locate and download the SyncPack:

  1. Go to the ScienceLogic Support Center at https://support.sciencelogic.com/s/.
  2. Click the Skylar Automation tab and select SyncPacks.
  3. In the Search field, type the name of this SyncPack and select it from the search results. The Release Version page appears.
  4. On the Files tab, click the down arrow next to the SyncPack version that you want to install, and select Show File Details. The Release File Details page appears.
  5. Click the Download File button to download the SyncPack.

After you download a SyncPack, you can import it to the Skylar Automation (formerly Skylar Automation) platform using the Skylar Automation user interface.

To import a SyncPack in the Skylar Automation user interface:

  1. On the SyncPacks page, click Import SyncPack. The Import SyncPack page appears.
  2. Click Browse and select the .whl file for the SyncPack you want to install. You can also drag and drop a .whl file to the Import SyncPack page.
  3. Click Import. Skylar Automation registers and uploads the SyncPack. The SyncPack is added to the SyncPacks page.

You cannot edit the content package in a SyncPack published by ScienceLogic. You must make a copy of a ScienceLogic SyncPack and save your changes to the new SyncPack to prevent overwriting any information in the original SyncPack when upgrading.

To activate and install a SyncPack in the Skylar Automation user interface:

  1. On the SyncPacks page, click the Actions button () for the SyncPack you want to install and select Activate & Install. The Activate & Install SyncPack modal appears.

    If you try to activate and install a SyncPack that is already activated and installed, you can choose to "force" installation across all the nodes in the Skylar Automation system.

    If you do not see the SyncPack that you want to install, click the Filter icon () on the SyncPacks page and select Toggle Inactive SyncPacks to see a list of the imported SyncPacks.

  1. Click Yes to confirm the activation and installation. When the SyncPack is activated, the SyncPacks page displays a green check mark icon for that SyncPack. If the activation or installation failed, then a red exclamation mark icon appears.
  2. For more information about the activation and installation process, click the check mark icon or the exclamation mark icon in the Activated column for that SyncPack. For a successful installation, the "Activate & Install SyncPack" Skylar Automation application appears, and you can view the Step Log for the steps. For a failed installation, the Error Logs window appears.
  3. If you have other versions of the same SyncPack on your Skylar Automation system, you can click the Actions button () for that SyncPack and select Change active version to activate a different version other than the version that is currently running.