Repository navigation
Description
<!-- 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-basedobserve()function-wrapping decorator,startObservation()/startActiveObservation()manual span creation, andLangfuseSpanProcessorexport, registered on a Node OTel SDK.
What's missing
- No auto-instrumentation config, wrapper, or e2e scenario exists for either the legacy
langfuseclient 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, e2elangsmith-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
- https://github.com/langfuse/langfuse-js (SDK source, releases)
- https://js.reference.langfuse.com/ (API reference)
- https://langfuse.com/docs/observability/sdk/overview
- https://langfuse.com/docs/observability/sdk/instrumentation
- https://langfuse.com/docs/observability/sdk/upgrade-path/js-v3-to-v4
- https://langfuse.com/changelog/2025-08-28-typescript-sdk-v4-ga
- https://github.com/langfuse/langfuse-js/releases (latest: v6.1.0, 2026-10-30)
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 stripslangfuse.-namespaced keys, not a Langfuse integration). js/src/auto-instrumentations/configs/all.ts(full instrumentation registry — no Langfuse entry;langsmith.tsentry present for comparison)e2e/scenarios/directory listing (nolangfuse-named scenario;langsmith-instrumentationexists for comparison)docs/directory (no mention of Langfuse)
Activity