Analyzing field monitoring telemetry

APPLIES TO: Business Central 2020 release wave 2 (update 17.1) and later

Keeping sensitive data secure and private is a core concern for most businesses. To add a layer of security, you can monitor important fields when someone changes a value. For example, you might want to know if someone changes your company's IBAN number.

To gather this data, you'll have to start field monitoring and specify the fields that you want to monitor. Learn more in Auditing Changes in Business Central - Monitoring Sensitive Fields in the Application help.

Telemetry is then logged for the following operations:

  • When field monitoring is stopped or started
  • When a field is added or removed for monitoring (only in version 18.0 and later)
  • When a field value is changed

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

Sensitive field monitor status changed

Occurs when the field monitor feature is started or stopped in the company.

General dimensions

DimensionDescription or value
messageSensitive field monitor status has changed to {alMonitorStatus}
severityLevel1
user_IdThe user telemetry ID for the user. From the user card, you can use user_Id to identify the user who triggered this telemetry event. Learn more in Assign a telemetry ID to users.

Custom dimensions

DimensionDescription or value
eventIdAL0000DD3
alMonitorStatusYes - the field monitor feature was started.

No the field monitor feature was stopped. This dimension is called "almonitorStatus" before version 18.0.

Common custom dimensions

The following table explains other custom dimensions that are common to all field monitoring traces.

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.
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.

Sensitive field value has changed

Occurs when the value of a monitored field has changed in the company.

General dimensions

DimensionDescription or value
messageSensitive field value has changed: {alFieldCaption} ({alFieldNumber}) in table {alTableCaption} ({alTableNumber})
severityLevel1
user_IdThe user telemetry ID for the user. From the user card, you can use user_Id to identify the user who triggered this telemetry event. Learn more in Assign a telemetry ID to users.

Custom dimensions

DimensionDescription or value
eventIdAL0000CTE
alFieldCaptionSpecifies the name of the field that was changed. This dimension is called "alfieldCaption" before version 18.0.
alFieldNumberSpecifies the ID of the field that was changed. This dimension was introduced in version 18.0.
alTableCaptionSpecifies the name of the table that includes the changed field. This dimension is called "altableCaption" before version 18.0.
alTableNumberSpecifies the ID of the table that includes the changed field. This dimension was introduced in version 18.0.
See common custom dimensions

Note

Changes to fields in the following tables are always logged:

  • Fields in the Field Monitoring Setup table, except Notification Count. Many of the fields are included on the Field Monitoring Setup page.
  • Fields in the Change Log Setup (Field) table. For monitored fields, only changes to Table No., Field No., and Notify are logged. Many of the fields are included on the Field Monitoring Worksheet page.
  • The Contact Email field in the User table.

Sensitive field added to or removed from monitor

Occurs when a field has been added to or removed from monitoring. This event was introduced in version 18.0.

General dimensions

DimensionDescription or value
messageSensitive field added to monitor: {alFieldCaption} ({alFieldNumber}) in table {alTableCaption} ({alTableNumber})
or
Sensitive field removed from monitor: {alFieldCaption} ({alFieldNumber}) in table {alTableCaption} ({alTableNumber})
severityLevel1
user_IdThe user telemetry ID for the user. From the user card, you can use user_Id to identify the user who triggered this telemetry event. Learn more in Assign a telemetry ID to users.

Custom dimensions

DimensionDescription or value
eventIdAL0000EMW
alFieldCaptionSpecifies the name of the field that was added or removed.
alFieldNumberSpecifies the ID of the field that was added or removed.
alTableNumberSpecifies the ID of the table that includes the added or removed field.
alTableCaptionSpecifies the name of the table that includes the added or removed field.
See common custom dimensions

Changelog configuration telemetry Monitoring and Analyzing Telemetry
Enable Sending Telemetry to Application Insights
Alert on telemetry