Edit

Analyzing metadata embeddings telemetry

APPLIES TO: Business Central online

Metadata embeddings telemetry tracks the lifecycle of embedding generation for extensions. Metadata embeddings are vector representations of extension metadata (such as pages, tables, and fields) that power AI-based features like Copilot search and suggestions.

This telemetry helps you monitor whether embedding generation completes successfully for your extensions and troubleshoot failures that might affect AI feature functionality.

Metadata embedding generation succeeded

Occurs when metadata embedding generation for an extension completes successfully.

General dimensions

Dimension Description or value
message Metadata embedding generation succeeded for extension {extensionId} version {extensionVersion}

Custom dimensions

Dimension Description or value
aadTenantId Specifies 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.
environmentName Specifies the name of the tenant environment. Learn more in Managing Environments.
environmentType Specifies the environment type for the tenant, such as Production or Sandbox. Learn more in Environment Types.
eventId LC0059
extensionId Specifies the GUID of the extension for which embeddings were generated.
extensionVersion Specifies the version of the extension for which embeddings were generated.

Sample KQL code

traces
| where timestamp > ago(60d)
| where customDimensions.eventId == 'LC0059'
| project timestamp
, message
, aadTenantId = customDimensions.aadTenantId
, environmentName = customDimensions.environmentName
, extensionId = customDimensions.extensionId
, extensionVersion = customDimensions.extensionVersion

Metadata embedding generation failed

Occurs when metadata embedding generation for an extension fails.

General dimensions

Dimension Description or value
message Metadata embedding generation failed for extension {extensionId} version {extensionVersion}

Custom dimensions

Dimension Description or value
aadTenantId Specifies 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.
environmentName Specifies the name of the tenant environment. Learn more in Managing Environments.
environmentType Specifies the environment type for the tenant, such as Production or Sandbox. Learn more in Environment Types.
eventId LC0060
extensionId Specifies the GUID of the extension for which embeddings generation failed.
extensionVersion Specifies the version of the extension.

Sample KQL code

traces
| where timestamp > ago(60d)
| where customDimensions.eventId == 'LC0060'
| project timestamp
, message
, aadTenantId = customDimensions.aadTenantId
, environmentName = customDimensions.environmentName
, extensionId = customDimensions.extensionId
, extensionVersion = customDimensions.extensionVersion

Metadata embedding generation scheduled

Occurs when metadata embedding generation for an extension is scheduled.

General dimensions

Dimension Description or value
message Metadata embedding generation scheduled for extension {extensionId} version {extensionVersion}

Custom dimensions

Dimension Description or value
aadTenantId Specifies 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.
environmentName Specifies the name of the tenant environment. Learn more in Managing Environments.
environmentType Specifies the environment type for the tenant, such as Production or Sandbox. Learn more in Environment Types.
eventId LC0061
extensionId Specifies the GUID of the extension for which embeddings generation was scheduled.
extensionVersion Specifies the version of the extension.

Sample KQL code

traces
| where timestamp > ago(60d)
| where customDimensions.eventId == 'LC0061'
| project timestamp
, message
, aadTenantId = customDimensions.aadTenantId
, environmentName = customDimensions.environmentName
, extensionId = customDimensions.extensionId
, extensionVersion = customDimensions.extensionVersion

Metadata embedding generation started

Occurs when metadata embedding generation for an extension starts processing.

General dimensions

Dimension Description or value
message Metadata embedding generation started for extension {extensionId} version {extensionVersion}

Custom dimensions

Dimension Description or value
aadTenantId Specifies 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.
environmentName Specifies the name of the tenant environment. Learn more in Managing Environments.
environmentType Specifies the environment type for the tenant, such as Production or Sandbox. Learn more in Environment Types.
eventId LC0062
extensionId Specifies the GUID of the extension for which embeddings generation started.
extensionVersion Specifies the version of the extension.

Sample KQL code

traces
| where timestamp > ago(60d)
| where customDimensions.eventId == 'LC0062'
| project timestamp
, message
, aadTenantId = customDimensions.aadTenantId
, environmentName = customDimensions.environmentName
, extensionId = customDimensions.extensionId
, extensionVersion = customDimensions.extensionVersion

Monitoring and Analyzing Telemetry
Enable Sending Telemetry to Application Insights
Alert on Telemetry