Analyzing onboarding telemetry

APPLIES TO: Business Central 2023 release wave 1, update 22.1, and later

Onboarding telemetry gathers data about the following operations:

  • An onboarding signal is registered for a company
  • A registered onboarding signal meets its completion criteria

These events use normal verbosity (severityLevel 1) and TelemetryScope::All.

Onboarding started

Occurs when a new onboarding signal is registered for a company and signal type. Registering an existing signal doesn't emit another event.

General dimensions

DimensionDescription or value
messageOnboarding Signal Started: {signal type}
user_IdThe user telemetry ID for the user. On the user card, you can use the user_Id to look up the user who triggered this telemetry event.

Custom dimensions

DimensionDescription or value
aadTenantIdSpecifies the Microsoft Entra tenant ID used for Microsoft Entra authentication. For on-premises, if you aren't using Microsoft Entra authentication, this value is common.
alCountryCodeSpecifies the localization for the environment, such as US or DK.
alCriteriaNameThe name of the registered onboarding signal type.
alCriteriaIdThe numeric ID of the onboarding signal type.
alStartDateThe date when the signal was registered, in XML date format.
alCompleteDateThe completion date, which isn't set when the signal is registered.
alRegisterExtensionIdThe ID of the extension that registered the signal.
alUserRoleSpecifies the current role center for the user, such as ACCOUNTANT, ORDER PROCESSOR or BUSINESS MANAGER.
alIsAdminSpecifies if the user is an administrator.
alIsEvaluationCompanyWhether the current company is an evaluation company.
alTenantLicenseStateThe license state of the tenant, such as Paid, Trial, Suspended, or Warning.
companyNameThe current company name.
environmentNameSpecifies the name of the tenant environment. Learn more in Managing Environments.
environmentTypeSpecifies the environment type for the tenant, such as Production or Sandbox. Learn more in Environment Types.
componentVersionThe version of the Business Central Server component that emits telemetry.
eventIdAL0000EIW

Onboarding criteria completed

Occurs when a registered onboarding signal's provider reports that its criteria are met. The completion check runs during daily telemetry collection. It skips evaluation companies and sandbox environments.

General dimensions

DimensionDescription or value
messageOnboarding Signal Completed: {signal type}
user_IdThe user telemetry ID for the user. On the user card, you can use the user_Id to look up the user who triggered this telemetry event.

Custom dimensions

DimensionDescription or value
aadTenantIdSpecifies the Microsoft Entra tenant ID used for Microsoft Entra authentication. For on-premises, if you aren't using Microsoft Entra authentication, this value is common.
alCountryCodeSpecifies the localization for the environment, such as US or DK.
alCriteriaNameThe name of the completed onboarding signal type.
alCriteriaIdThe numeric ID of the onboarding signal type.
alStartDateThe date when the signal was registered, in XML date format.
alCompleteDateThe date when the completion check detected that the criteria were met, in XML date format.
alRegisterExtensionIdThe ID of the extension that registered the signal.
alUserRoleSpecifies the current role center for the user, such as ACCOUNTANT, ORDER PROCESSOR or BUSINESS MANAGER.
alIsAdminSpecifies if the user is an administrator.
alIsEvaluationCompanyWhether the current company is an evaluation company.
alTenantLicenseStateThe license state of the tenant, such as Paid, Trial, Suspended, or Warning.
companyNameThe current company name.
environmentNameSpecifies the name of the tenant environment. Learn more in Managing Environments.
environmentTypeSpecifies the environment type for the tenant, such as Production or Sandbox. Learn more in Environment Types.
componentVersionThe version of the Business Central Server component that emits telemetry.
eventIdAL0000EIV

Measure onboarding progress using telemetry Monitoring and Analyzing Telemetry
Enable Sending Telemetry to Application Insights