Plug-in Trace Log (PluginTraceLog) table/entity reference (Microsoft Dataverse)

2025-08-28

Trace and exception information generated by plug-ins and custom workflow activities.

Messages

The following table lists the messages for the Plug-in Trace Log (PluginTraceLog) table. Messages represent operations that can be performed on the table. They may also be events.

Name Is Event?	Web API Operation	SDK for .NET
`Associate` Event: True	Associate records	Associate records
`Delete` Event: True	`DELETE` /plugintracelogs(plugintracelogid) See Delete	Delete records
`Disassociate` Event: True	Disassociate records	Disassociate records
`Retrieve` Event: True	`GET` /plugintracelogs(plugintracelogid) See Retrieve	Retrieve records
`RetrieveMultiple` Event: True	`GET` /plugintracelogs See Query data	Query data

Properties

The following table lists selected properties for the Plug-in Trace Log (PluginTraceLog) table.

Property	Value
DisplayName	Plug-in Trace Log
DisplayCollectionName	Plug-in Trace Logs
SchemaName	`PluginTraceLog`
CollectionSchemaName	`PluginTraceLogs`
EntitySetName	`plugintracelogs`
LogicalName	`plugintracelog`
LogicalCollectionName	`plugintracelogs`
PrimaryIdAttribute	`plugintracelogid`
PrimaryNameAttribute	`typename`
TableType	`Standard`
OwnershipType	`OrganizationOwned`

Read-only columns/attributes

These columns/attributes return false for both IsValidForCreate and IsValidForUpdate. Listed by SchemaName.

Configuration
CorrelationId
CreatedBy
CreatedOn
CreatedOnBehalfBy
Depth
ExceptionDetails
IsSystemCreated
MessageBlock
MessageName
Mode
OperationType
OrganizationId
PerformanceConstructorDuration
PerformanceConstructorStartTime
PerformanceExecutionDuration
PerformanceExecutionStartTime
PersistenceKey
PluginStepId
PluginTraceLogId
PrimaryEntity
Profile
RequestId
SecureConfiguration
TypeName

Configuration

Property	Value
Description	Unsecured configuration for the plug-in trace log.
DisplayName	Configuration
IsValidForForm	True
IsValidForRead	True
LogicalName	`configuration`
RequiredLevel	None
Type	Memo
Format	TextArea
FormatName	TextArea
ImeMode	Auto
IsLocalizable	False
MaxLength	1073741823

CorrelationId

Property	Value
Description	Unique identifier for tracking plug-in or custom workflow activity execution.
DisplayName	Correlation Id
IsValidForForm	True
IsValidForRead	True
LogicalName	`correlationid`
RequiredLevel	None
Type	Uniqueidentifier

CreatedBy

Property	Value
Description	Unique identifier of the delegate user who created the record.
DisplayName	Created By (Delegate)
IsValidForForm	True
IsValidForRead	True
LogicalName	`createdby`
RequiredLevel	None
Type	Lookup
Targets	systemuser

CreatedOn

Property	Value
Description	Date and time when the record was created.
DisplayName	Created On
IsValidForForm	True
IsValidForRead	True
LogicalName	`createdon`
RequiredLevel	None
Type	DateTime
CanChangeDateTimeBehavior	False
DateTimeBehavior	UserLocal
Format	DateAndTime
ImeMode	Inactive
SourceTypeMask	0

CreatedOnBehalfBy

Property	Value
Description	Unique identifier of the delegate user who created the record.
DisplayName	Created By (Delegate)
IsValidForForm	True
IsValidForRead	True
LogicalName	`createdonbehalfby`
RequiredLevel	None
Type	Lookup
Targets	systemuser

Depth

Property	Value
Description	Depth of execution of the plug-in or custom workflow activity.
DisplayName	Depth
IsValidForForm	True
IsValidForRead	True
LogicalName	`depth`
RequiredLevel	None
Type	Integer
MaxValue	2147483647
MinValue	0

