# Audit Trail Reporting

Track and report on changes to PagerDuty account objects

With Audit Trail Reporting, most changes to the configuration of PagerDuty account objects are tracked, attributed, and available for review and reporting. Audit Trail information helps prevent missed incidents and allows auditors to maintain internal compliance. Users have Audit Trail Reporting information available to review both at the object level and through our API.

Audit Trail Reporting is available on the following PagerDuty objects:

- [User](#user-audit-trail-reporting) 
- [Team](#team-audit-trail-reporting)
- [Escalation Policy](#escalation-policy-audit-trail-reporting)
- [Schedule](#schedule-audit-trail-reporting)
- [Service](#service-audit-trail-reporting)
- [Incident Workflow](#incident-workflow-audit-trail-reporting)  

> **Requirements:** - Audit Trail Reporting is available on the following pricing plans:
>   - Business
>   - Enterprise for Incident Management.
>   - Digital Operations (legacy)
> - All users, with the exception of Limited Stakeholders, can view Audit Trail reports. Restricted Access users will only be able to view User reports and reports for objects they have been given access to.

## Audit Trail Data

All Audit Trail reports will have an audit history page with the following parameters:

- **Date**: Date of the change.
- **Actor**: User who made the change.
- **Object**: Account object type.
- **Action**: Create, update or delete.
- **Method**: Browser, API or OAuth (mobile).
- You can view the change's full **details** by clicking the  dropdown to the right.

You may filter these results by **Last 24 Hours**, **Past Week**, **Past Month** or **Custom** date range. Users can access audit records from the last 12 months, on-demand, and at any frequency. The maximum duration you can view at once is 31 days.

![A screenshot of the PagerDuty web app showing an Audit Trail report](/images/kb/e0f5791ae975aa9e58e863a00226d685984b7311bdd13d3e1136fb2fa6be3ef8-audit_user.webp)

### User Audit Trail Reporting

In the PagerDuty web app, navigate **People**  →  **Users** and select your desired user. On their **user profile**, click **View Audit Trail Reporting** on the right of the screen.

![A screenshot of the PagerDuty web app showing how to View Audit Trail Reporting on a user profile](/images/kb/c74e5fd4bcbef697d64054c6e79a133a3fefa684a3527f52c2c72f7152a39815-audit-trails-user-view.webp)
*View User Audit Trail Reporting*

### Team Audit Trail Reporting

In the PagerDuty web app, navigate to **People**  →  **Teams** and select your desired **Team**. Click **View Audit Trail Reporting** on the right of the screen.

![A screenshot of the PagerDuty web app showing how to View Team Audit Trail Reporting](/images/kb/b79f899c86735754910a17a66ba32c483750c8b1333be8c1d3617532bcfb9836-audit-trails-teams-view.webp)

### Escalation Policy Audit Trail Reporting

In the PagerDuty web app, navigate to **People**  →  **Escalation Policies** and select your desired **Escalation Policy**. Click   →  **View Audit Report** on the right of the screen. At this time, this feature does not include changes to users or levels on escalation policies.

![A screenshot of the PagerDuty web app showing how to View Escalation Policy Audit Trail Reporting](/images/kb/212348259e80dce91afcf563544b03fa6c1aa1bee395dbafb826e7743a81aaf9-escalation_policy.webp)

### Schedule Audit Trail Reporting

In the PagerDuty web app, navigate to **People**  →  **Schedules** and select your desired **Schedule**. Click **View Audit Trail Reporting** on the right of the screen. At this time, this feature does not include details about overrides or users being added or removed from schedules. For a closer look at the before and after versions of a schedule, please refer to our documentation on our [revert schedule](/incident-management/schedules/edit-schedules#restore-a-schedule-to-a-previous-version) feature.

![A screenshot of the PagerDuty web app showing how to View Schedule Audit Trail Reporting](/images/kb/e0e0960198263bca3145ad24d40dc1e92ce2b33a8281de7a9cc7c4dcbcfa3d30-audit_schedule.webp)

### Service Audit Trail Reporting

In the PagerDuty web app, navigate to **Services**  →  **Service Directory** and select your desired **Service**. Click **More** on the right of the screen and select **View Audit Trail Reporting**.

![A screenshot of the PagerDuty web app showing how to View Service Audit Trail Reporting](/images/kb/db6607fdcf13ad18a61d9e750024458e530076cbca5673dc0e790c10c552294d-audit-trail-reporting-service-view.webp)

> **Limitations:** Audit Trail Reporting does not capture the following actions related to services:
>
> - Adding and removing extensions and integrations
> - Disabling services
> - [Maintenance Windows](/incident-management/services/maintenance-windows)

### Incident Workflow Audit Trail Reporting

In the PagerDuty web app, navigate to **Automation**  →  **Incident Workflows**, click the  dropdown to the right of your preferred Workflow, and select **View Audit Trail Reporting**.

![A screenshot of the PagerDuty web app showing how to View Incident Workflow Audit Trail Reporting](/images/kb/1dbf9aa5e0285efe72e96bdd62bd856c0004bdb7aae6129022693ca2bfb6c4a4-audit-trail-reporting-incident-workflows.webp)

## Audit Trail Reporting API

For more information on advanced usage of Audit Trail Reporting, please visit our developer documentation, [List audit records](/developer/api/reference/rest/audit/list-audit-records).