Data Model for Agentforce Log Events
Use the data in the AI Agent Session Logging data model object (DMO) to monitor log events during AI agent sessions.
Required Editions
| Available in: Enterprise, Performance, and Unlimited Editions with an Einstein for Sales, Einstein for Platform, Einstein for Service, Einstein 1 Service, or Einstein GPT Service add-on. To purchase add-ons, contact your Salesforce account executive. |
AI Agent Session Log DMO
A Data 360 DMO that captures details about structured log events emitted during AI agent sessions. It captures informational, warning, debug, and error events so you can analyze runtime behavior, troubleshoot failures, and trace issues across single-agent and multi-agent flows. AiAgentSessionLog has these attributes.
| Field Label | Field DEVELOPER Name | Data Type | Description |
|---|---|---|---|
AI Agent Session Log Id |
Id |
Text | Primary key |
AI Agent Session |
AiAgentSessionId |
Foreign key | Foreign key to AiAgentSession. Required. |
AI Agent Interaction |
AiAgentInteractionId |
Foreign key | Foreign key to AiAgentInteraction. Nullable. |
AI Agent Interaction Step |
AiAgentInteractionStepId |
Foreign key | Foreign key to AiAgentInteractionStep. Nullable. |
Telemetry Trace |
TelemetryTrace |
Text | Shared identifier used for implicit joins on TraceId among DMOs
(AiAgentInteraction, TelemetryTraceSpan,
AiAgentSessionLog). Nullable. |
Telemetry Trace Span |
TelemetryTraceSpanId |
Foreign key | Foreign key to TelementryTraceSpan. Nullable. |
Cause Log |
CauseLogId |
Foreign key | Self-FK. Immediate wrapped or underlying cause. Entries can reference a log entry in a
different session. Populated only when LogLevel is ERROR
or FATAL. |
Root Cause Log |
RootCauseLogId |
Foreign key | Self-FK. Deepest known cause (denormalized). Entries can reference a log entry in a
different session. Populated only when LogLevel is ERROR or
FATAL. |
Log Date Time |
LogDateTime |
Datetime | Timestamp of the log event. |
Log Level Type |
LogLevelType |
Text | Log level. Values: DEBUG | INFO |
WARNING | ERROR | FATAL |
Category |
Category |
Text | Contextual domain of the log entry. Examples: Tool, LLM, Retrieval, Guardrail, Auth, HTTP, Delegation, Platform, Lifecycle, Performance |
Code |
Code |
Text | Structured code for the event. For errors: user-facing error code (consistent with
Salesforce existing codes). For non-errors: event type identifier (examples:
TOOL_INVOCATION_START, LLM_RESPONSE_RECEIVED). |
Description |
Description |
Text | Short, human-readable summary of the issue. |
Detailed Description |
DetailedDescription |
Text | Structured JSON payload with diagnostics. Schema varies by Category
and LogLevelType. |
Konnten Sie Ihr Problem mithilfe dieses Artikels lösen?
Geben Sie uns Feedback, damit wir uns verbessern können.
