Change Events

Change events represent service changes such as deploys, build completion, configuration updates, etc., providing contextual information that is critical during incident triage or hypercare. They can be sent via specific integrations or API, and they do not create alerts, incidents or notifications. See the View Change Events section below for a list of places where change events are surfaced in PagerDuty.

Configure an Integration to Send Change Events

Change events can be sent via our change events integrations, which you can find in our integrations library, filtering the Category by Change:

You may follow the instructions in these integration guides to configure, or you can add them via the Recent Changes page.

Configure Integration via the Recent Changes Page

  1. Navigate to Incidents Recent Changes and click + New Change Integration to the right.
  2. Choose one of two options:
  • PagerDuty Integrations: If you would like to select a prebuilt integration, select your preferred vendor.
  • PagerDuty Events API: Select this option if you would like to create custom change events with the PagerDuty Events API.
  1. Select a service that you would like to add the integration to and click Next.
  2. On the next modal screen, copy your Integration Key and click View Documentation to see how to use the integration key to configure the rest of the integration.

Send Change Events via the Events API

You may also send change events to integrations via the Events API v2.

View the Events API v2 Overview for guidance on when to send a change event instead of an alert event. You can send both event types using a single Events API v2 integration key.

A Custom Change Event Transformer is also available that allows you to reliably convert a payload sent by integrations to a payload understood by PagerDuty as a change event.

View Change Events

View Change Events on a Service

Navigate to Services Service Directory and click the title of the integrated service. Under Recent Activity you will see change events labeled as RECENT CHANGE in grey in the timeline:

View Most Recent Change Events on an Incident

Navigate to an incident on a service with the above integration configured. Click the incident’s Title and you will see a section with the most recent changes in the last 24 hours, with the option to View All on the right.

If there have been no recent changes, this section will read No recent changes on this service in the last 24 hours.

View and Filter All Change Events Across Services

To view and filter all change events across all services, navigate to Incidents Recent Changes. You may filter by Team, Service, integration Type and Last Changed time period.

View Change Event Details

To view a change event's details, click the change event's title and you will see the Service, Type, Timestamp, Summary, Source and Links to view the pull request, the integrated repository and the user's profile.

FAQ

Is it possible to modify change events using event rules?

Not at this time, but we are interested to learn about what you would like to accomplish, please contact our Support team with your use cases and feedback.

Are change events viewable in Slack or the mobile app?

Not at this time, but we would like to hear your feedback, please contact our Support team.

Can change events be sent to a global integration key?

Not at this time. Change events must be sent to a service-specific integration key.

Is it possible to send change events to PagerDuty from applications that are not listed as a pre-built change event integration?

Yes, you can send change events to integrations via the Events API v2. A Custom Change Event Transformer is also available that allows you to reliably convert a payload sent by integrations to a payload understood by PagerDuty as a change event.

Updated 4 days ago


Change Events


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.