CnOps 智能运维与可观测社区
首页开源项目实践文章视频课程常见问答开发者工具STAROps 专题
导航菜单
首页开源项目实践文章视频课程常见问答开发者工具STAROps 专题

CnOps 智能运维与可观测社区

愿景

CnOps 智能运维与可观测社区是一个以"智能运维与可观测"为核心的开放、包容、分享的技术社区,旨在聚集运维专家、开发者和爱好者,共同探讨、学习和分享可观测最佳实践与最新技术,与众多技术社区合作互动,共同探讨交叉领域的技术挑战,推动可观测领域的创新与进步。

内容社区

  • 实践文章
  • 视频课程
  • 开源项目
  • 常见问答
  • 开发者工具

友情链接

  • Prometheus
  • Grafana Lab
  • OpenTelemetry
  • LoongCollector

关注我们

阿里云云原生公众号阿里云云原生
阿里云可观测公众号阿里云可观测

Copyright © 2026 CnOps 社区. All rights reserved.

首页/开源项目/OpenTelemetry/JavaScript 零代码插桩
文档目录
文档开始手动插桩使用插桩库导出器资源采样什么是 OpenTelemetry?
API 参考文档示例
PHP 零代码插桩
支持库列表

OpenTelemetry

JavaScript 零代码插桩

JavaScript 零代码插桩方案为 Node.js 应用提供了一种插桩方式,无需修改任何代码,即可对任意 Node.js 应用进行插桩,并采集众多主流类库与框架的遥测数据。 运行以下命令安装相应的包。 @opentelemetry/api 和 @opentelemetry/auto-instrumentations-node 包会安装 API、SDK 和插桩工具。 该模块具有高度的可配置性。...

JavaScript 零代码插桩方案为 Node.js 应用提供了一种插桩方式,无需修改任何代码,即可对任意 Node.js 应用进行插桩,并采集众多主流类库与框架的遥测数据。

设置 {#setup}

运行以下命令安装相应的包。

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

@opentelemetry/api 和 @opentelemetry/auto-instrumentations-node 包会安装 API、SDK 和插桩工具。

配置该模块 {#configuring-the-module}

该模块具有高度的可配置性。

一种选择是通过命令行界面(CLI)利用 env 命令设置环境变量来配置模块:

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 只启用特定的探测器,或完全禁用它们。

要查看完整的配置选项列表,请参阅模块配置。

支持的库和框架 {#supported-libraries-and-frameworks}

许多流行的 Node.js 库都支持自动插桩。完整列表请参阅支持的插桩。

故障排除 {#troubleshooting}

你可以通过将 OTEL_LOG_LEVEL 环境变量设置为以下值之一来设置日志级别:

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

默认级别是 info。

  • 在生产环境中,建议将 OTEL_LOG_LEVEL 设置为 info。
  • 无论环境或调试级别如何,日志始终发送到 console。
  • 调试日志非常详细,可能会对应用程序的性能产生负面影响。仅在需要时启用调试日志。

文章大纲