Audit Log
- Last UpdatedOct 23, 2026
- 4 minute read
Use the audit log to trace any unauthorized, accidental, or adverse changes to your displays and folders, and to generally maintain oversight of PI Vision. The audit log provides a history of change events for your displays and folders, capturing each instance when displays and folders were created, modified, and deleted. It provides the date and time when each change occurred, the user who made each change, and a description of the specific changes that were made.
If you use data entry or value entry symbols to allow users to manually enter data in PI Vision, the audit log lists each instance when data was manually entered. Also, actions from a display's revision history are logged, such as when a user restores a previous version or when a previous version of the display is deleted.
If a user made unwanted changes to displays or folders, keep in mind:
-
If a display was deleted in PI Vision (but not permanently deleted), it can be recovered from the Recycle Bin.
-
If unwanted modifications were made to a display, you can go to the display's revision history to roll it back to a previous version, based on the number of previous revisions that PI Vision is configured to save.
-
To prevent future issues, you can adjust display permissions and folder permissions to restrict users from modifying displays and folders.
Enable or disable audit logging
Audit logging is enabled by default, but you can disable it if desired. While audit log records consume only modest amounts of database space, you might disable audit logging if you want to keep database growth to a minimum.
If you disable audit logging, audit log records that were generated before you disabled audit logging are retained, unless you delete them by following the steps for deleting audit log records.
Note: If you enable or disable audit logging, that event appears in both the audit log and in Windows Event Viewer for additional traceability. In Windows Event Viewer, these events appear under OSIsoft-PIVisualization > Admin.
-
Open the PI Vision Administration website.
-
In the menu, select Audit Log.
-
To enable audit logging, select Enable audit logging for PI Vision.
To disable audit logging, unselect Enable audit logging for PI Vision.
-
Select Save.
PI Vision starts or stops logging audit records shortly after you select Save.
Generate an audit log
Follow the steps below to generate an audit log. Data appears in audit logs only for time periods when audit logging was enabled.
-
Open the PI Vision Administration website.
-
In the menu, select Audit Log.
-
Under Export audit log entries for a specific date range, specify the time range that you want the audit log to include.
-
Select Export.
-
The audit log .csv file is downloaded. You can open and analyze the file locally with spreadsheet software.
In the audit log, each audit log event appears on a row with the following columns:
|
Column Name |
Description |
|---|---|
|
Date |
The date and time when the change occurred. |
|
User |
The user who made the change. |
|
Action |
The type of change that occurred, for example DisplayCreated, DisplayDeleted, DisplayPermanentlyDeleted, or FolderPermissionsChanged. |
|
Source |
The application that was used to make the change. The possible sources are: Web - The change was made in the PI Vision application. Utility - The change was made in the Display Utility or by an API. Admin - The change was made in the Administration website. Change events from the Administration website that appear in audit logs include instances when audit logging is enabled or disabled and instances when audit log records are deleted. |
|
Display or Folder ID |
The ID of the display or folder that was affected by the change. To access a display or folder by its ID, insert the ID into a PI Vision URL. Note: Deleted displays in the Recycle Bin are not retrievable by using a URL, but they can be recovered by manually locating them in the Recycle Bin. Permanently deleted displays and deleted folders are not retrievable by any means. |
|
Additional Information |
Details about the specific change that occurred. For example, if a display's permissions were changed, the display's previous permissions and new permissions appear in this column. |
Delete audit log records
You can delete historical audit log records to reduce the amount of storage space that is consumed by your database.
Note: If you delete audit log records, that event appears in both the audit log and in Windows Event Viewer for additional traceability. In Windows Event Viewer, these events appear under OSIsoft-PIVisualization > Admin.
-
Open the PI Vision Administration website.
-
In the menu, select Audit Log.
-
In the Remove audit records before this date field, enter the date that you want to delete all change event records before.
-
Select I understand this operation cannot be undone.
-
Select Delete Audit Records.