# Recent Changes

Send change events to provide context on recent service changes

Change events represent service changes such as deploys, build completion, configuration updates, etc. This information can prove critical during incident triage or hypercare, when a system or product has recently launched. You can send change events via product-specific integrations or directly to the [Events API](/developer/api/reference/events-v2/send-change-event/create-change-event). Change events do not create alerts, incidents or notifications.

> **AIOps / Signal Intelligence Feature:** This feature is included with the [PagerDuty AIOps](/ai-automation/aiops/overview) add-on, or included as Signal Intelligence in PD Reliability Platform plans. To sign up for a trial of PagerDuty AIOps features, read [PagerDuty AIOps Trials](/ai-automation/aiops/overview#pagerduty-aiops-trials).

> **AIOps Service Configuration:** Your service configuration must have AIOps enabled to use this feature. AIOps Service Configuration is in Limited General Availability — see [Configurable Service Settings](/incident-management/services/configurable-service-settings#manage-aiops) for more information and enablement steps.

## Configure an Integration to Send Change Events

There are a number of integrated tools which support sending change events to PagerDuty. You can find these in our [integrations library](/integrations) by selecting the **CI/CD and Change** filter:

![Select "CI/CD and Change"](/images/kb/02333c75f7bde22c509294271eeb3060b95cfd21b6aa1ab828f8eb34b89ce968-select_CICD.webp)

Select your preferred guide and follow the setup instructions to complete the integration.

## Configure Integration via the Recent Changes Page

You can also add an integration on the **Recent Changes** page:

1. Navigate to **AIOps**  →  **Recent Changes** and click **New Change Integration**.
2. Choose one of the following options:

- **PagerDuty Integrations**: Select your preferred vendor from the **Select a vendor** dropdown.

- **PagerDuty Events API**: Select this option to create custom change events with the [PagerDuty Events API](/developer/custom-change-event-transformer).

3. Enter an **Integration Name** (_optional_), select a service from the dropdown, and click **Next**.
4. In the modal, copy the integration key. Click **View documentation** to see [Send a Change Event](/developer/api/reference/events-v2/send-change-event/create-change-event) documentation from our developer docs.
5. Click **View Integration** to see the integration on the service you selected, or **Done** to close the modal.

![A screenshot of the PagerDuty web app showing a change events integration key and links to documentation](/images/kb/38a357e7d4beafa12d0798cf55262b4dd9fdbf61d92a530a65fa01bd8de4a30c-configure_recent_changes.webp)
*Configure recent changes*

## Send Change Events via Events API

You can send change events [via the Events API v2](/developer/api/reference/events-v2/send-change-event/create-change-event). The [Events API v2 Overview](/developer/events-api-v2-overview#change-events) offers guidance on when to send a change event instead of an alert event. You can send both event types using the same Events API v2 integration key; what differs is the endpoint:

- **Alert events endpoint**: `https://events.pagerduty.com/v2/enqueue`
- **Change events endpoint**: `https://events.pagerduty.com/v2/change/enqueue`

## Send Change Events via Custom Change Event Transformer

You can also use a [Custom Change Event Transformer](/developer/custom-change-event-transformer) to reliably convert the payload that integrations send into a format that PagerDuty can understand as a change event. 

## View Change Events in the Web App

### View and Filter Change Events Across All Services

To view and filter change events across all services:

1. Navigate to **AIOps**  →  **Recent Changes**. 
2. Optionally filter by **Team**, **Service**, integration **Type** and **Last Changed** time range. 

![A screenshot of the PagerDuty web app showing changes events](/images/kb/32b568b45ce9e8c03fb4ce03043f1ea61f81df8eedacd9372adc6fa4f0e55ea4-recent_changes_web_app.webp)
*Changes events*

> **Time Range:** This table will not display change events that happened more than 90 days in the past.

### View Change Events on a Service

1. Navigate to **Services**  →  **Service Directory** and click the **title** of the integrated service.
2. The **Recent Changes** table displays a list of change events.

### View Change Event Details

To view a change event's details, click the change event's **title**. The detail view displays information that was included in the change event request body, for example, the **Service**, **Type**, **Timestamp**, **Summary**, **Source** and **Links** (e.g., to the pull request, the integrated repository and the user's profile).

The **Custom Details** section displays any additional information that was included in the event's `payload.custom_details` parameter. You can select from two display formats as needed: **Formatted** or **Raw**.

![A screenshot of the PagerDuty web app showing a change event's details](/images/kb/193b4eed32d9a4fa7c5cdb0af5dcbb562e174fba52d9470fe5d1de2361b17401-change_event_details.webp)
*Change event details*

## View Change Events in the Mobile App

Change events are available in two areas of the mobile app: 

- [Incident Detail](/ai-automation/aiops/recent-changes#incident-detail)
- [Service Detail](/ai-automation/aiops/recent-changes#service-detail)

### Incident Detail

To view change events on an incident’s detail screen, tap your desired **incident** and scroll to the **Change Events** section. A maximum of two recent changes are displayed. Tap **View Change Event(s)** to view a list of all change events, or tap **** to the right of a specific change event's title to view more details about the change event. 

The change event detail area will include **Change Correlations**. For more information, please read the section [Change Correlation](#change-correlation) below.

![A screenshot of the PagerDuty mobile app showing a Change Correlation on an incident](/images/kb/b23d896f6df278ba54101ec7b6091d6dd6e1c6cadfdab79eca953ae813eba6f8-Change_correlation.webp)

### Service Detail

To view change events on a service, navigate **Services**, select your desired service and scroll to the **Change Events** section. A maximum of two recent changes are displayed. Tap **** to the right of the change event title to view details about the change event.

## Change Correlation

Change correlation provides responders with recent change events that are most relevant to an incident. Once you have configured change event integrations, no specific setup is required to start seeing change correlations on incidents. Each change event will have context as to why it was correlated based on three factors: time, related service or intelligence (i.e., machine learning). With valuable context available at a glance, responders can triage incidents quickly and reduce time-to-resolution.

To extract the most value from related service change correlations, ensure that your [business and technical services dependencies](/incident-management/services/service-profile#service-dependencies-tab) are configured properly. Regarding intelligent correlation, the more change event data you send across your services, the more data the learning model will have to analyze and draw correlations between past change events and current incidents.

### View Change Correlations

1. Navigate to an incident and click its **Title** to view the details page.
2. The **Recent Changes** section displays up to three recent change correlations from the past 24 hours, as well as a correlation reason.

![Change correlations](/images/kb/6931a11afc81b1e36e714fb7e412e79d140aefc96120d81d935866e72cd32a4b-change-correlation-overview.webp)

### Time-Based Change Correlation

Time-based change correlations indicate that change events occurred on the service within the past 24 hours. You can identify a time-based correlation by viewing the context under the change event title:

 `This incident occurred X minutes/hours after this change`

![Time-Based Change Correlation](/images/kb/bb1d56aa52e4f5c882ce0ac9798eeb36efd4debed52d1b4c04373bf01e563cb4-change-correlation-time-based.webp)

### Related Service Change Correlation

Both business services and technical services may appear as a related service change correlation. You can identify a related service correlation by viewing the context under the change event title:

 `This change occurred on a service related to [THIS INCIDENT’S SERVICE NAME]`

![Related Service Change Correlation](/images/kb/800171c7317e8c4002a38a070ff05aafd2018dbfb7d4e72e6bf3d8f49fc7223f-change-correlation-service-based.webp)

### Intelligent Change Correlation

Intelligent change correlations (machine learning) are determined by three main factors:

- How close in time the previous incidents and change events occurred.
- How related are the change event and incident metadata.
- The frequency that a particular change event and incident occurred.

You can identify an intelligent change correlation by viewing the context under the change event title:

  `Similar incidents have previously occurred with changes like this`

![Intelligent Change Correlation](/images/kb/412afa4915494feb1b65f154a8e30c08f8446c3798ffaada50961b766660de97-change-correlation-intelligent.webp)

### Change Correlation via API

To access change correlation via API, please [visit our API documentation](/developer/api/reference/rest/change-events/list-change-events).

## FAQ

**Is it possible to modify change events using Event Orchestration?**

Not at this time. We’d be interested to learn about what you would like to accomplish. Please [contact our Support team](https://www.pagerduty.com/contact-us/#contact-support) with your use case and any feedback.

**Can change events be sent to a global integration key?**

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