ExceptionDetails

Property	Value
Description	Details of the exception.
DisplayName	Exception Details
IsValidForForm	True
IsValidForRead	True
LogicalName	`exceptiondetails`
RequiredLevel	None
Type	Memo
Format	TextArea
FormatName	TextArea
ImeMode	Auto
IsLocalizable	False
MaxLength	1073741823

IsSystemCreated

Property	Value
Description	Where the event originated. Set to true if it's a system trace; otherwise, false.
DisplayName	System Created
IsValidForForm	True
IsValidForRead	True
LogicalName	`issystemcreated`
RequiredLevel	SystemRequired
Type	Boolean
GlobalChoiceName	`plugintracelog_issystemcreated`
DefaultValue	False
True Label	Yes
False Label	No

MessageBlock

Property	Value
Description	Trace text from the plug-in.
DisplayName	Message Block
IsValidForForm	True
IsValidForRead	True
LogicalName	`messageblock`
RequiredLevel	None
Type	Memo
Format	TextArea
FormatName	TextArea
ImeMode	Auto
IsLocalizable	False
MaxLength	1073741823

MessageName

Property	Value
Description	Name of the message that triggered this plug-in.
DisplayName	Message Name
IsValidForForm	True
IsValidForRead	True
LogicalName	`messagename`
RequiredLevel	None
Type	String
Format	Text
FormatName	Text
ImeMode	Auto
IsLocalizable	False
MaxLength	1024

Mode

Property	Value
Description	Type of execution.
DisplayName	Mode
IsValidForForm	True
IsValidForRead	True
LogicalName	`mode`
RequiredLevel	None
Type	Picklist
DefaultFormValue	1
GlobalChoiceName	`plugintracelog_mode`

Mode Choices/Options

Value	Label
0	Synchronous
1	Asynchronous

OperationType

Property	Value
Description	Type of custom code.
DisplayName	Operation Type
IsValidForForm	True
IsValidForRead	True
LogicalName	`operationtype`
RequiredLevel	None
Type	Picklist
DefaultFormValue	0
GlobalChoiceName	`plugintracelog_operationtype`

OperationType Choices/Options

Value	Label
0	Unknown
1	Plug-in
2	Workflow Activity

OrganizationId

Property	Value
Description	Unique identifier for the organization.
DisplayName	Organization Id
IsValidForForm	False
IsValidForRead	True
LogicalName	`organizationid`
RequiredLevel	None
Type	Uniqueidentifier

PerformanceConstructorDuration

Property	Value
Description	Time, in milliseconds, to construct.
DisplayName	Constructor Duration
IsValidForForm	True
IsValidForRead	True
LogicalName	`performanceconstructorduration`
RequiredLevel	None
Type	Integer
MaxValue	2147483647
MinValue	0

PerformanceConstructorStartTime

Property	Value
Description	Date and time when constructed.
DisplayName	Constructor Start Time
IsValidForForm	True
IsValidForRead	True
LogicalName	`performanceconstructorstarttime`
RequiredLevel	None
Type	DateTime
CanChangeDateTimeBehavior	False
DateTimeBehavior	UserLocal
Format	DateAndTime
ImeMode	Auto
SourceTypeMask	0

PerformanceExecutionDuration

Property	Value
Description	Time, in milliseconds, to execute the request.
DisplayName	Execution Duration
IsValidForForm	True
IsValidForRead	True
LogicalName	`performanceexecutionduration`
RequiredLevel	None
Type	Integer
MaxValue	2147483647
MinValue	0

PerformanceExecutionStartTime

Property	Value
Description	Time, in milliseconds, to execute the request.
DisplayName	Execution Start Time
IsValidForForm	True
IsValidForRead	True
LogicalName	`performanceexecutionstarttime`
RequiredLevel	None
Type	DateTime
CanChangeDateTimeBehavior	False
DateTimeBehavior	UserLocal
Format	DateAndTime
ImeMode	Auto
SourceTypeMask	0

