Introduction
If you want to profile the CoreOne Suite you can simply activate the appropriate tracing in the configuration. F
Step 1 - Make your infrastructure ready
You will need an Open Telementry Collector and a data visualization tool such as ELK-stack and APM.
Step 2 - Application configuration
Frontends
Each of the frontends has an application configuration file in C:\ProgramData\itsense\Configuration
.
These are the files that matter:
Application Part | File |
---|---|
Auth |
|
Selfservice Portal |
|
Admin UI |
|
Admin UI v2 |
|
In that file, you can add the following settings (by using Machine Crypto
of COS Configuration Manager) :
"UseOpenTelemetry": true, "OpenTelemetryCollectorEndpoint": "https://otlp-gateway-prod-eu-west-2.grafana.net/otlp/v1/traces", "OpenTelemetryCollectorMetricsEndpoint": "https://otlp-gateway-prod-eu-west-2.grafana.net/otlp/v1/metrics", "OpenTelemetryCollectorHeaders": "Authorization=Basic NjkyODA0...2prd01EUTVPSDA9", "OpenTelemetryCollectorProtocol": "HttpProtobuf"
Simply enable OpenTelemetry and configure the appropriate endpoints, headers and the protocol.
Please note that OpenTelemetryCollectorHeaders
contains how we authenticate to the telemetry system. This can be a Bearer Token, Basic Auth or an API key. It may also be empty if no authentication is needed.
In order for changed settings to take effect, the corresponding App Pool needs to be recycled! See https://itsense.atlassian.net/wiki/spaces/IKB/pages/2811527209/How-to+enable+application+tracing#Step-3---Restart
Backend
For the backend, the settings are stored in the database.
update config_setting_value set int_value = 0 where config_setting_code_id = 54; update config_setting_value set string_value = 'http://localhost:4318/v1/traces' where config_setting_code_id = 55; update config_setting_value set string_value = '' where config_setting_code_id = 56; update config_setting_value set string_value = 'HttpProtobuf' where config_setting_code_id = 57; update config_setting_value set string_value = 'http://localhost:4318/v1/metrics' where config_setting_code_id = 58;
Step 3 - Restart
After you have applied the settings, you will need to restart the corresponding parts:
For Frontend Applications, the Application Pools within IIS need to be recycled
For Backend / WF Runner, the corresponding services need to be restarted.