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

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

See also

Dataverse table/entity reference
Dataverse Web API Reference
plugintracelog