Jenkins

Send change data from Jenkins to suggest potential root cause for BigPanda incidents.

Supported VersionsTypeAuthentication Type
1.546 - 2.375.1Native PluginUser API Key

The BigPanda-Jenkins global notifier hooks into the Jenkins build process, triggering the Jenkins instance on every build. Once the build starts, the active change is sent to BigPanda and becomes available for correlation with incidents. When the build is finished, the change data in BigPanda is updated to reflect the completed change.

Key Features

  • Notifies BigPanda about Jenkins builds, capturing Shadow Changes from your CI.
  • Intelligently correlates system changes from Jenkins with high-level incidents in BigPanda to expedite the Root Cause Analysis (RCA) process and reduce Mean Time To Repair (MTTR).
  • Tracks build progress, keeping the change information in BigPanda up to date.

Data Models

BigPanda converts and organizes build information from Jenkins into tags.

Standard Jenkins Methods

Below are the methods being leveraged to populate the needed Changes tags

MethodChange TagDescription
getFullDisplayName() + getStartTimeInMillis()identifierThe unique identifier for the change.
getStartTimeInMillis()startThe build start time. This is transformed into seconds prior to being sent to BigPanda.
getFullDisplayName()summaryThe full name of the build.
getDurantion()endThe build end time calculated against the start time.
getCauses()causesA potential array of build triggers.
getDescription()description(Optional) This tag is populated if a description of the build is provided.

📘

Extra tags

Tags such as causes and description are added to the tags property within the Change Object.

Install the Integration

Administrators can install the integration by following the on-screen instructions in BigPanda.

🚧

Webhook URL

This additional field in the configuration has a default endpoint that makes sure the data reached the BigPanda console.

Consult with BigPanda before updating this field for a custom solution.

Before You Integrate

Before installing the Jenkins integration, ensure that you have done the following:

  • Obtain admin access to Jenkins
  • Create a BigPanda API Key and save the key
  • Create a Jenkins Integration. and save the app key

Uninstall the Integration

Deleting an integration requires changes to both the integrated system and BigPanda. You must uninstall the integration on the integrated system and then delete the integration from BigPanda.

🚧

When replacing an existing integration with a new tool or system, we recommend configuring the new integration first to ensure no data is lost.

Stop Sending Data to BigPanda

On the integrated system, disable any settings that send data to BigPanda.

  • You can uninstall the plugin by navigating to Manage Jenkins > Manage Plugins.
  • From the Installed tab, you can select the Uninstall button for the BigPanda Notifier plugin.

Manually resolve any open alerts sent from the integration to remove the associated incidents from your incident feed. These incidents will not automatically resolve without an ok status from the original sending integration.

Delete the Integration from BigPanda

  1. In BigPanda, navigate to the Integrations tab and select the desired integration from the list.
  2. In the integration details on the right, click Delete Integration. A support message opens, pre-populated with a request to delete the selected integration.
  3. Press Enter to send the request.
  4. The BigPanda support team will remove the integration from the UI.

This procedure does not remove any data from BigPanda or the integrated system. As needed, remove data from each system before deleting the integration.