Table of Contents

Телеметрия

Сервер ЛЭРС экспортирует данные о своей функциональности в формате OpenTelemetry. Вы можете установить любой коллектор, который поддерживает формат OTLP, для того, чтобы собирать и отображать метрики работы сервера.

Конфигурация

Телеметрия настраивается с помощью переменных среды, которые описаны в спецификации Open Telemetry. Переменные среды можно задать различными способами. Если вы запускаете ЛЭРС УЧЁТ через docker, задайте их в секции environment вашего файла compose.yml.

Если вы установили систему на Windows, рекомендуем сделать следующее.

  1. Создайте в папке C:\Program Files\LERS\Server файл appsettings.Production.json.

  2. Задайте переменные среды в файле в таком виде:

    {
    "OTEL_EXPORTER_OTLP_ENDPOINT": "https://example.com/otlp"
}

  3. Перезапустите сервер ЛЭРС.

Пример конфигурации

Если вы установили коллектор, который принимает телеметрию на адресе https://example.com/otlp, вам потребуется установить следующие переменные среды

OTEL_EXPORTER_OTLP_ENDPOINT: "https://example.com/otlp"

После этого в ваш коллектор будут отправлены метрики, журналы и трейсы. Если вы хотите видеть только метрики, используйте переменную OTEL_EXPORTER_OTLP_METRICS_ENDPONT. В этом случае потребуется задать конечную точку, которая принимает только метрики. Обычно это будет что-то вроде https://example.com/otlp/v1/metrics.

В зависимости от вашего коллектора вам может потребоваться указать переменную OTEL_EXPORTER_OTLP_PROTOCOL. По умолчанию телеметрия отправляется в формате grpc. Однако, некоторые коллекторы принимают телеметрию только в формате protobuf. Тогда нужно будет указать значение OTEL_EXPORTER_OTLP_PROTOCOL: http/protobuf.