Duet AI is now Gemini for Google Workspace. Learn more

Directory Sync log events

Audit and investigation page: View activity related to Directory Sync
The audit log page has been replaced with a new audit and investigation page. For information about this change, go to Improved audit and investigation experience: What's new in Google Workspace

You can use the audit and investigation page to run searches related to Directory Sync log events. There you can view a record of actions to see events related to Directory Sync.

For a full list of services and activities that you can investigate, such as Google Drive or user activity, read through the About the audit and investigation tool.

Open the audit and investigation page

Access Directory Sync log event data

  1. Sign in to your Google Admin console.

    Sign in using your administrator account (does not end in

  2. On the left, click Reportingand thenAudit and investigationand thenDirectory Sync log events.

Filter the data

  1. Open the log events as described above in Access Directory Sync log events.
  2. Click Add a filter, and then select an attribute.
  3. In the pop-up window, select an operatorand thenselect a valueand thenclick Apply.
  4. (Optional) To create multiple filters for your search:
    1. Click Add a filter and repeat step 3.
    2. (Optional) To add a search operator, above Add a filter, select AND or OR.
  5. Click Search.

Note: Using the Filter tab, you can include simple parameter and value pairs to filter the search results. You can also use the Condition builder tab, where the filters are represented as conditions with AND/OR operators.

Attribute descriptions

For this data source, you can use the following attributes when searching log event data:

Attribute Description
Count Number of objects affected by the audit event—for example, a count of objects read in a directory read
Created count Number of created objects—for example, a count of users created in target directory during a sync run
Date Date and time of the event (displayed in your browser's default time zone)
Deleted count Number of deleted objects—for example, a count of users deleted in target directory during a sync run
Deprovision action The action involved while deprovisioning an object—for example, a user is suspended or a group is deleted

Logged event action, such as Object Created or Sync Summary

Tip: If you have event values that you use often, you can pin those events to the top of the drop-down menu. 

Learn more about events related to Directory Sync. 

Excluded count Number of excluded objects—for example, a count of objects excluded while reading from source directory due to the configured exclusion rules
Exclusion rule Condition used to exclude an object while reading from the source directory
Failed count Number of objects that failed to sync during a sync run
Filter Query used to read from the source directory
Group ID Identifier of the group being used in membership related events—for example,
Log level Severity level of the logged event
Message Reason for the occurrence of the event
New attributes Object attributes following the sync
New membership role Membership role following the sync
Object ID ID of the object
Object type Type of the object—for example, Group, Group membership, or User
Old attributes Object attributes before the sync
Old membership role Membership role before the sync
Simulation Whether or not a sync job was a simulation
Source directory ID Identifier of the source directory
Source directory name Name of the source directory—for example, My AD directory name
Source immutable ID Immutable ID of the source object. This ID can be the ObjectGUID of source object
Source object ID Identifier of the source object—for example, CN=User Name, OU=Sales, DC=example, DC=com
Sync job Identifier of the sync job
Sync job config All values configured in the sync job
Sync run Identifier of the sync run
Target object ID Identifier of the target object—for example,
Updated count Number of objects updated during a sync run
Verbose log Whether or not there are detailed logs about individual objects

Manage log event data

Manage search results column data

You can control which data columns appear in your search results.

  1. At the top-right of the search results table, click Manage columns .
  2. (Optional) To remove current columns, click Remove .
  3. (Optional) To add columns, next to Add new column, click the Down arrow  and select the data column.
    Repeat as needed.
  4. (Optional) To change the order of the columns, drag the data column names.
  5. Click Save.

Export search result data

  1. At the top of the search results table, click Export all.
  2. Enter a name and then click Export.
    The export displays below the search results table under Export action results.
  3. To view the data, click the name of your export.
    The export opens in Google Sheets.

Create reporting rules

Go to Create and manage reporting rules.

When and how long is data available?

Go to Data retention and lag times.

Related topics

Was this helpful?

How can we improve it?
Clear search
Close search
Google apps
Main menu
Search Help Center