JavaScript 数据采集
安装
运行以下命令安装软件包:
npm install --save @opentelemetry/api
npm install --save @opentelemetry/auto-instrumentations-node
配置模块
可以通过以下方式进行配置:
- env
- export
通过使用 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
要查看完整的配置选项,请参阅 配置说明。
支持的库和框架
很多流行的 Node.js 库都支持自动插桩,完整的支持列表请参见 兼容性列表。
故障排除
您可以通过将 OTEL_LOG_LEVEL
环境变量设置为以下一个来设置日志级别,默认是 info
:
- none
- error
- warn
- info
- debug
- verbose
- all
提示
- 在生产环境中,建议将
OTEL_LOG_LEVEL
设置为info
。 - 无论环境或调试级别如何,日志都会通过
console
输出到控制台 - 调试日志非常详细,可能会对应用程序的性能产生负面影响。仅在需要时启用调试记录。