telemetry-azure-function-integration-trace.md

title	description	author	ms.topic	ms.devlang	ms.search.keywords	ms.date	ms.author	ms.reviewer
Azure Function Integration Telemetry	Learn about telemetry on Azure Function integrations with Business Central	KennieNP	conceptual	al	administration, tenant, telemetry	08/16/2022	kepontop	jswymer

Analyzing Azure Function Integration Telemetry

Azure Function integration telemetry gathers data about the success or failure of calls from Business Central to Azure Functions using the Azure Function module in the System Application.

Failed operations result in a trace log entry that includes a reason for the failure.

Custom dimensions available in all events

The following dimensions are available in all events described below and not included in the individual event documentation:

Dimension	Description or value
aadTenantId	[!INCLUDEaadTenantId]
alCountryCode	[!INCLUDEenvironmentType]
alFunctionHost	The base URL for the Azure function called from Business Central
alIsAdmin	[!INCLUDEenvironmentType]
alIsEvaluationCompany	[!INCLUDEenvironmentType]
alTenantLicenseState	[!INCLUDEenvironmentType]
clientType	[!INCLUDEenvironmentType]
companyName	[!INCLUDEcompanyName]
environmentName	[!INCLUDEenvironmentName]
environmentType	[!INCLUDEenvironmentType]

Request sent to Azure function succeeded

Occurs when a request to an Azure function hosted from the URL {alFunctionHost} succeeded.

General dimensions

Dimension	Description or value
message	Request sent to Azure function succeeded: {alFunctionHost}

Custom dimensions

Dimension	Description or value
eventId	AL0000I74
alStatusCode	The HTTP status code for the request.

Request sent to Azure function failed

Occurs when a request to an Azure function hosted from the URL {alFunctionHost} failed.

General dimensions

Dimension	Description or value
message	Request sent to Azure function failed: {alFunctionHost}

Custom dimensions

Dimension	Description or value
eventId	AL0000I7P
alStatusCode	The HTTP status code for the request.

Sample KQL code

This KQL code can help you get started analyzing and alerting on request failures to Azure functions:

traces
| where timestamp > ago(5d) // adjust as needed
| where customDimensions.eventId == 'AL0000I7P'
| project timestamp
, aadTenantId = customDimensions.aadTenantId
, environmentName = customDimensions.environmentName
, environmentType = customDimensions.environmentType
, companyName = customDimensions.companyName
, requestStatusCode = customDimensions.alStatusCode
, functionHost = customDimensions.alFunctionHost

[!INCLUDEtelemetry_alert_learn_more]

Authorization failed to Azure function

Occurs when the environment was scheduled to be updated, but it wasn't possible to start the update within the update window defined in the Business Central admin center. For more information about the update window in the admin center, see Managing Updates in the Business Central Admin Center.

General dimensions

Dimension	Description or value
message	Authorization failed to Azure function: {alFunctionHost}

Custom dimensions

Dimension	Description or value
eventId	AL0000I75
alErrorText	The reason for the failure.

Sample KQL code

This KQL code can help you get started analyzing and alerting on failures to authorize to Azure functions:

traces
| where timestamp > ago(5d) // adjust as needed
| where customDimensions.eventId == 'AL0000I75'
| project timestamp
, aadTenantId = customDimensions.aadTenantId
, environmentName = customDimensions.environmentName
, environmentType = customDimensions.environmentType
, companyName = customDimensions.companyName
, errorText = customDimensions.alErrorText
, functionHost = customDimensions.alFunctionHost

[!INCLUDEtelemetry_alert_learn_more]

See also

Monitoring and Analyzing Telemetry
Enable Sending Telemetry to Application Insights
Alert on Telemetry
Connecting to Azure Functions
Overview of the System Application