Purview Audit Log Schema

Purview Audit Log Schema Overview

The following link below provides the appropriate schema for events that are logged within the Microsoft Purview portal or from the Microsoft Purview compliance portal.

Audit Log Schema

Property

Description

Microsoft service that has this property

Actor

The user or service account that performed the action.

Azure Active Directory

AddOnName

The name of an add-on that was added, removed, or updated in a team. The type of add-ons in Microsoft Teams is a bot, a connector, or a tab.

Microsoft Teams

AddOnType

The type of an add-on that was added, removed, or updated in a team. The following values indicate the type of add-on. 1 - Indicates a bot. 2 - Indicates a connector. 3 - Indicates a tab.

Microsoft Teams

AppAccessContext

The application context for the user or service principal that performed the action.

Microsoft Teams

ArtifactShared

Files or content shared by the user.

Microsoft Teams

AzureActiveDirectoryEventType

The type of Azure Active Directory activity. The following values indicate the type of activity. 0 - Indicates an account sign-in activity. 1 - Indicates an Azure application security activity.

Azure Active Directory

ChannelGuid

The ID of a Microsoft Teams channel. The team that the channel is located in is identified by the TeamName and TeamGuid properties.

Microsoft Teams

ChannelName

The name of a Microsoft Teams channel. The team that the channel is located in is identified by the TeamName and TeamGuid properties.

Microsoft Teams

Client

The client device, the device OS, and the device browser used for the sign-in activity (for example, Nokia Lumia 920; Windows Phone 8; IE Mobile 11).

Azure Active Directory

ClientInfoString

Information about the email client that was used to perform the operation, such as a browser version, Outlook version, and mobile device information

Exchange (mailbox activity)

ClientIP

The IP address of the device that was used when the activity was logged. The IP address is displayed in either an IPv4 or IPv6 address format. For some services, the value displayed in this property might be the IP address for a trusted application (for example, Office on the web apps) calling into the service on behalf of a user and not the IP address of the device used by person who performed the activity. Also, for admin activity (or activity performed by a system account) for Azure Active Directory-related activities, the IP address isn't logged and the value for the ClientIP property is null.

Azure Active Directory, Exchange, SharePoint

CreationTime

The date and time in Coordinated Universal Time (UTC) when the audit log record is generated.

All

CurrentProtectionType

