Skip to content

docs: Add missing OpenTelemetry environment variables and @langfuse/otel package setup for JS/TS OpenAI SDK #2470

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
doongsilee wants to merge 3 commits into
base: main
Choose a base branch
from
Open

docs: Add missing OpenTelemetry environment variables and @langfuse/otel package setup for JS/TS OpenAI SDK #2470

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
ef6d4b3
docs: add OpenTelemetry environment variable configuration instructions
doongsilee Jan 23, 2026
54c8df4
docs: update installation instructions for OpenAI SDK and Langfuse in…
doongsilee Jan 23, 2026
60da3c1
Merge branch 'main' into main
doongsilee Jan 26, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 5 additions & 2 deletions components-mdx/get-started/js-openai-sdk.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,9 @@
**Install package**
**Install packages**

Install the Langfuse OpenAI wrapper, the official OpenAI SDK, and the Langfuse OpenTelemetry integration required for tracing.

```sh
npm install @langfuse/openai
npm install @langfuse/openai @langfuse/otel
```

**Add credentials**
Expand Down
21 changes: 21 additions & 0 deletions components-mdx/setup-otel-js.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,27 @@ Install the OpenTelemetry SDK, which the Langfuse integration uses under the hoo
npm install @opentelemetry/sdk-node
```

**Configure OpenTelemetry environment variables**

Before initializing the SDK, you need to set up the OpenTelemetry exporter environment variables. These tell OpenTelemetry where to send the traces and how to authenticate with Langfuse.

Add the following environment variables to your `.env` file or environment:

```bash filename=".env"
OTEL_EXPORTER_OTLP_ENDPOINT="https://cloud.langfuse.com/api/public/otel" # 🇪🇺 EU region
# OTEL_EXPORTER_OTLP_ENDPOINT="https://us.cloud.langfuse.com/api/public/otel" # 🇺🇸 US region

OTEL_EXPORTER_OTLP_HEADERS="Authorization=Basic <base64_encoded_auth>"
```

To generate the base64 encoded authentication string, use the following command in your terminal:

```bash
echo -n "pk-lf-...:sk-lf-..." | base64
```

Replace `pk-lf-...` and `sk-lf-...` with your actual `LANGFUSE_PUBLIC_KEY` and `LANGFUSE_SECRET_KEY` values. Then replace `<base64_encoded_auth>` in the `OTEL_EXPORTER_OTLP_HEADERS` with the output from the command above.

Next is initializing the Node SDK. You can do that either in a dedicated instrumentation file or directly at the top of your main file.


Expand Down