[bot] Instrument Langfuse (4,207,214 weekly downloads)

Đang mở
  • Có gì không ổn?
#2,707 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 1 ngày

Chưa có ai nhận issue này.

Đánh giá

Độ khó
4/5
Thời gian dự kiến
3-5 ngày
Mức phù hợp với người mới
35/100
Loại issue
Tính năng
Độ rõ ràng
Khá rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
javascript, typescript
Lĩnh vực
observability

Hướng nghiên cứu

Start with js/src/auto-instrumentations/configs/all.ts and the existing js/src/auto-instrumentations/configs/langsmith.ts as the pattern to follow, then look at the e2e/scenarios/langsmith-instrumentation scenario. The open question is which Langfuse generation to target (legacy langfuse v3 or @langfuse/tracing with observe()), so settle that with a maintainer first. Done means a registered Langfuse config plus an e2e scenario that passes.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

typescript

<!-- library-gap-audit: langfuse-js-sdk -->

Summary

Langfuse is a widely-used open-source LLM observability/tracing platform whose official JS/TS SDK exposes a meaningful execution/tracing surface analogous to LangSmith — which this repo already instruments. Langfuse's SDK is not instrumented anywhere in this repository.

Langfuse ships two SDK generations, both currently published and in active use:

  • Legacy (langfuse, v3, maintenance mode): new Langfuse() client with .trace(), .span(), .generation(), .event(), .score().
  • Current (@langfuse/tracing + @langfuse/otel, v4+, GA as of 2025-08-28, latest release v6.1.0 on 2026-10-30): OpenTelemetry-based observe() function-wrapping decorator, startObservation()/startActiveObservation() manual span creation, and LangfuseSpanProcessor export, registered on a Node OTel SDK.

What's missing

  • No auto-instrumentation config, wrapper, or e2e scenario exists for either the legacy langfuse client API or the current @langfuse/tracing/observe() OTel-based API.
  • This mirrors the pattern already covered for LangSmith (js/src/auto-instrumentations/configs/langsmith.ts, wrapLangSmithClient/wrapLangSmithRunTrees/wrapLangSmithTraceable, e2e langsmith-instrumentation) — Langfuse is a directly comparable product with an equivalent client/tracing execution surface, but has zero coverage.

Weekly downloads

Weekly downloads: 4,207,214 (as of 2026-11-02; window 2026-10-23 to 2026-10-29; source https://api.npmjs.org/downloads/point/last-week/@langfuse/tracing — current/primary package for the active v4+ SDK line). For reference, the legacy langfuse package alone still logs 2,547,354/week over the same window (https://api.npmjs.org/downloads/point/last-week/langfuse).

Braintrust docs status

not_found — checked https://www.braintrust.dev/docs/integrations and https://www.braintrust.dev/docs/integrations/sdk-integrations/langsmith (which documents the comparable LangSmith integration). Langfuse does not appear in Braintrust's integrations index. Braintrust instead publishes a competitive-comparison article, https://www.braintrust.dev/articles/langfuse-vs-braintrust, positioning Langfuse as an alternative platform rather than an integration target; the only documented interop path is the shared OTLP standard, not a native SDK wrapper.

Upstream sources

Local repo files inspected

  • Repo-wide case-insensitive search for langfuse — only one incidental match, unrelated to actual instrumentation: js/src/instrumentation/plugins/livekit-plugin.ts:740 (!key.startsWith("langfuse."), a generic OTel-attribute filter that strips langfuse.-namespaced keys, not a Langfuse integration).
  • js/src/auto-instrumentations/configs/all.ts (full instrumentation registry — no Langfuse entry; langsmith.ts entry present for comparison)
  • e2e/scenarios/ directory listing (no langfuse-named scenario; langsmith-instrumentation exists for comparison)
  • docs/ directory (no mention of Langfuse)
Ngôn ngữ chính
TypeScript
Star
29
Fork
22
Merge trung bình
1 ngày 6 giờ
Pull request đã merge (30 ngày)
69

Chuẩn bị môi trường

  • Có Dockerfile hoặc tệp Docker Compose
  • Không có mẫu pull request
  • Không có hướng dẫn đóng góp

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của braintrustdata/braintrust-sdk-javascript

Tất cả issue của braintrustdata/braintrust-sdk-javascript

Issue tương tự

Thêm issue về TypeScript

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.