Drive audit log
This feature is available with G Suite Business, Education, and Enterprise editions. Compare editions
As a G Suite administrator, you can use the Drive audit log to collect and see a list of your domain's user activity; for example, view, create, preview, print, update, delete, download, or share Drive content. The Drive audit log includes content your users create in Google Docs, Sheets, Slides, and other G Suite applications, as well as content created elsewhere that your users upload to Drive, such as PDFs and Word® files.
Domains with any version of G Suite can use the Activity API to programmatically access basic G Suite reports data, while domains with G Suite Business or G Suite Business can use a new Reports API to access advanced G Suite reports data.
Step 1: Open your Drive audit log
-
Sign in to your Google Admin console.
Sign in using your administrator account (does not end in @gmail.com).
-
From the Admin console dashboard, go to Reports.
To see Reports, you might have to click More controls at the bottom.
- Click Drive.
- On the toolbar, click Select columns
. Then select the data you want to show in your log.
- See below for how to interpret and customize log data.
. Then select the data you want to show in your log. Step 2: Understand Drive audit log data
Data you can viewThe Admin console bases its Drive audit logs on the following user data:
| Data Type | Description | Filtering within the Admin Console |
|---|---|---|
| Event name | User action, such as View, Rename, Create, Edit, Preview, Print, Update, Delete, Download, or Share.
When you copy files, the type of action logged depends on the file type:
Preview events in the Drive viewer and Print events in the Drive viewer and the Google Docs editors may be delayed up to 12 hours from the time of the event. Viewing Trash on a Team Drive is not logged. Change Theme on a Team Drive is not logged. Print events may show as Download events when printing files with the Drive application from iOS® or Android devices or when printing Google Slides or Sheets with the Drive web UI. Google Docs and Google Forms printed from the Drive web UI are not logged. Downloads from the following sources are not logged:
|
Filterable |
| Event description | Summary of the event, such as "Larry created an item." | Not filterable |
| Item type | File format that the activity involves, such as Google Docs, Sheets, Slides, JPEG, PDF, PNG, MP4, Microsoft® Word®, Excel®, PowerPoint®, txt, HTML, MPEG audio, QuickTime® video, folder, or Team Drive. | Filterable |
| Item ID | Unique Drive item identifier associated with the activity, as stored in the URL link for the file. | Filterable |
| Visibility | Visibility of the Drive item associated with the activity. | Filterable |
| Prior Visibility | Visibility of the Drive item prior to the activity. | Filterable |
| User | Email address of the user who performed the activity. Users external to the domain who initiate events are shown as anonymous, except when they view or edit a document explicitly shared with them (as an individual or as part of a specific group). | Filterable; also works if only the domain name is entered |
| Owner | User who owns the file. | Filterable |
| Date and time range | Date and time the event occurred (displayed in your browser's default time zone). | Filterable |
| IP address | Address from where the user performed the activity. This might reflect the user's physical location, but it can be something else like a proxy server or a Virtual Private Network (VPN) address.
No IP addresses are logged for events initiated by users external to the domain or for events from services that don't log the IP address in their requests. |
Not filterable |
Step 3: Customize and export your audit log data
Filter the audit log data by user or activity
You can narrow your audit log to show specific events or users. For example, find all log events for when users updated or deleted a Drive file, or find all Sheets activity for a particular user.
- Open your Drive audit log as shown above.
- If you don't see the Filters section, click Filter
.
- Enter or select the criteria for your filter. You can filter on any combination of the data you can view in the log. You can also filter on Item Visibility Change: External, Internal, or None.
- Click Search.
.Export your audit log data
You can export your Drive audit log data to a Google Sheet, or download it to a CSV file.
- Open your Drive audit log as shown above.
- (Optional) To change the data to include in your export, on the toolbar, click Select columns
- (Optional) Click the box next to each column with data you want to export, and click Apply.
- On the toolbar, click Download
.
.You can export up to 210,000 cells. The maximum number of rows depends on the number of columns you select. Exported Google Sheets and downloaded CSV files both show a maximum of 10,000 rows.
How old is the data I'm seeing?
For details on exactly when data becomes available and how long it's retained, see Data retention and lag times.
Step 4: Set up email alerts
You can easily track specific Drive activities by setting up alerts. For example, get an alert whenever someone creates or deletes a document.
- Open your Drive audit log as shown above.
- If you don't see the Filters section, click Filter
- Enter or select the criteria for your filter. To set up an alert, you can filter on any combination of the data you can view in the log except date and time range.
- Click Set Alert.
- In the Set alert: Drive box, enter a name for the alert.
- Check the box to deliver the alert to in your super administrator account.
- Enter the email addresses of any other alert recipients.
- Click Save.
To edit your custom alerts, see Administrator email alerts.
