@ adonisjs/ otel (英语)
导言
AdonisJS的OpenTeleometter集成,具有合理的默认和零配置设置. 将分布式追踪,度量衡,自动仪表从盒子中取出.
正式文件
文件可在以下网址查阅: 阿多尼斯JS网站
无法进行遥测
设定 OTEL_SDK_DISABLED=true 在启动程序以跳过 OpenTeleometry 初始化之前:
OTEL_SDK_DISABLED=true node bin/server.js
用这面旗帜, init() 返回,然后登记无害环境管理加载机钩、导入SDK或负载 config/otel.ts。旗帜覆盖 enabled: true 在配置中。 供应商和中间软件可以继续注册.
仅 true在任何信件中,跳过初始化。 其他值使配置处于控制状态. 设置变量为 false 不强制 SDK 启动或更改在测试中使其失效的默认值.
在您的 shell 或部署环境中设置变量 init() 运行。 稍后装入的值 .env 以 #start/env 来不及了 初始化后更改旗子不会去除已存在的钩子或停止运行 SDK.
这个 enabled: false 配置选项阻止了SDK的启动,但留下了已安装的加载车钩. 钩子必须先于配置,因为它的导入可以装入需要仪器的依赖性. 为了避免钩子,使用 OTEL_SDK_DISABLED=true 或跳过 init() 电话.
捐款
AdonisJS的主要目标之一是建立一个充满活力的用户和贡献者社区,他们相信框架的原则.
我们鼓励你读 捐款指南 在对框架作出贡献之前.
行为守则
为了确保AdonisJS社区欢迎所有人,请审查和遵守 行为守则。 。 。 .
许可证
AdonisJS OpenTeleometry 是开源软件,根据该软件许可 麻省理工学院许可证。 。 。 .
关于 @adonisjs/otel 的常见问题
@adonisjs/otel 是什么？
AdonisJS 的 OpenTeleometter 集成, 包含合理的默认和零配置设置
如何安装 @adonisjs/otel？
在项目目录运行 npm install @adonisjs/otel，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@adonisjs/core（^6.2.0 || ^7.0.0 || ^7.0.0-next.27）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。
@adonisjs/otel 支持 TypeScript 吗？
该包的 package.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/adonisjs__otel 是否存在。
@adonisjs/otel 支持 ESM 还是 CommonJS？
以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module，更早的版本需要改用动态 import()。
@adonisjs/otel 需要什么版本的 Node.js？
package.json 的 engines 字段要求 Node.js >=20.6.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。
@adonisjs/otel 可以商用吗？
@adonisjs/otel 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。
@adonisjs/otel 的下载量有多少？
根据 npm 官方下载统计，@adonisjs/otel 在 2026/10/05 – 2026/11/03 这 30 天内被下载 57,723 次，日均约 1,924 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。
@adonisjs/otel 还在维护吗？
最新版本 1.2.4 发布于 2026/10/18（18 天前）；至今共发布 15 个版本，其中过去 12 个月发布了 15 个；首次发布于 2025/12/12。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。