# @dash0/opentelemetry 中文文档

规范地址：https://npmcn.com/package/%40dash0/opentelemetry/

版本：4\.2\.14
npm 元数据更新时间：2026-10-05T09:55:02.916Z
中文译文更新时间：2026-11-11T14:41:40.184Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40dash0/opentelemetry
原文对照：https://npmcn.com/package/%40dash0/opentelemetry/?lang=original
项目主页：https://github.com/dash0hq/opentelemetry-js-distribution#readme
源码仓库：https://github.com/dash0hq/opentelemetry-js-distribution

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：371 kB，51 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- 运行依赖：26 个
- 首次发布：2025-07-14T07:31:39.425Z
- 最新版本发布：2026-10-05T09:55:02.212Z
- 近 30 天下载量：2171（2026-10-12 至 2026-11-10，npm 官方下载统计）
- 已发布版本数：30（近 12 个月 22 个）

## 中文简介

Dash0 为节点.js 制作的 OpenTeleometry Wrapper

## 安装

```sh
npm install @dash0/opentelemetry
```

也可以使用：`pnpm add @dash0/opentelemetry`、`yarn add @dash0/opentelemetry`、`bun add @dash0/opentelemetry`

## README

# Dash0 节点.js OpenTeleometry 分布

这是为Node.js设计的 Dash0 OpenTeleometry 分布. 它主要用于: [Dash0 Kubernetes 运算符](https://github.com/dash0hq/dash0-operator) 改为 带有 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` 通过 [控制台扩展输出器](https://open-telemetry.github.io/opentelemetry-js/classes/_opentelemetry_sdk_trace_base.ConsoleSpanExporter.html)。 。 。 .

### 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`。 。 。 .

### 只允许特定仪器

默认情况下,全部 [辅助仪器](https://npmcn.com/package/%40dash0/opentelemetry/#readme-https://github.com/open-telemetry/opentelemetry-js-contrib/blob/main/metapackages/auto-instrumentations-node/README.md#supported-instrumentations) 已启用(但 `@opentelemetry/instrumentation-fs`),但可以使用环境变量 `OTEL_NODE_ENABLED_INSTRUMENTATIONS` 通过提供以逗号分隔的列表,只允许某些仪器 没有设备包名称 `@opentelemetry/instrumentation-` 前缀.

例如,只允许 [@ opleteometry/ 仪器- http](https://github.com/open-telemetry/opentelemetry-js/tree/main/packages/opentelemetry-instrumentation-http) 财务报告和审定财务报表 [@ 开元/ 仪器- nestjs- core](https://github.com/open-telemetry/opentelemetry-js-contrib/tree/main/plugins/node/opentelemetry-instrumentation-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](https://github.com/open-telemetry/opentelemetry-js-contrib/blob/main/metapackages/auto-instrumentations-node/README.md#usage-auto-instrumentation) 更多信息.

## 常见问题

### @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 和提交记录判断。