Introduction to the Jenkins SyncPack

Download this manual as a PDF file 

This section describes how you can use the "Jenkins" SyncPack to configure a bidirectional integration between SL1 events and Jenkins jobs, pipeline jobs, and nodes.

This SyncPack uses the "Jenkins Automation" PowerPack.

How Can I Use this SyncPack?

The "Jenkins"  SyncPack includes a configuration object, applications, and steps that bidirectionally sync jobs, pipeline jobs, and node status between Jenkins and SL1.

This SyncPack includes the following applications:

  • Create External Notes For SL1 Event. This application queries Jenkins for job information to be added to the associated SL1 event.
  • Create Event In SL1 For Jenkins Job Run. This application creates an SL1 event when a Jenkins job fails.
  • Create Event In SL1 For Jenkins Node Status. This application creates an SL1 event when a node is offline in Jenkins.
  • Create Event In SL1 For Jenkins Pipeline Job Run. This application creates an SL1 event when a Jenkins pipeline job fails.
  • Update SL1 Event Triggered. This application updates an SL1 event with Jenkins job information.
  • Trigger Event In SL1. This application creates an SL1 event when an SL1 event reaches a major severity threshold.
  • Create Virtual Device In SL1 For Jenkins Jobs And Nodes. This application creates a virtual device in SL1 that is used to identify Jenkins jobs and nodes.

Contents of the SyncPack

This section lists the contents of the Jenkins SyncPack.

PowerFlow Applications

  • Create External Notes For SL1 Event. This application queries Jenkins for job information to be added to the associated SL1 event.
  • Create Event In SL1 For Jenkins Job Run. This application creates an SL1 event when a Jenkins job fails.
  • Create Event In SL1 For Jenkins Node Status. This application creates an SL1 event when a node is offline in Jenkins.
  • Create Event In SL1 For Jenkins Pipeline Job Run. This application creates an SL1 event when a Jenkins pipeline job fails.
  • Update SL1 Event Triggered. This application updates an SL1 event with Jenkins job information.
  • Trigger Event In SL1. This application creates an SL1 event when an SL1 event reaches a major severity threshold.
  • Create Virtual Device In SL1 For Jenkins Jobs And Nodes. This application creates a virtual device in SL1 that is used to identify Jenkins jobs and nodes.

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

Configuration Object

  • Base Jenkins Configuration. 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 SL1, including the host, username, and password.
  • Details for connecting to Jenkins, including the URL, username, and password.
  • Details for notifications including the sender and receiving email, password, server, and port.
  • Details for connecting to Jenkins devices including device ID, collector group ID, and device class ID.

Steps

The following steps are included in this SyncPack:

  • Build Jenkins Job
  • Build Jenkins Job From SL1 Event
  • Build Jenkins Pipeline Job
  • Create Jenkins Virtual Devices On SL1
  • Create SL1 Alert
  • Create Virtual Device
  • Get Event Details From SL1
  • Get Jenkins Nodes Status
  • Get List Of Existing Virtual Devices Of Nodes
  • Get Virtual Device
  • Post Update To SL1
  • Read Cache
  • Update Jenkins Details To SL1
  • Update SL1 Event of Jenkins Build Job