{"title":"Measure onboarding progress using telemetry","url":"https://jonas-paprotka.de/docs/dev-itpro/administration/onboarding-telemetry/","by":"JOP-AL","license":"Copyright (c) Microsoft Corporation. CC BY 4.0, https://creativecommons.org/licenses/by/4.0/; code samples MIT. From https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/administration/onboarding-telemetry, MicrosoftDocs/dynamics365smb-devitpro-pb at 828b6ee (2026-11-19). Changed: includes filled in, links to this site, and for agents shortened without dropping a fact.","credit":"Microsoft Corporation, CC BY 4.0","origin":"https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/administration/onboarding-telemetry","source":{"name":"Business Central developer and IT pro docs","repo":"https://github.com/MicrosoftDocs/dynamics365smb-devitpro-pb","commit":"828b6ee72fcd75755627cd6011f3d20899217ab2","date":"2026-11-19"},"checked":"2026-11-19","description":"Learn how you can use onboarding telemetry to measure customers' progress with onboarding to Dynamics 365 Business Central.","date":"2026-11-17","meta":{"topic":"how-to"},"outline":[{"level":1,"title":"Measure onboarding progress using telemetry","slug":"measure-onboarding-progress-using-telemetry","at":0,"chars":5249},{"level":2,"title":"Signals emitted automatically","slug":"signals-emitted-automatically","at":563,"chars":852},{"level":2,"title":"Criteria and timing for emitting the automatic signals","slug":"criteria-and-timing-for-emitting-the-automatic-signals","at":1415,"chars":900},{"level":2,"title":"Extend the onboarding telemetry signals","slug":"extend-the-onboarding-telemetry-signals","at":2315,"chars":2329},{"level":2,"title":"Telemetry event IDs used when emitting onboarding signals","slug":"telemetry-event-ids-used-when-emitting-onboarding-signals","at":4644,"chars":516},{"level":2,"title":"Related information","slug":"related-information","at":5160,"chars":89}],"text":"# Measure onboarding progress using telemetry\nBusiness Central emits telemetry signals that help indicate a customer's progress in onboarding to Business Central. These signals are emitted based on the use of certain business processes in Business Central. For example, posting sales invoices or vendor payments. Measuring emitted onboarding signals is a great way for partners to know how well their customers are doing in the onboarding process. If a customer isn't progressing as expected, the partner can proactively provide services to unblock the customer.\n## Signals emitted automatically\nBusiness Central emits signals that are defined by Microsoft. The signals are generic enough to cover most types of businesses. More signals can be emitted by extending the onboarding signals functionality. Currently, the signals emitted automatically are based on these business processes:\n Onboarding starts when signals are registered for a company during app installation or company initialization.\n Sales, which indicates that the company has set up everything needed to sell products or services.\n Purchases, which indicate that the company has set up everything needed to buy products or services.\n Customer payments, which indicate that sales process cycles have been completed, from sales to payment.\n Vendor payments, which indicate that purchase process cycles have been completed, from ordering to payment.\n## Criteria and timing for emitting the automatic signals\n Onboarding started: When each onboarding signal is registered for a company.\n Sales Invoice Signal: When five posted sales invoices exist (Table 112, Sales Invoice Header).\n Purchase Invoice Signal: When five posted purchase invoices exist (Table 122, Purch. Inv. Header).\n Customer Payment Signal: When five posted customer payments exist (Table 21, Cust. Ledger Entry, Document Type = Payment).\n Vendor Payment Signal: When five posted vendor payments exist (Table 25, Vendor Ledger Entry, Document Type = Payment).\nA completion signal is emitted once for each registered process when its criteria are met. When job scheduling is permitted, signing in to Business Central online schedules a recurring daily telemetry job to check the criteria. The company signal completes when all other registered signals for the company have completed.\n## Extend the onboarding telemetry signals\nPartners can add more signals based on their own criteria. They can extend the Onboarding Signals framework to add the onboarding signals that suit their customers. The following process is an example of how to extend the framework:\n1. Extend enum 7580 `\"Onboarding Signal Type\"` with new onboarding signals.\n This example adds a new onboarding signal that's intended to be emitted when the count of general ledger entries reaches 1,000.\n ```al\n using System.Feedback;\n\n enumextension 50100 \"GL Entry Onboarding Signal\" extends \"Onboarding Signal Type\"\n {\n     value(50100; \"GL Entry Signal\")\n     {\n         Implementation = \"Onboarding Signal\" = \"GL Entry Signal\";\n     }\n }\n ```\n1. Implement the `\"Onboarding Signal\"` interface in a codeunit and add criteria code.\n This example is based on the number of general ledger entries reaching 1000.\n ```al\n using Microsoft.Finance.GeneralLedger.Ledger;\n using System.Feedback;\n\n codeunit 50100 \"GL Entry Signal\" implements \"Onboarding Signal\"\n {\n     Access = Internal;\n     Permissions = tabledata \"G/L Entry\" = r;\n\n     procedure IsOnboarded(): Boolean\n     var\n         GLEntry: Record \"G/L Entry\";\n         OnboardingThreshold: Integer;\n     begin\n         OnboardingThreshold := 1000;\n\n         exit(GLEntry.Count() >= OnboardingThreshold);\n     end;\n }\n ```\n1. Register onboarding signals. Typically, when an app is installed or updated.\n ```al\n  using System.Environment;\n  using System.Feedback;\n\n  codeunit 50101 \"Register Onboarding Signals\"\n  {\n      Access = Internal;\n      Subtype = Install;\n\n      trigger OnInstallAppPerCompany()\n      begin\n          RegisterOnboardingSignals();\n      end;\n\n      internal procedure RegisterOnboardingSignals()\n      var\n          Company: Record Company;\n          OnboardingSignal: Codeunit \"Onboarding Signal\";\n          EnvironmentInfo: Codeunit \"Environment Information\";\n          OnboardingSignalType: Enum \"Onboarding Signal Type\";\n      begin\n          if not Company.Get(CompanyName()) then\n              exit;\n\n          if Company.\"Evaluation Company\" then\n              exit;\n\n          if EnvironmentInfo.IsSandbox() then\n              exit;\n\n          OnboardingSignal.RegisterNewOnboardingSignal(Company.Name, OnboardingSignalType::\"GL Entry Signal\");\n      end;\n  }\n ```\n## Telemetry event IDs used when emitting onboarding signals\nThese event IDs are used when emitting onboarding signals.\n Onboarding started: AL0000EIW\n Onboarding signal completed: AL0000EIV\nCompletion signals that partners add are emitted with the AL0000EIV event ID. In AL calls to LogMessage, use the event ID without the AL prefix.\n> NOTE\n> Onboarding criteria aren't relevant for non-production scenarios. Evaluation companies and sandboxes aren't included when registering onboarding signals or emitting them.\n## Related information\nOnboarding experiences in Business Central<onboarding-experiences>"}