Editar

Analyzing stopped session telemetry

In Business Central, a background session is a session without a UI that runs a specified codeunit. Background sessions are started and stopped by calling the StartSession and StopSession methods from AL. With Business Central online, sessions can be stopped by using the admin center, which indirectly calls the StopSession method. Learn more in Managing Sessions.

With Application Insights, you can record attempts to stop sessions, either by direct calls to the StopSession method or from the admin center.

The StopSession method was invoked on session

A call to the StopSession method was made from AL or from the admin center. The event is also emitted when the call doesn't stop a session. Check the result dimension to determine the outcome.

General dimensions

This table explains the columns included in the trace emitted when a session stop is attempted.

Dimension Description or value
message The StopSession method was invoked on session {stoppingSessionID}
operation_Name StopSessionOperation
severityLevel 1

Custom dimensions

The following table describes the most relevant custom dimensions of the trace.

Column Description or value
eventId RT0029
alObjectId* The ID of the object that called the StopSession method to cancel the session
alObjectName* The name of the object that called the StopSession method to cancel the session
alObjectType* The type of the object, like codeunit or page, that called the StopSession method to cancel the session
alStackTrace* The stack trace for the session stop in AL.
cancellationComment The comment defined in the StopSession method call. Stopped by management PowerShell cmdlet indicates a management request, such as a request from the Business Central admin center or a management PowerShell cmdlet.
clientType The type of client that called the StopSession method, such as Background, WebClient, or ManagementClient. ManagementClient indicates a management request, not exclusively a request from the Business Central admin center. Learn more in ClientType option type.
companyName* The name of the company that was open during the session
currentSessionID The ID of the session that called the StopSession method to stop the session identified by stoppingSessionID.
extensionName The name of the extension that included the code that called the StopSession method.
result The Boolean outcome recorded for the stop request. A value of True indicates that the stop request was accepted.
stoppingSessionID The ID of the session that the StopSession method attempted to stop.
stoppingSessionIsAdmin Indicates whether the target session was running as an administrator.
See common custom dimensions

* Not shown for sessions canceled from the admin center.

Other custom dimensions

The following table explains other custom dimensions of the trace.

Dimension Description or value
aadTenantId The Microsoft Entra tenant ID that's used for Microsoft Entra authentication. For on-premises, if you aren't using Microsoft Entra authentication, this value is common.
component Dynamics 365 Business Central Server
componentVersion The version number of the component that emits telemetry (see the component dimension)
environmentName The name of the tenant environment. This dimension isn't included for Business Central on-premises environments. Learn more in Managing environments.
environmentType The environment type for the tenant, such as Production, Sandbox, Trial. Learn more in Environment types.
telemetrySchemaVersion The version of the Business Central telemetry schema

Monitoring and Analyzing Telemetry
Enable Sending Telemetry to Application Insights
Monitoring and Analyzing Long Running SQL Queries On-Premises
The Business Central Administration Center