The Consultingwerk Telemetry Toolkit

The Consultingwerk Telemetry Toolkit is the standalone version of the Telemetry Toolkit included and integrated into the SmartComponent Library.

The Consultingwerk Telemetry Toolkit consists of the SmartComponent Library Telemetry Service and its dependencies, procedures that allow the toolkit to bootstrap itself, and various code that performs the measurement of requests made to the AppServer. A standalone GUI viewer for Windows Desktops that visualizes and allows to filter the telemetry data is included, although the data produced can easily be consumed by any Application Performance Management (APM) tool.

The Telemetry Toolkit gathers basic information when any request is made to an AppServer. This includes a unique identifier for the request, the request’s execution time, the current user and domain and the service interface called (i.e. the first program run in the request). Data for each request is written into a file, using a standard NDJSON format.

Due to the varied nature of applications – in terms of things like authentication, toolkits and frameworks used, application architectures and error handling - each application should be instrumented to capture additional, relevant data using the Telemetry Service.

This data may include, for example:

• Errors and stop conditions raised on while executing a request,
• The URI and HTTP method for the request,
• What ABL queries are being run,
• VST data on those queries’ executions,
• The name of the service being run (as opposed to the service interface), and potentially the requested function/method