Telemetry in CentralQ Chat¶
CentralQ Chat integrates telemetry to gain insights into the app's use, helping to improve features and user experience. Below is an index of telemetry events and their descriptions.
Business Central Telemetry Events¶
AL0001CHS - Chat Session Started¶
This event is triggered when a user begins a new chat session, allowing us to understand user engagement.
AL0021UNS - App Uninstalled from Business Central¶
This event is important for understanding the app's lifecycle and reasons for uninstallation.
AL0001CCO - Connect CentralQ Cloud Opened¶
This event is triggered when a user opens the Connect CentralQ Cloud, allowing us to understand user engagement.
AL0002CCF - Connect CentralQ Cloud Finished¶
This event is triggered when a user finishes connecting to CentralQ Cloud, allowing us to understand user engagement.
AL0003CCE - Use Existing Chat Id¶
This event is triggered when a user uses an existing chat id, during the connection to CentralQ Cloud.
AL0004CCN - New Chat Id Generated¶
This event is triggered when a user generates a new chat id, during the connection to CentralQ Cloud.
AL0005CCA - Authenticated Successfully¶
This event is triggered when a user successfully authenticates to CentralQ Cloud.
AL0006CCE - Authentication Failed¶
This event is triggered when a user fails to authenticate to CentralQ Cloud.
AL0007CCR - Registered Successfully¶
This event is triggered when a user successfully registers new CentralQ Cloud account.
AL0008CCE - Registration Failed¶
This event is triggered when a user fails to register new CentralQ Cloud account.
AL0009CCE - Acquire Authentication Token Failed¶
This event is triggered when a user fails to acquire authentication token from CentralQ Cloud.
AL0010CCU - Used Connection to CentralQ Cloud¶
This event is triggered when a user uses an existing connection to CentralQ Cloud.
AL0011CT0 - Chat Opened¶
This event is triggered when a user opens a new chat session, allowing us to understand user engagement.
AL0012CCC - Connect CentralQ Cloud Opened from Chat¶
This event is triggered when Connect CentralQ Cloud automatically opened the from the chat, allowing us to understand user engagement.
AL0013CCS - Connect CentralQ Cloud Opened from Setup¶
This event is triggered when Connect CentralQ Cloud manually opened the from the setup, allowing us to understand user engagement.
AL0014CTL - Microsoft Learn Used¶
This event is triggered when Microsoft Learn option is active during chat session.
AL0015CTC - Community Knowledge Used¶
This event is triggered when Community Knowledge option is active during chat session.
AL0016CTP - Private Knowledge Used¶
This event is triggered when Private Knowledge option is active during chat session.
AL0017MLD - Microsoft Learn Setup Discovered¶
This event is triggered when Microsoft Learn setup is discovered.
AL0018MLC - Microsoft Learn Setup Changed¶
This event is triggered when Microsoft Learn setup is changed.
AL0019MLE - Microsoft Learn Enabled¶
This event is triggered when Microsoft Learn is enabled.
AL0020MLD - Microsoft Learn Disabled¶
This event is triggered when Microsoft Learn is disabled.
AL0021MLU - Microsoft Learn Used¶
This event is triggered when Microsoft Learn is used.
AL0022CKD - Community Knowledge Setup Discovered¶
This event is triggered when Community Knowledge setup is discovered.
AL0023CKC - Community Knowledge Setup Changed¶
This event is triggered when Community Knowledge setup is changed.
AL0024CKE - Community Knowledge Enabled¶
This event is triggered when Community Knowledge is enabled.
AL0025CKD - Community Knowledge Disabled¶
This event is triggered when Community Knowledge is disabled.
AL0026CKU - Community Knowledge Used¶
This event is triggered when Community Knowledge is used.
AL0027PKD - Private Knowledge Setup Discovered¶
This event is triggered when Private Knowledge setup is discovered.
AL0028PKC - Private Knowledge Setup Changed¶
This event is triggered when Private Knowledge setup is changed.
AL0029PKE - Private Knowledge Enabled¶
This event is triggered when Private Knowledge is enabled.
AL0030PKD - Private Knowledge Disabled¶
This event is triggered when Private Knowledge is disabled.
AL0031PKU - Private Knowledge Used¶
This event is triggered when Private Knowledge is used.
AL0032PKO - Private Knowledge Opened¶
This event is triggered when Private Knowledge is opened.
AL0033IAE - Insights Agent Enabled¶
This event is triggered when the Insights Agent is enabled.
AL0034IAD - Insights Agent Disabled¶
This event is triggered when the Insights Agent is disabled.
AL0035IAS - Setup Insights Agent Opened from Setup¶
This event is triggered when the Insights Agent setup is opened from the Setup page.
AL0033FUD - File Upload Initiated¶
This event is triggered when a user initiates a file upload, allowing us to understand user engagement.
AL0034FUS - File Upload Started¶
This event is triggered when a user starts a file upload, allowing us to understand user engagement.
AL0035FUP - File Passed Validation¶
This event is triggered when a user passes file validation, allowing us to understand user engagement.
AL0036FUC - File Upload Completed¶
This event is triggered when a user completes a file upload, allowing us to understand user engagement.
AL0037FUX - File Validation Failed¶
This event is triggered when a user fails to validate a file, allowing us to understand user engagement.
AL0038FUE - File Extension is Supported¶
This event is triggered when a user uploads a file with a supported extension, allowing us to understand user engagement.
AL0039FUX - File Extension is Not Supported¶
This event is triggered when a user uploads a file with an unsupported extension, allowing us to understand user engagement.
AL0040FUX - Not Supported File Extension Value¶
This event is triggered when a user uploads a file with an unsupported extension value, and shows the name of the extension, allowing to collect data about unsupported extensions.
AL0041FUZ - File Size¶
This event is triggered when a user uploads a file, and shows the size of the file, allowing to collect data about file sizes.
AL0042FUX - File Size is Too Large¶
This event is triggered when a user uploads a file that is too large, and shows the size of the file, allowing to collect data about file sizes.
AL0043FUV - New File Version Upload Initiated¶
This event is triggered when a user initiates a new file version upload, allowing us to understand user engagement.
AL0044FUV - New File Version Uploaded¶
This event is triggered when a user uploaded a new file version, allowing us to understand user engagement.
AL0045FUE - File Content Embedding Initiated¶
This event is triggered when a user initiates a file content embedding.
AL0046FUX - File Content Embedding Failed¶
This event is triggered when a user fails to embed file content.
AL0047UUE - Url Content Embedding Initiated¶
This event is triggered when a user initiates a url content embedding.
AL0048UUX - Url Content Embedding Failed¶
This event is triggered when a user fails to embed url content.
AL0049UUD - Url Upload Initiated¶
This event is triggered when a user initiates a url upload.
AL0050UUS - Url Upload Started¶
This event is triggered when a user starts a url upload.
AL0051UUP - Url Passed Validation¶
This event is triggered when a user passes url validation.
AL0052UUC - Url Upload Completed¶
This event is triggered when a user completes a url upload.
AL0053FDD - File Download Initiated¶
This event is triggered when a user initiates a file download.
AL0054FDS - File Download Started¶
This event is triggered when a user starts a file download.
AL0055FDP - File Download Started¶
This event is triggered when a user passes file download validation.
AL0056FDC - File Download Completed¶
This event is triggered when a user completes a file download.
AL0057UUD - Url Deleted¶
This event is triggered when a user deletes a url.
AL0058FUD - File Deleted¶
This event is triggered when a user deletes a file.
AL0059FUX - File Deletion Failed¶
This event is triggered when a user fails to delete a file.
AL0060UUX - Url Deletion Failed¶
This event is triggered when a user fails to delete a url.
AL0061STO - Statistics Opened¶
This event is triggered when a user opens the statistics page.
AL0062FUE - Uploaded File Extension Value¶
This event is triggered when a user uploads a file, and shows the name of the extension, allowing to collect data about file extensions.
AL0063UUV - New Url Version Upload Initiated¶
This event is triggered when a user initiates a new url version upload, allowing us to understand user engagement.
AL0064UUV - New Url Version Uploaded¶
This event is triggered when a user uploaded a new url version, allowing us to understand user engagement.
AL0065PKF - No Permission to Manage Private Data¶
This event is triggered when a user tries to manage private data without permission.
AL0066FPD - Page Scripting File Upload Initiated¶
This event is triggered when a user initiates a page scripting file upload.
AL0067FPS - Page Scripting File Upload Started¶
This event is triggered when a user starts a page scripting file upload.
AL0068FPP - Page Scripting File Passed Validation¶
This event is triggered when a user passes page scripting file validation.
AL0069FPC - Page Scripting File Upload Completed¶
This event is triggered when a user completes a page scripting file upload.
AL0070UPD - Page Scripting Url Upload Initiated¶
This event is triggered when a user initiates a page scripting url upload.
AL0071UPS - Page Scripting Url Upload Started¶
This event is triggered when a user starts a page scripting url upload.
AL0072UPP - Page Scripting Url Passed Validation¶
This event is triggered when a user passes page scripting url validation.
AL0073UPC - Page Scripting Url Upload Completed¶
This event is triggered when a user completes a page scripting url upload.
AL0074FPD - Page Scripting User Manual Edit Initiated¶
This event is triggered when a user initiates a generated page scripting user manual edit.
AL0075FPS - Page Scripting User Manual Edit Started¶
This event is triggered when a user starts a generated page scripting user manual edit.
AL0076FPC - Page Scripting User Manual Edit Completed¶
This event is triggered when a user completes a generated page scripting user manual edit.
AL0077FDD - User Manual Download to Word Initiated¶
This event is triggered when a user initiates a user manual download to Word.
AL0078FDS - User Manual Download to Word Started¶
This event is triggered when a user starts a user manual download to Word.
AL0079FDC - User Manual Download to Word Completed¶
This event is triggered when a user completes a user manual download to Word.
AL0080FDD - User Manual Download to MD Initiated¶
This event is triggered when a user initiates a user manual download to Markdown.
AL0081FDS - User Manual Download to MD Started¶
This event is triggered when a user starts a user manual download to Markdown.
AL0082FDC - User Manual Download to MD Completed¶
This event is triggered when a user completes a user manual download to Markdown.
AL0083CSD - Setup Record Deleted, Associated Secrets Cleared¶
This event is triggered when a setup record is deleted, and associated secrets are cleared.
AL0084IAS - Insights Agent Client Secret is Cleared¶
This event is triggered when the Insights Agent client secret is cleared.
AL0085IAT - Insights Agent Client Secret is Set¶
This event is triggered when the Insights Agent client secret is set.
AL0086IAU - Insights Agent Client Secret is Not Set¶
This event is triggered when an attempt to get the Insights Agent client secret finds it is not set.
AL0087IAV - Insights Agent Client Secret Get Failed¶
This event is triggered when getting the Insights Agent client secret fails due to an IsolatedStorage issue.
AL0088CCC - CentralQ Cloud Connection Cleared (Table Trigger)¶
This event is triggered when the CentralQ Cloud connection is cleared via a table trigger.
AL0089IAC - Insights Agent Setup Cleared (Table Trigger)¶
This event is triggered when the Insights Agent setup is cleared via a table trigger.
AL0090IAC - Insights Agent Setup Cleared via Setup Page Action¶
This event is triggered when the Insights Agent setup is cleared via an action on the Setup Page.
AL0091CCC - CentralQ Cloud Connection Cleared via Setup Page Action¶
This event is triggered when the CentralQ Cloud connection is cleared via an action on the Setup Page.
AL0092IBD - Failed to Acquire Access Token (HTTP Send Error)¶
This event is triggered when acquiring the access token fails due to an HTTP send error.
AL0093IBE - Failed to Acquire Access Token (HTTP Non-success Status)¶
This event is triggered when acquiring the access token fails because the HTTP response status was not successful.
AL0094IBF - Failed to Acquire Access Token (Token Not Found in Response)¶
This event is triggered when acquiring the access token fails because the token was not found in the HTTP response.
AL0095IAZ - Access Token Acquired Successfully¶
This event is triggered when the access token is acquired successfully.
AL0096IBB - Successfully Connected to Business Central API (Test Connection)¶
This event is triggered when the connection test to the Business Central API is successful.
AL0097IBC - Failed to Connect to Business Central API (Test Connection)¶
This event is triggered when the connection test to the Business Central API fails.
AL0098CTI - Insights Agent Used¶
This event is triggered when the Insights Agent is used during a chat session.
AL0099INS - Insights Agent Feature Uptake¶
This event is triggered to log the uptake status of the Insights Agent feature, specifically when it's used.
AL0100IAW - Insights Agent Discovered (Feature Uptake)¶
This event is triggered when the Insights Agent feature is discovered by the user, typically via a notification or wizard prompt.
AL0101IWS - Insights Agent Wizard Opened from Notification¶
This event is triggered when the Insights Agent setup wizard is opened directly from the enablement notification.
AL0102IAD - Insights Agent Notification Dismissed¶
This event is triggered when the user dismisses the notification prompting them to enable the Insights Agent.
AL0103IAS - Insights Agent Notification Shown¶
This event is triggered when the notification prompting the user to enable the Insights Agent is shown.
AL0104IAD - Insights Agent Setup Discovered¶
This event is triggered when the Insights Agent feature is discovered in the Setup page.
AL0105IAC - Insights Agent Setup Changed¶
This event is triggered when Insights Agent setup is changed in the Setup page.
AL0106IAW - Insights Agent Wizard Discovered¶
This event is triggered when the Insights Agent Wizard page is opened/discovered.
AL0107IAX - Insights Agent Wizard Setup Completed¶
This event is triggered when the Insights Agent Wizard setup process is completed successfully.
AL0108IAY - Insights Agent Setup Completed¶
This event is triggered when the Insights Agent setup is fully completed.
WebApp Telemetry Events¶
PY0065CHS - Chat Session Started¶
This event is triggered when a user starts a new chat session, allowing us to understand user engagement.
PY0066CHQ - New Question Asked¶
This event is triggered when a user asks a new question, allowing us to understand user engagement. Question text is included in the event.
PY0067CHQ - Follow-up Question Asked¶
This event is triggered when a user asks a follow-up question, allowing us to understand user engagement. Question text is included in the event, as well as the conversation history.
PY0068CHA - Answer Generated¶
This event is triggered when a user receives an answer, allowing us to understand user engagement. Answer text is included in the event, as well as the conversation history and sources used to generate the answer (with text and metadata).
PY0069CHL - Maximum Monthly Requests Limit Reached¶
This event is triggered when a user reaches the maximum monthly requests limit
PY0070CHR - Question Rephrased¶
This event is triggered when question is automatically rephrased by the AI. Original question text is included in the event.
PY0071CHP - Private Knowledge Found¶
This event is triggered when Private Knowledge is found for the question. Question text is included in the event, as well as private knowledge metadata.
PY0072CHM - Microsoft Learn Found¶
This event is triggered when Microsoft Learn is found for the question. Question text is included in the event, as well as Microsoft Learn metadata.
PY0073CHC - Community Knowledge Found¶
This event is triggered when Community Knowledge is found for the question. Question text is included in the event, as well as Community Knowledge metadata.
PY0074CHF - Positive Feedback¶
This event is triggered when a user submits positive feedback for the answer. Answer text is included in the event, as well as the conversation history and sources used to generate the answer (with text and metadata).
PY0075CHF - Negative Feedback¶
This event is triggered when a user submits negative feedback for the answer. Answer text is included in the event, as well as the conversation history and sources used to generate the answer (with text and metadata).
PY0076CCE - Invalid Access Token¶
This event is triggered when a user fails to authenticate to CentralQ Cloud, due to Access token is not valid.
PY0077CCE - Access Token is Missing¶
This event is triggered when a user fails to authenticate to CentralQ Cloud, due to Access token is missing.
PY0078CCE - Chat Id is Missing¶
This event is triggered when a user fails to authenticate to CentralQ Cloud, due to Chat Id is missing.
PY0079CCE - Secret Key is Missing¶
This event is triggered when a user fails to authenticate to CentralQ Cloud, due to Secret Key is missing.
PY0080CCE - Authentication Failed¶
This event is triggered when a user fails to authenticate to CentralQ Cloud.
PY0081CCS - Authenticated Successfully¶
This event is triggered when a user successfully authenticates to CentralQ Cloud.
PY0082CHR - Related Queries Generated¶
This event is triggered when related queries are generated for the question. Question text is included in the event, as well as related queries.
PY0085CHI - Intent Detected¶
This event is triggered when the intent of a user's query is detected, determining whether it's a guidance question or a data insights question.
PY0086CHE - Data Insights API Fetch Unexpected Error¶
This event is triggered when an unexpected error occurs during fetching APIs for the Data Insights agent.
PY0087CHG - Data Insights Code Generated¶
This event is triggered when Python code is successfully generated by the LLM for a data insights query.
PY0088CHA - Data Insights Result Generated¶
This event is triggered when the Data Insights agent successfully completes a data analysis and generates results.
PY0089CHS - Data Insights Code Executed Successfully¶
This event is triggered when the Python code generated for data analysis executes successfully and returns a valid result dictionary.
PY0090CHE - Data Insights Helper Code Error¶
This event is triggered when there's an error loading the helper code for the Data Insights agent.
PY0091CHE - Data Insights Build Script Error¶
This event is triggered when there's an unexpected error during the building of the execution script for data analysis.
PY0092CHE - Data Insights Execution Error¶
This event is triggered when there's an error during the execution of the generated Python code for data analysis.
PY0093CHI - Data Insights Result Interpreted¶
This event is triggered when the Data Insights agent successfully interprets the results of the data analysis.
PY0094CHE - Data Insights Interpret Error¶
This event is triggered when there's an error during the interpretation of data analysis results.
PY0095CHG - Data Insights Corrected Code Generated¶
This event is triggered when the LLM generates corrected Python code after an execution failure. This helps track how often code corrections are needed and their performance characteristics. The event includes telemetry data about the correction process such as input/output tokens, generation time, and other contextual information.
Telemetry Data Compliance¶
All telemetry data is collected in compliance with privacy laws and regulations. Users are informed of the data collection.