PersistenceKey

Property	Value
Description	Asynchronous workflow persistence key.
DisplayName	Persistence Key
IsValidForForm	True
IsValidForRead	True
LogicalName	`persistencekey`
RequiredLevel	None
Type	Uniqueidentifier

PluginStepId

Property	Value
Description	ID of the plug-in registration step.
DisplayName	Plugin Step ID
IsValidForForm	True
IsValidForRead	True
LogicalName	`pluginstepid`
RequiredLevel	None
Type	Uniqueidentifier

PluginTraceLogId

Property	Value
Description	Unique identifier for an entity instance.
DisplayName	Plug-in Trace Log
IsValidForForm	False
IsValidForRead	True
LogicalName	`plugintracelogid`
RequiredLevel	SystemRequired
Type	Uniqueidentifier

PrimaryEntity

Property	Value
Description	Entity, if any, that the plug-in is executed against.
DisplayName	Primary Entity
IsValidForForm	True
IsValidForRead	True
LogicalName	`primaryentity`
RequiredLevel	None
Type	String
Format	Text
FormatName	Text
ImeMode	Auto
IsLocalizable	False
MaxLength	1000

Profile

Property	Value
Description	Plug-in profile formatted as serialized text.
DisplayName	Profile
IsValidForForm	True
IsValidForRead	True
LogicalName	`profile`
RequiredLevel	None
Type	Memo
Format	TextArea
FormatName	TextArea
ImeMode	Auto
IsLocalizable	False
MaxLength	1073741823

RequestId

Property	Value
Description	Unique identifier of the message request.
DisplayName	Request ID
IsValidForForm	True
IsValidForRead	True
LogicalName	`requestid`
RequiredLevel	None
Type	Uniqueidentifier

SecureConfiguration

Property	Value
Description	Secured configuration for the plug-in trace log.
DisplayName	Secure Configuration
IsValidForForm	True
IsValidForRead	True
LogicalName	`secureconfiguration`
RequiredLevel	None
Type	Memo
Format	TextArea
FormatName	TextArea
ImeMode	Auto
IsLocalizable	False
MaxLength	1073741823

TypeName

Property	Value
Description	Class name of the plug-in.
DisplayName	Type Name
IsValidForForm	True
IsValidForRead	True
LogicalName	`typename`
RequiredLevel	None
Type	String
Format	Text
FormatName	Text
ImeMode	Auto
IsLocalizable	False
MaxLength	1024

Many-to-One relationships

These relationships are many-to-one. Listed by SchemaName.

createdby_plugintracelog
lk_plugintracelogbase_createdonbehalfby

createdby_plugintracelog

One-To-Many Relationship: systemuser createdby_plugintracelog

Property	Value
ReferencedEntity	`systemuser`
ReferencedAttribute	`systemuserid`
ReferencingAttribute	`createdby`
ReferencingEntityNavigationPropertyName	`createdby`
IsHierarchical
CascadeConfiguration	Archive: `NoCascade` Assign: `NoCascade` Delete: `NoCascade` Merge: `NoCascade` Reparent: `NoCascade` RollupView: `NoCascade` Share: `NoCascade` Unshare: `NoCascade`

lk_plugintracelogbase_createdonbehalfby

One-To-Many Relationship: systemuser lk_plugintracelogbase_createdonbehalfby

Property	Value
ReferencedEntity	`systemuser`
ReferencedAttribute	`systemuserid`
ReferencingAttribute	`createdonbehalfby`
ReferencingEntityNavigationPropertyName	`createdonbehalfby`
IsHierarchical
CascadeConfiguration	Archive: `NoCascade` Assign: `NoCascade` Delete: `NoCascade` Merge: `NoCascade` Reparent: `NoCascade` RollupView: `NoCascade` Share: `NoCascade` Unshare: `NoCascade`

Feedback

Was this page helpful?