Телеметрия

Для сборки телеметрии используется инструментарий OpenTelemetry.

Затрагиваемые пресеты

• node — формирование начальных данных (Resource, rootSpan) и транспорта (Exporter);
• node-handler — отправка данных при обращении к точкам входа, генерации вёрстки, запросов к API средствами Axios/fetch (span).

Настройка Exporter

Конфигурация инструмента выгрузки опциональна.

Переменная окружения	Описание	Значение по-умолчанию
OTEL_EXPORTER_OTLP_URL	URL коллектора телеметрии.	http://localhost:4317

Как можно заметить в значении указывается протокол передачи — это намеренно так как выгрузка возможна в Unix domain socket (sock://).

Для расширенной настройки передатчика данных см. документацию пакета @opentelemetry/exporter-trace-otlp-grpc

Объявление и обогащение данных ресурса (Resource)

Основные данные ресурса предзаполнены и не требуют декларирования.

Аттрибут	Описание	Значение по-умолчанию
service.name	Название сервиса (service-name)	KnownTokens.Config.base -> appName
service.version	Версия сервиса (1.0.0)	KnownTokens.Config.base -> appVersion
deployment.environment.name	Тип окружения (production | development)	KnownTokens.Config.base -> env

Также есть возможность дополнить или переписать данные через переменную окружения OTEL_RESOURCE_ATTRIBUTES. Подробнее — документация OTEL.