@contextcompany/otel

中文文档
1.1.1发布于 2026/07/15MITTypeScriptESM + CJS构建来源已验证近 30 天下载 3.1万

OpenTeleometry 的背景公司集成

中文使用文档

@ contextcompany/ otel (英语)

此套件包含"Context Company"为节点和Next.js环境的OpenTeleometry集成.

Vercel AI SDK 兼容性

@contextcompany/otel 不取决于 ai 软件包,因此可以和AI SDK 5, 6或7一起安装.

  • AI SDK 5和6 传播遗产 ai.* OpenTeleometry 横穿 experimental_telemetry. 继续得到支持.
  • AI SDK 7 使用马厩 telemetry 选项和单独的 @ai-sdk/otel 软件包。 土著 gen_ai 支持跨度.

对于AI SDK 7,在应用程序启动时注册两个集成:

import { OpenTelemetry } from "@ai-sdk/otel";
import { registerTelemetry } from "ai";
import { registerOTelTCC } from "@contextcompany/otel/nextjs";

registerOTelTCC();
registerTelemetry(new OpenTelemetry({ runtimeContext: true }));

通过 TCC 元数据作为运行时上下文,并将其明确纳入遥测:

streamText({
  model,
  prompt,
  runtimeContext: {
    "tcc.runId": runId,
    "tcc.sessionId": sessionId,
  },
  telemetry: {
    includeRuntimeContext: {
      "tcc.runId": true,
      "tcc.sessionId": true,
    },
  },
});

版本与发布记录

@contextcompany/otel 共发布 21 个版本,首次发布于 2025/10/12;过去 12 个月发布了 9 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
1.1.1latest2026/07/153 个月前
1.1.02026/07/153 个月前
1.0.182026/07/074 个月前
1.0.172026/06/224 个月前
1.0.162026/04/226 个月前
1.0.152026/03/277 个月前

关于 @contextcompany/otel 的常见问题

@contextcompany/otel 是什么?

OpenTeleometry 的背景公司集成

如何安装 @contextcompany/otel?

在项目目录运行 npm install @contextcompany/otel,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:@opentelemetry/api(^1.9.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@contextcompany/otel 支持 TypeScript 吗?

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

@contextcompany/otel 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@contextcompany/otel 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=18.0.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@contextcompany/otel 可以商用吗?

@contextcompany/otel 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@contextcompany/otel 的下载量有多少?

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

@contextcompany/otel 还在维护吗?

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