Інструментування JavaScript без коду

Інструментування JavaScript без коду надає спосіб інструментувати будь-який застосунок Node.js та захоплювати телеметричні дані з багатьох популярних бібліотек і фреймворків без змін у коді.

Налаштування

Виконайте наступні команди для встановлення відповідних пакунків.

npm install --save @opentelemetry/api
npm install --save @opentelemetry/auto-instrumentations-node

Пакунки @opentelemetry/api та @opentelemetry/auto-instrumentations-node встановлюють API, SDK та інструменти інструментування.

Налаштування модуля

Модуль має широкі можливості конфігурації.

Один з варіантів налаштування модуля — використання env для встановлення змінних середовища з CLI:

env OTEL_TRACES_EXPORTER=otlp OTEL_EXPORTER_OTLP_TRACES_ENDPOINT=your-endpoint \
node --require @opentelemetry/auto-instrumentations-node/register app.js

Альтернативно, ви можете використовувати export для встановлення змінних середовища:

export OTEL_TRACES_EXPORTER="otlp"
export OTEL_EXPORTER_OTLP_ENDPOINT="your-endpoint"
export OTEL_NODE_RESOURCE_DETECTORS="env,host,os"
export OTEL_SERVICE_NAME="your-service-name"
export NODE_OPTIONS="--require @opentelemetry/auto-instrumentations-node/register"
node app.js

Стандартно використовуються всі детектори ресурсів SDK. Ви можете використовувати змінну середовища OTEL_NODE_RESOURCE_DETECTORS для включення лише певних детекторів або для повного їх відключення.

Щоб побачити повний спектр налаштувань, дивіться Налаштування модуля.

Підтримувані бібліотеки та фреймворки

Автоматично інструментуються багато популярних бібліотек Node.js. Для повного списку, дивіться підтримувані інструментування.

Розвʼязання проблем

Ви можете встановити рівень логування, встановивши змінну середовища OTEL_LOG_LEVEL на одне з наступних значень:

• none
• error
• warn
• info
• debug
• verbose
• all

Стандартний рівень — info.