Manage telemetry setup

The Telemetry Setup page controls whether telemetry data collection is active for the current company. Telemetry collects usage and configuration metrics from installed Aptean extensions and submits them automatically during the license and subscription refresh cycle. The following procedure describes how to access and configure telemetry.

1. Select the Search icon , enter Telemetry Setup, and then choose the related link.
   The Telemetry Setup page opens.

2. On the General FastTab, turn on the Enable Telemetry toggle to activate telemetry data collection for the current company, which ensures telemetry is automatically submitted during each license refresh. This toggle is turned on by default.

   The Enable Telemetry toggle setting applies per company. To disable telemetry for a specific company, open the Telemetry Setup page within that company and turn off the toggle.

3. On the action bar, select Custom Dimension Id to view the data dimensions for which permission has been granted for collection.
   The Custom Dimension Id page opens.

   You can view the telemetry data collection rules defined using custom dimension IDs. Each entry specifies a Business Central table, an aggregation action, optional field IDs, and a filter query. Only administrators have permission to add, modify, or delete these entries. Telemetry data is collected for all active entries during the license refresh cycle.

   You can view the following fields:

   Field	Description
   Custom Dimension ID	Specifies a unique identifier code for this custom dimension entry.
   Table ID	Specifies the ID of the Business Central table from which data is collected.
   Action	Specifies the type of data operation to perform on the table. See the action values table below.
   Field01	Specifies the field ID of the first field to include in the telemetry data.
   Field02	Specifies the field ID of the second field to include in the telemetry data.
   Field03	Specifies the field ID of the third field to include in the telemetry data
   Field04	Specifies the field ID of the fourth field to include in the telemetry data.
   Filter Query	Specifies an optional filter query to restrict which records are evaluated for this dimension.

   The following table lists the supported actions and their descriptions.

   Action	Description
   LIST (MAX 50)	Returns a list of records from the table, up to a maximum of 50 records. The values of Field01–Field04 are included for each record.
   EXISTS	Returns whether any records matching the filter query exist in the table.
   COUNT	Returns the total count of records matching the filter query.
   SUM	Returns the sum of the values in Field01 for records matching the filter query.
   MIN	Returns the minimum value of Field01 across records matching the filter query.
   MAX	Returns the maximum value of Field01 across records matching the filter query.