@dash0/opentelemetry

中文文档
4.2.14发布于 2026/10/05Apache-2.0TypeScriptCommonJS构建来源已验证近 30 天下载 2171

Dash0 为节点.js 制作的 OpenTeleometry Wrapper

中文使用文档
文档目录11 节
  1. 配置
  2. DASH0 AUTOMATIC 服务 NAME
  3. (原始内容存档于2018-09-26) (中文(简体) ). DASH0 BOOSTRAP SPAN
  4. DASH0 DEBUG (德国语)
  5. DASH0 DEBUG PRINT SPAS
  6. DASH0 无差别
  7. DASH0 ENABLE FS 仪器
  8. DASH0 FLUSH ON 签名 签名
  9. DASH0 FLUSH ON EMPTY EVENT LOOP
  10. DASH0 OTEL COLLECTOR BASE URL(英语:
  11. 只允许特定仪器

Dash0 节点.js OpenTeleometry 分布

这是为Node.js设计的 Dash0 OpenTeleometry 分布. 它主要用于: Dash0 Kubernetes 运算符 改为 带有 OpenTeleometry 的仪器节点.js 工作量.

配置

DASH0 AUTOMATIC 服务 NAME

如果没有设置服务名,则通过读取主版本自动生成服务名和服务版本 package.json 文件 (如果有的话):

  • 这个 service.name 资源属性将设定为 name 属性 package.json 文档.
  • 这个 service.version 资源属性将设定为 version 属性 package.json 文档.

这种行为也可以被禁用

  • 使用 OTEL_SERVICE_NAME 环境变量,
  • 使用 OTEL_RESOURCE_ATTRIBUTES 环境变量(使用 service.name 属性键),或
  • 设置环境变量 DASH0_AUTOMATIC_SERVICE_NAME=false。 。 。 .

(原始内容存档于2018-09-26) (中文(简体) ). DASH0 BOOSTRAP SPAN

如果设置为非空字符串, 发行将会在启动时立即创建一个跨度, 跨度名称设置为 dASH0 BOOTSTRAP SPAN 的值.

DASH0 DEBUG (德国语)

可以通过设置启用额外的调试日志 DASH0_DEBUG=true。 。 。 .

DASH0 DEBUG PRINT SPAS

若为 DASH0_DEBUG_PRINT_SPANS=true ,所有跨度都被打印到 stdout 通过 控制台扩展输出器。 。 。 .

DASH0 无差别

完全禁用 Dash0 节点.js 分布 .

DASH0 ENABLE FS 仪器

默认情况下, 仪器插件 @opentelemetry/instrumentation-fs 已禁用。 设定 DASH0_ENABLE_FS_INSTRUMENTATION=true 以启用文件系统访问的跨度.

DASH0 FLUSH ON 签名 签名

若为 DASH0_FLUSH_ON_SIGTERM_SIGINT=true 设定, Dash0 节点.js 分布将安装一个处理器,用于 SIGTERM 和 SIGINT将关闭 OpenTeleometry SDK , 当收到其中一个信号时优雅的关闭. SDK的关闭时间为500毫秒. 信号处理器会呼叫 process.exit(0) 在SDK的关闭完成之后,或者在500毫秒之后 暂停,无论发生什么 更早. 如果您关心在过程终止前不久正在生成的遥测,此选项会有帮助. 如果监测中的应用程序有自己的SIGTERM或SIGINT的处理器,则不得使用这个选项,因为 Dash0的处理器(特别是必要的) process.exit(0) 可能干扰申请本身 信号处理器.

DASH0 FLUSH ON EMPTY EVENT LOOP

默认情况下, Dash0 节点.js 发行会安装一个钩子,当 OpenTeleometry SDK 优雅关闭时 节点.js运行时间即将出道,因为事件循环是空的. 通过设置可以禁用 DASH0_FLUSH_ON_EMPTY_EVENT_LOOP=false。 。 。 . SDK的关闭时间为500毫秒. 这个钩子可以帮助你,如果你关心 遥测方法正在生产 在过程前不久 出门. 如果在事件循环时注意进程尽快终止,则失效会很有用 空无相. 相对于SIGTERM/SIGINT的处理器(见上文),此钩将不调用 process.exit (自节点起) 运行时间会自行退出.

DASH0 OTEL COLLECTOR BASE URL(英语:

分发数据时将发送到的 OpenTeleometry 收藏器的基础 URL . 默认为 http://dash0-operator-opentelemetry-collector.dash0-operator-system.svc.cluster.local:4318。 。 。 .

只允许特定仪器

默认情况下,全部 辅助仪器 已启用(但 @opentelemetry/instrumentation-fs),但可以使用环境变量 OTEL_NODE_ENABLED_INSTRUMENTATIONS 通过提供以逗号分隔的列表,只允许某些仪器 没有设备包名称 @opentelemetry/instrumentation- 前缀.

例如,只允许 @ opleteometry/ 仪器- http 财务报告和审定财务报表 @ 开元/ 仪器- nestjs- core 设定的仪器 OTEL_NODE_ENABLED_INSTRUMENTATIONS="http,nestjs-core"。 。 。 .

见 https://github.com/open-teleometry/open-teleometry-js-contrib/blob/main/metapackages/auto-institutions-node/README.md#usage-auto-institution 互联网档案馆的存檔,存档日期2014-12-22 更多信息.

版本与发布记录

@dash0/opentelemetry 共发布 30 个版本,首次发布于 2025/07/14;过去 12 个月发布了 22 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
4.2.14latest2026/10/051 个月前
4.2.132026/08/043 个月前
4.2.122026/07/243 个月前
4.2.112026/06/224 个月前
4.2.102026/06/174 个月前
4.2.92026/06/174 个月前

关于 @dash0/opentelemetry 的常见问题

@dash0/opentelemetry 是什么?

Dash0 为节点.js 制作的 OpenTeleometry Wrapper

如何安装 @dash0/opentelemetry?

在项目目录运行 npm install @dash0/opentelemetry,或使用 pnpm add / yarn add / bun add。

@dash0/opentelemetry 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@dash0/opentelemetry 支持 ESM 还是 CommonJS?

以 CommonJS 形式发布,可以直接 require();在 ES Module 项目中也可以用 import 引入(Node.js 会把 module.exports 作为默认导出)。

@dash0/opentelemetry 可以商用吗?

@dash0/opentelemetry 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@dash0/opentelemetry 的下载量有多少?

根据 npm 官方下载统计,@dash0/opentelemetry 在 2026/10/12 – 2026/11/10 这 30 天内被下载 2,171 次,日均约 72 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@dash0/opentelemetry 还在维护吗?

最新版本 4.2.14 发布于 2026/10/05(1 个月前);至今共发布 30 个版本,其中过去 12 个月发布了 22 个;首次发布于 2025/07/14。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。