Analyzing Job Queue Lifecycle Trace Telemetry

APPLIES TO: Business Central 2020 release wave 2, version 17.2, and later

Job queue lifecycle telemetry gathers data about the following operations:

  • A job queue entry was enqueued.
  • A job queue entry was started.
  • A job queue entry finished. Provides information as to whether it was successful or failed.

For information about creating and managing job queue entries, see Use Job Queues to Schedule Tasks in the Business Central application help.

Job queue entry enqueued

Occurs when a job queue entry is sent to the job queue to eventually be run. A job queue entry is sent to the queue when its status is changed from On Hold to Ready or if it's a recurring job queue entry. Recurring job queue entries are automatically enqueued after each run.

General dimensions

Dimension Description or value
message Job queue entry enqueued: {alJobQueueId}
severityLevel 1

Custom dimensions

The following table explains custom dimensions that are specific to this trace.

Dimension Description or value
eventId AL0000E24
alJobQueueId Specifies the ID of the job queue entry.
alJobQueueIsRecurring Specifies whether the job queue is recurring. Yes indicates it's recurring. No indicates it's not recurring.
alJobQueueObjectId Specifies the ID of the object that the job queue entry runs.
alJobQueueObjectType Specifies the type of the object that the job queue entry runs, for example Report or Codeunit.
alJobQueueStatus Ready indicates it's a non-recurring job queue entry or the first run of a recurring job queue entry that's ready to run. On Hold with Inactivity Timeout indicates it's a recurring job query entry that's ready to run.

Common custom dimensions

The following table explains additional custom dimensions that are common to all job queue entry traces.

Dimension Description or value
aadTenantId Specifies that Azure Active Directory (Azure AD) tenant ID used for Azure AD authentication. For on-premises, if you aren't using Azure AD authentication, this value is common.
alCategory AL JobQueueEntries
alDataClassification SystemMetadata
alObjectId 1351, which is the ID of the system application codeunit that subscribes to the telemetry events.
alObjectName Telemetry Subscribers, which is the name of the system application codeunit that subscribes to the telemetry events.
alObjectType CodeUnit
component Dynamics 365 Business Central Server.
componentVersion Specifies the version number of the component that emits telemetry (see the component dimension.)
deprecatedKeys A comma-separated list of all the keys that have been deprecated. The keys in this list are still supported but will eventually be removed in the next major release. We recommend that update any queries that use these keys to use the new key name.
environmentName Specifies the name of the tenant environment. See Managing Environments.
environmentType Specifies the environment type for the tenant, such as Production, Sandbox, Trial. See Environment Types
extensionName Specifies the name of the extension that contains the object run by the job queue entry.
extensionId Specifies the ID of the extension that contains the object run by the job queue entry.
extensionVersion Specifies the version of the extension that contains the object run by the job queue entry.
telemetrySchemaVersion Specifies the version of the Business Central telemetry schema.

Job queue entry started

Occurs when a job queue entry starts to run.

General dimensions

Dimension Description or value
message Job queue entry started: {alJobQueueId}
severityLevel 1

Custom dimensions

The following table explains custom dimensions that are specific to this trace.

Dimension Description or value
eventId AL0000E25
alJobQueueId Specifies the ID of the job queue entry.
alJobQueueObjectId Specifies the ID of the object that the job queue entry runs.
alJobQueueObjectType Specifies the type of the object that the job queue entry runs, for example Report or Codeunit.
alJobQueueStatus In Process
See common custom dimensions

Job queue entry finished

Occurs when a job queue entry finishes running.

General dimensions

Dimension Description or value
message Job queue entry finished: {alJobQueueId}
severityLevel 1

Custom dimensions

Dimension Description or value
eventId AL0000E26
alJobQueueExecutionTimeInMs Specifies how many milliseconds it took to run the job queue entry.
alJobQueueId Specifies the ID of the job queue entry.
alJobQueueObjectId Specifies the ID of the object that the job queue entry runs.
alJobQueueObjectType Specifies the type of the object that the job queue entry runs, for example Report or Codeunit.
alJobQueueResult Success indicates that the job queue entry ran successfully. Fail indicates that an error occurred when running the job queue.
alJobQueueStatus Finished indicates that a non-recurring job queue entry has completed. On Hold with Inactivity Timeout indicates that a recurring the job queue entry completed.
See common custom dimensions

See also

Monitoring and Analyzing Telemetry
Enable Sending Telemetry to Application Insights
Use Job Queues to Schedule Tasks