A complex property type containing fields to describe the current protection status of a document. Includes the following: ProtectionType: Enumerates the type of protection applied to the document. These values and their meanings apply: 0 (no protection), 1 (template-based protection), 2 (don't forward, for email), 3 (encrypt only), and 4 (custom, user configured protection) Owner: The email address of the user that configured protection. TemplateId: When the ProtectionType is set to 1 (template), this field contains the GUID of the template applied to the document. When the value of ProtectionType doesn't equal 1, this field is blank. DocumentEncrypted: Boolean flag indicating if any type of encryption is applied to the document. Values are True or False.

All

DestinationFileExtension

The file extension of a file that is copied or moved. This property is displayed only for the FileCopied and FileMoved user activities.

SharePoint

DestinationFileName

The name of the file is copied or moved. This property is displayed only for the FileCopied and FileMoved actions.

SharePoint

DestinationRelativeUrl

The URL of the destination folder where a file is copied or moved. The combination of the values for the SiteURL, the DestinationRelativeURL, and the DestinationFileName property is the same as the value for the ObjectID property, which is the full path name for the file that was copied. This property is displayed only for the FileCopied and FileMoved user activities.

SharePoint

EventSource

Identifies that an activity occurred in SharePoint. Possible values are SharePoint and ObjectModel.

SharePoint

ExternalAccess

For Exchange admin activity, specifies whether the cmdlet was run by a user in your organization, by Microsoft datacenter personnel or a datacenter service account, or by a delegated administrator. The value False indicates that the cmdlet was run by someone in your organization. The value True indicates that the cmdlet was run by datacenter personnel, a datacenter service account, or a delegated administrator. For Exchange mailbox activity, specifies whether a mailbox was accessed by a user outside your organization.

Exchange

ExtendedProperties

The extended properties for an Azure Active Directory activity.

Azure Active Directory

The ID of the report entry. The ID uniquely identifies the report entry.

All

InternalLogonType

Reserved for internal use.

Exchange (mailbox activity)

ItemType

The type of object that was accessed or modified. Possible values include File, Folder, Web, Site, Tenant, and DocumentLibrary.

SharePoint

IsJoinedFromLobby

Whether or not the user joined a Teams session from the lobby.

Microsoft Teams

LoginStatus

Identifies sign-in failures that might have occurred.

Azure Active Directory

LogonType

The type of mailbox access. The following values indicate the type of user who accessed the mailbox. 0 - Indicates a mailbox owner. 1 - Indicates an administrator. 2 - Indicates a delegate. 3 - Indicates the transport service in the Microsoft datacenter. 4 - Indicates a service account in the Microsoft datacenter. 6 - Indicates a delegated administrator.

Exchange (mailbox activity)

MailboxGuid

The Exchange GUID of the mailbox that was accessed.

Exchange (mailbox activity)

MailboxOwnerUPN

The email address of the person who owns the mailbox that was accessed.

Exchange (mailbox activity)

Members

Lists the users that have been added or removed from a team. The following values indicate the Role type assigned to the user. 1 - Indicates the Owner role. 2 - Indicates the Member role. 3 - Indicates the Guest role. The Members property also includes the name of your organization, and the member's email address.

Microsoft Teams

ModifiedProperties (Name, NewValue, OldValue)

The property is included for admin activities, such as adding a user as a member of a site or a site collection admin group. The property includes the name of the property that was modified (for example, the Site Admin group) the new value of the modified property (such the user who was added as a site admin, and the previous value of the modified object).

All (admin activity)

ObjectFullyQualifiedName

The fully qualified name for an entity.

Microsoft Purview (governance)

ObjectId

For Exchange admin audit logging, the name of the object that was modified by the cmdlet. For SharePoint activity, the full URL path name of the file or folder accessed by a user. For Azure AD activity, the name of the user account that was modified.

All

ObjectName

The main entity name.

Microsoft Purview (governance)

ObjectType

The entity type.

Microsoft Purview (governance)

OldValue

The value before a change, includes all properties updated or deleted.

Microsoft Purview (governance)

Operation

The name of the user or admin activity. The value of this property corresponds to the value that was selected in the Activities drop down list. If Show results for all activities was selected, the report will included entries for all user and admin activities for all services. For a description of the operations/activities that are logged in the audit log, see the Audited activities tab in Search the audit log in the Office 365. For Exchange admin activity, this property identifies the name of the cmdlet that was run.

All

OrganizationId

The GUID for your organization.

All

NewValue

The value after a change, includes all properties updated or deleted.

Microsoft Purview (governance)

Path

The name of the mailbox folder where the message that was accessed is located. This property also identifies the folder a where a message is created in or copied/moved to.

Exchange (mailbox activity)

Parameters

For Exchange admin activity, the name and value for all parameters that were used with the cmdlet that is identified in the Operation property.

Exchange (admin activity)

ParticipantInfo

Additional properties about the participant identity.

Microsoft Teams

ParticipatingDomainInformation

Domain information about the participant.

Microsoft Teams

PreviousProtectionType

A complex property type containing fields to describe the previous protection status of a document. Includes the following: ProtectionType: Enumerates the type of protection applied to the document. These values and their meanings apply: 0 (no protection), 1 (template-based protection), 2 (don't forward, for email), 3 (encrypt only), and 4 (custom, user configured protection) Owner: The email address of the user that configured protection. TemplateId: When the ProtectionType is set to 1 (template), this field contains the GUID of the template applied to the document. When the value of ProtectionType doesn't equal 1, this field is blank. DocumentEncrypted: Boolean flag indicating if any type of encryption is applied to the document. Values are True or False.

All

ProtectionEventType

Enumerates how the protection was changed by the operation being audited. The following values and meanings apply: 0 - Indicates unchanged. 1 - Indicates added. 2 - Indicates changed. 3 - Indicates removed.

All

RecordType

The type of operation indicated by the record. This property indicates the service or feature that the operation was triggered in. For a list of record types and their corresponding ENUM value (which is the value displayed in the RecordType property in an audit record), see Audit log record type.

ResultStatus

Indicates whether the action (specified in the Operation property) was successful or not. For Exchange admin activity, the value is either True (successful) or False (failed).

All

SecurityComplianceCenterEventType

Indicates that the activity was a Microsoft Purview portal activity. All Microsoft Purview portal activities have a value of 0 for this property.

Microsoft Purview portal

SensitivityLabel

The sensitivity label assigned to a specific mail item.

Exchange

SharingType

The type of sharing permissions that was assigned to the user that the resource was shared with. This user is identified in the UserSharedWith property.

SharePoint

Site

The GUID of the site where the file or folder accessed by the user is located.

SharePoint

SiteUrl

The URL of the site where the file or folder accessed by the user is located.

SharePoint

SourceFileExtension

The file extension of the file that was accessed by the user. This property is blank if the object that was accessed is a folder.

SharePoint

SourceFileName

The name of the file or folder accessed by the user.

SharePoint

SourceRelativeUrl

The URL of the folder that contains the file accessed by the user. The combination of the values for the SiteURL, the SourceRelativeURL, and the SourceFileName property is the same as the value for the ObjectID property, which is the full path name for the file accessed by the user.

SharePoint

Subject

The subject line of the message that was accessed.

Exchange (mailbox activity)

TabType

The type of tab added, removed, or updated in a team. The possible values for this property are: Excel pin - An Excel tab. Extension - All first-party and third-party apps; such as Class Schedule, VSTS, and Forms. Notes - OneNote tab. Pdfpin - A PDF tab. Powerbi - A Power BI tab. Powerpointpin - A PowerPoint tab. Sharepointfiles - A SharePoint tab. Webpage - A pinned website tab. Wiki-tab - A wiki tab. Wordpin - A Word tab.

Microsoft Teams

Target

The user that the action (identified in the Operation property) was performed on. For example, if a guest is added to SharePoint or a Microsoft Team, that user would be listed in this property.

Azure Active Directory

TeamGuid

The ID of a team in Microsoft Teams.

Microsoft Teams

TeamName

The name of a team in Microsoft Teams.

Microsoft Teams

UserAgent

Information about the user's browser. This information is provided by the browser.

SharePoint

UserDomain

Identity information about the tenant organization of the user (actor) who performed the action.

Azure Active Directory

UserId

The user who performed the action (specified in the Operation property) that resulted in the record being logged. Audit records for activity performed by system accounts (such as SHAREPOINT\system or NT AUTHORITY\SYSTEM) are also included in the audit log. Another common value for the UserId property is app@sharepoint. This indicates that the "user" who performed the activity was an application that has the necessary permissions in SharePoint to perform organization-wide actions (such as search a SharePoint site or OneDrive account) on behalf of a user, admin, or service. For more information, see: The app@sharepoint user in audit records or System accounts in Exchange mailbox audit records.

All

UserKey

Contains a valid Azure Active Directory Object ID in GUID format or hex format. For scenarios where the primary actor isn't a user, the UserKey is an empty string. See UserType and UserKey scenarios for details on various UserKey scenarios.

All

UserType

The type of user that performed the operation. See the UserType and UserKey scenarios for details on various UserType scenarios.

All

Version

Indicates the version number of the activity (identified by the Operation property) that's logged.

All

Workload

The Microsoft 365 service where the activity occurred.

All

UserType and UserKey scenarios

The following table provides details for UserType and UserKey scenarios:

Value

UserType member name

Description

UserKey

Regular

A regular user without admin permissions.

Microsoft Entra Object ID in GUID format

Admin

An administrator in your Microsoft 365 organization.1

Microsoft Entra Object ID in GUID format

DCAdmin

A Microsoft datacenter administrator or datacenter system account.

Microsoft Entra Object ID in GUID format

System

An audit event triggered by server-side logic. For example, Windows services or background processes.