@cat-factory/observability-langfuse

中文文档
0.11.86发布于 2026/11/06TypeScriptES Module构建来源已验证近 30 天下载 5493

Opt -in Langfuse追踪槽 为代理建筑委员会。 工人安全的OTLP/HTTP出口商指向了Langfuse的"OpenTeleometry"端点,因此LLM世代和容器工具在Cloudflare Worker和Node外观上都横跨了没有改变的流.

中文使用文档
文档目录3 节
  1. OTLP出口商指着Langfuse
  2. 行为
  3. 使用量

@ cat-factory/可观察性-langfuse

选入 兰福斯 代理建筑局的追踪水槽.

它执行运行时间中立 LlmTraceSink 端口从 @cat-factory/kernel这样 当连接到每个 LLM 调用: 容器代理调用( 通过 LLM 代理) 财务报告和审定财务报表 内置调用( 需要审查、 文件规划员、 碎片选择器、 内置调用) 物剂:在Langfuse的地表上,作为一代人, 归在它的追踪之下 可选容器工具跨度.

OTLP出口商指着Langfuse

这个水槽是 @cat-factory/observability-otel以取取为基础的 OTLP/ HTTP 出口国, 有3个 构造器中朗福斯特定决定:终点 {baseUrl}/api/public/otel (出口者附上) /v1/traces), HTTP Basic 认证在键对之上 x-langfuse-ingestion-version: 4 v4需要实时摄入的页眉. 计量 因为Langfuse只执行追踪信号.

以前是自己的客户 说Langfuse的批次 摄取 API (单位:千美元)POST /api/public/ingestion) (中文(简体) ). API堕落了 朗福斯云上日落了 2026-11-16 (英语),则 trace-create 编号 : generation-create 编号 : span-create 它发送的事件 v4 数据模型中已不支持。 OTLP 是支持的路径, 而这个 repo 已经说过了.

两者都不取决于官方 langfuse 节点 SDK 或任何 @opentelemetry/* 软件包: 依赖Cloudflare Worker 运行时间上无法使用的仅节点 API (workerd),它使水槽字节在两个外观上都保持了一模一样.

行为

  • 从不向呼叫者丢入:每个冲浪会吞下自己的错误(最多博客 a) )),该词的原意是: 观察力绝不能中断代理工作.
  • 同样的荣誉 LLM_RECORD_PROMPTS 隐私切换为本地的公制商店 : 即时录音被关闭,世代携带使用/计时/元数据,但没有即时或 反应机构.

使用量

import { createLangfuseSink } from '@cat-factory/observability-langfuse'

const sink = createLangfuseSink({
  publicKey: env.LANGFUSE_PUBLIC_KEY,
  secretKey: env.LANGFUSE_SECRET_KEY,
  baseUrl: env.LANGFUSE_BASE_URL, // optional; defaults to Langfuse Cloud
})

通过其容器接入外表 selectLangfuseSink(config); 缺少配置 {} 水槽从未建造过,也没有外部排放或行为变化.

版本与发布记录

@cat-factory/observability-langfuse 共发布 520 个版本,首次发布于 2026/06/24;过去 12 个月发布了 520 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.11.86latest2026/11/062 天前
0.11.852026/11/045 天前
0.11.842026/11/045 天前
0.11.832026/11/045 天前
0.11.822026/11/045 天前
0.11.812026/11/045 天前

关于 @cat-factory/observability-langfuse 的常见问题

@cat-factory/observability-langfuse 是什么?

Opt -in Langfuse追踪槽 为代理建筑委员会。 工人安全的OTLP/HTTP出口商指向了Langfuse的"OpenTeleometry"端点,因此LLM世代和容器工具在Cloudflare Worker和Node外观上都横跨了没有改变的流.

如何安装 @cat-factory/observability-langfuse?

在项目目录运行 npm install @cat-factory/observability-langfuse,或使用 pnpm add / yarn add / bun add。

@cat-factory/observability-langfuse 支持 TypeScript 吗?

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

@cat-factory/observability-langfuse 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@cat-factory/observability-langfuse 可以商用吗?

@cat-factory/observability-langfuse 使用 未声明 许可。package.json 没有声明许可证。没有许可证的代码默认保留全部权利,商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括,不构成法律意见,请以许可原文为准。

@cat-factory/observability-langfuse 的下载量有多少?

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

@cat-factory/observability-langfuse 还在维护吗?

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