ID: pagerduty

Gitter Jenkins Plugin GitHub release Jenkins Plugin Installs

About this plugin

Allows users to send Change Events and trigger postbuild Incidents via PagerDuty


  • Support for PagerDuty Change Events API
  • Trigger incidents on various job statuses Success/Failure/Aborted/Unstable/Not_Built
  • Trigger incidents based on number of consecutive build results
  • Automatically Resolve incidents when job is back to normal
  • Pipeline compatible
  • TokenMacro consumer (TokenMacro - adds reusable macro expansion capability)



Getting Started

Before you can use this plugin you'll need an integration key (also known as a routing key). This key tells PagerDuty which service the incoming event should be sent to. If you already have a service in PagerDuty you can add an integration to it; otherwise, you can add the integration when creating a new service. For the integration type, choose "Jenkins CI".

Once you have an integration key you can add the appropriate action to your Jenkins project and supply it with the integration key. Be sure to select which job results you want to send an event to PagerDuty.


Trigger/Resolve Incidents

PLEASE NOTE - routing key and integration key are the same thing!

pagerduty(resolve: false, routingKey: "$ROUTING_KEY [NOT NULL]", dedupKey:"$DEDUP_KEY", incidentSummary:"$INCIDENT_SUMMARY", incidentSource: "$INCIDENT_SOURCE", incidentSeverity:"$INCIDENT_SEVERITY", incidentComponent:"$INCIDENT_COMPONENT", incidentGroup:"$INCIDENT_GROUP", incidentClass:"$INCIDENT_CLASS")

if resolve == false, pagerduty triggers an incident and returns the incidentKey

Change Events

pagerdutyChangeEvent(integrationKey: '$INTEGRATION_KEY')

You can choose one (or both) of the options to use PagerDuty

trigger options

Trigger/Resolve Incidents

Using the "PagerDuty Incident Trigger" action, you can trigger or resolve incidents based on the results of a job.

trigger options

Create Change Events

Using the "PagerDuty Change Events" action, you can create a change event when a job completes.

trigger options

Version History

Version 0.6.2 (Jan 03, 2021)

  • Documentation Fix
  • Bug Fixes (Resolves JENKINS-64485 and #43)

Version 0.6.1 (Dec 08, 2020)

  • Add Change Events support (thanks Adam Vaughan!)
  • Bug fixes
  • Remove Jetty dependency from pom
  • Move docs to Github

Version 0.6.0 (Dec 06, 2020)

  • Add Change Events support (thanks Adam Vaughan!)
  • Bug fixes

Version 0.4.1 (Mar 12, 2019)

  • Add TokenMacro support
  • Bug fixes
  • Code refactor

Version 0.3.0 (Jan 31, 2017)

  • Pipeline compatible
  • Code refactor

Version 0.2.6 (June 20, 2017)

  • Bug fixes
  • PagerDuty v2 compatibility (migrating from square PD utility to dikhan's PD client)

Version 0.2.5 (March 10, 2017)

  • Bug fixes

Version 0.2.4 (March 30, 2016)

  • Allow automatic resolution of the incident on BACK-TO-NORMAL (from not success to success)

Version 0.2.3 (March 09, 2016)

  • Bug fixes

Version 0.2.2 (January 03, 2016)

  • Allow triggering alert in all job statuses (SUCCESS/FAILED/ABORTED/UNSTABLE/NOT_BUILT)
  • Allow using multiple service keys for different job

Version 0.2.1 (December 08, 2015)

  • Allow using Environment Variables for config

Version 0.2.0 (September 26, 2015)

  • Initial public release

ArchivesGet past versions
Version: 0.6.2
Requires Jenkins 2.190.1
Installs: 915
Alexander Leibzon
Help us improve this page!
To propose a change submit a pull request to the plugin page on GitHub.