Skip to content

🪢 Open source agent evals & observability: Trace, evaluate, and improve LLM applications with one open platform.

fix(v4): clarify OTel ingestion guidance (#16107)

Max Deichmannb91d332ca2fd
diff --git a/web/src/features/v4-migration/V4MigrationContent.clienttest.tsx b/web/src/features/v4-migration/V4MigrationContent.clienttest.tsx
index 8937a50eeb..a232f6725f 100644
--- a/web/src/features/v4-migration/V4MigrationContent.clienttest.tsx
+++ b/web/src/features/v4-migration/V4MigrationContent.clienttest.tsx
@@ -837,7 +837,11 @@ describe("V4MigrationDetailsContent", () => {
screen.getByText("Update OTel Instrumentation").closest("button")!,
).getByText("1"),
).toBeInTheDocument();
- expect(screen.getByText(/delayed ingestion path/)).toBeInTheDocument();
+ expect(
+ screen.getByText("x-langfuse-ingestion-version: 4").closest("p"),
+ ).toHaveTextContent(
+ "Your OpenTelemetry data is using delayed ingestion. For real-time ingestion, upgrade your integration or, if you use OpenTelemetry directly, set x-langfuse-ingestion-version: 4 on your OTLP exporter. Migration guide.",
+ );
expect(screen.getByText("openlit 1.35.4")).toBeInTheDocument();
expect(screen.getByText("· delayed")).toBeInTheDocument();
expect(screen.queryByText("Update SDK")).not.toBeInTheDocument();
diff --git a/web/src/features/v4-migration/V4MigrationContent.tsx b/web/src/features/v4-migration/V4MigrationContent.tsx
index e9ff3c67ca..9cc05e8005 100644
--- a/web/src/features/v4-migration/V4MigrationContent.tsx
+++ b/web/src/features/v4-migration/V4MigrationContent.tsx
@@ -547,15 +547,15 @@ export function V4MigrationOtelSection({
defaultOpen={defaultOpen}
>
<p className="text-muted-foreground text-sm leading-relaxed">
- OTel data is arriving through the delayed ingestion path. Set the{" "}
- <MonoValue>x-langfuse-ingestion-version</MonoValue> header to{" "}
- <MonoValue>4</MonoValue> on the OTLP exporter to use real-time
- ingestion.{" "}
+ Your OpenTelemetry data is using delayed ingestion. For real-time
+ ingestion, upgrade your integration or, if you use OpenTelemetry
+ directly, set <MonoValue>x-langfuse-ingestion-version: 4</MonoValue> on
+ your OTLP exporter.{" "}
<ExternalLink
href={OTEL_V4_MIGRATION_URL}
analytics={{ section: "otel", link: "otel_migration_docs" }}
>
- OpenTelemetry migration guide
+ Migration guide
</ExternalLink>
.
</p>