Skip to content

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

fix(web): reframe the v4 upgrade copy away from "your setup is outdated" (#16075)

Max Deichmanna66ece0473fd
diff --git a/web/src/features/v4-migration/V4MigrationBadgeContent.stories.tsx b/web/src/features/v4-migration/V4MigrationBadgeContent.stories.tsx
index 453a72ccbf..8d532dcd17 100644
--- a/web/src/features/v4-migration/V4MigrationBadgeContent.stories.tsx
+++ b/web/src/features/v4-migration/V4MigrationBadgeContent.stories.tsx
@@ -5,8 +5,7 @@ import { V4MigrationBadgeContent } from "./V4MigrationBadgeContent";
// The longest copy the delay badge renders (V4MigrationDelayBadge); the
// hover reveal must expand to whatever width this needs (LF-90).
-const OTEL_DESCRIPTION =
- "Your setup is outdated. Update OTel instrumentation for real-time data";
+const OTEL_DESCRIPTION = "Update your OTel instrumentation for real-time data";
const meta = preview.meta({
component: V4MigrationBadgeContent,
@@ -16,7 +15,7 @@ export const Default = meta.story({
args: {
onClick: fn(),
title: "New data in ~15 min",
- description: "Your setup is outdated. Update SDK for real-time data",
+ description: "Update your SDK for real-time data",
},
});
@@ -53,7 +52,7 @@ export const TestFocusRevealsLongestDescription = meta.story({
// The description sits in an overflow-hidden wrapper that animates open;
// once expanded it must fit the whole text (no clipping mid-word).
const text = within(button).getByText(
- /Update OTel instrumentation for real-time data/,
+ /Update your OTel instrumentation for real-time data/,
);
const clipBox = text.parentElement;
if (!clipBox) throw new Error("description wrapper not found");
diff --git a/web/src/features/v4-migration/V4MigrationContent.clienttest.tsx b/web/src/features/v4-migration/V4MigrationContent.clienttest.tsx
index a67bdb9f86..b2bc9f555f 100644
--- a/web/src/features/v4-migration/V4MigrationContent.clienttest.tsx
+++ b/web/src/features/v4-migration/V4MigrationContent.clienttest.tsx
@@ -996,9 +996,9 @@ describe("V4MigrationHeaderContent", () => {
expect(screen.getByText("Upgrade to v4")).toBeInTheDocument();
expect(screen.queryByText(/Project 1/)).not.toBeInTheDocument();
expect(
- screen.getByText(/Your project setup is outdated/),
+ screen.getByText(/Complete the action items below/),
).toHaveTextContent(
- "Your project setup is outdated. Upgrade to v4 now for real-time ingestion and up to 165x faster queries. See docs.",
+ "Langfuse v4 is here: real-time ingestion and up to 165× faster queries. Complete the action items below to switch this project over. See docs.",
);
expect(screen.getByRole("link", { name: "See docs." })).toHaveAttribute(
"href",
@@ -1021,7 +1021,7 @@ describe("V4MigrationHeaderContent", () => {
expect(screen.getByText("Upgrade to v4").parentElement).toHaveClass("pr-6");
});
- it("does not call ready or unresolved projects outdated", () => {
+ it("keeps the pitch but drops the action ask for ready or unresolved projects", () => {
for (const readiness of [
"ready",
"checking",
@@ -1033,10 +1033,10 @@ describe("V4MigrationHeaderContent", () => {
);
expect(
- screen.queryByText(/Your project setup is outdated/),
+ screen.queryByText(/Complete the action items below/),
).not.toBeInTheDocument();
expect(
- screen.getByText(/Langfuse v4 offers real-time ingestion/),
+ screen.getByText(/Langfuse v4 is here: real-time ingestion/),
).toBeInTheDocument();
expect(
screen.queryByText(/some features may stop working/),
diff --git a/web/src/features/v4-migration/V4MigrationContent.tsx b/web/src/features/v4-migration/V4MigrationContent.tsx
index 5a104f682f..5452a6cda0 100644
--- a/web/src/features/v4-migration/V4MigrationContent.tsx
+++ b/web/src/features/v4-migration/V4MigrationContent.tsx
@@ -988,8 +988,8 @@ export function V4MigrationHeaderContent({
<div className="text-muted-foreground flex flex-col gap-2 text-sm leading-relaxed">
<p>
{actionNeeded
- ? "Your project setup is outdated. Upgrade to v4 now for real-time ingestion and up to 165x faster queries. "
- : "Langfuse v4 offers real-time ingestion and up to 165x faster queries. "}
+ ? "Langfuse v4 is here: real-time ingestion and up to 165× faster queries. Complete the action items below to switch this project over. "
+ : "Langfuse v4 is here: real-time ingestion and up to 165× faster queries. "}
<ExternalLink
href={V4_DOCS_URL}
analytics={{ section: "header", link: "v4_docs" }}
diff --git a/web/src/features/v4-migration/V4MigrationDelayBadge.clienttest.tsx b/web/src/features/v4-migration/V4MigrationDelayBadge.clienttest.tsx
index 23bf91af93..24b0c8e82a 100644
--- a/web/src/features/v4-migration/V4MigrationDelayBadge.clienttest.tsx
+++ b/web/src/features/v4-migration/V4MigrationDelayBadge.clienttest.tsx
@@ -148,7 +148,7 @@ describe("V4MigrationDelayBadge", () => {
0,
);
expect(
- screen.getAllByText(/Update SDK for real-time data/).length,
+ screen.getAllByText(/Update your SDK for real-time data/).length,
).toBeGreaterThan(0);
});
@@ -156,7 +156,7 @@ describe("V4MigrationDelayBadge", () => {
setSdk("otel_header_required", [delayedOtelSeries()]);
render(<V4MigrationDelayBadge />);
expect(
- screen.getAllByText(/Update OTel instrumentation for real-time data/)
+ screen.getAllByText(/Update your OTel instrumentation for real-time data/)
.length,
).toBeGreaterThan(0);
});
@@ -165,7 +165,8 @@ describe("V4MigrationDelayBadge", () => {
setSdk("unknown", [customIngestionSeries()]);
render(<V4MigrationDelayBadge />);
expect(
- screen.getAllByText(/Upgrade instrumentation for real-time data/).length,
+ screen.getAllByText(/Upgrade your instrumentation for real-time data/)
+ .length,
).toBeGreaterThan(0);
});
@@ -173,11 +174,11 @@ describe("V4MigrationDelayBadge", () => {
setSdk("legacy", [outdatedSdkSeries(), delayedOtelSeries()]);
render(<V4MigrationDelayBadge />);
expect(
- screen.getAllByText(/Upgrade for real-time data/).length,
+ screen.getAllByText(/Upgrade to v4 for real-time data/).length,
).toBeGreaterThan(0);
- expect(screen.queryAllByText(/Update SDK for real-time data/)).toHaveLength(
- 0,
- );
+ expect(
+ screen.queryAllByText(/Update your SDK for real-time data/),
+ ).toHaveLength(0);
});
it("stays hidden when an SDK version is merely unrecognized", () => {
diff --git a/web/src/features/v4-migration/V4MigrationDelayBadge.tsx b/web/src/features/v4-migration/V4MigrationDelayBadge.tsx
index e86eac035c..5cdcfab7ae 100644
--- a/web/src/features/v4-migration/V4MigrationDelayBadge.tsx
+++ b/web/src/features/v4-migration/V4MigrationDelayBadge.tsx
@@ -75,12 +75,12 @@ export function V4MigrationDelayBadge() {
// multiple delayed paths get the generic clause.
const description =
actionablePaths > 1
- ? "Your setup is outdated. Upgrade for real-time data"
+ ? "Upgrade to v4 for real-time data"
: sdkActionable
- ? "Your setup is outdated. Update SDK for real-time data"
+ ? "Update your SDK for real-time data"
: otelActionable
- ? "Your setup is outdated. Update OTel instrumentation for real-time data"
- : "Your setup is outdated. Upgrade instrumentation for real-time data";
+ ? "Update your OTel instrumentation for real-time data"
+ : "Upgrade your instrumentation for real-time data";
return (
<V4MigrationBadgeContent
diff --git a/web/src/features/v4-migration/V4MigrationHeaderContent.stories.tsx b/web/src/features/v4-migration/V4MigrationHeaderContent.stories.tsx
new file mode 100644
index 0000000000..885ff485ea
--- /dev/null
+++ b/web/src/features/v4-migration/V4MigrationHeaderContent.stories.tsx
@@ -0,0 +1,30 @@
+import preview from "../../../.storybook/preview";
+import { V4MigrationHeaderContent } from "./V4MigrationContent";
+
+// The panel takes ~40% of a desktop viewport; this width keeps the line breaks
+// representative of what users actually read.
+const PANEL_WIDTH = "w-[520px]";
+
+const meta = preview.meta({
+ component: V4MigrationHeaderContent,
+ decorators: [
+ (Story) => (
+ <div className={PANEL_WIDTH}>
+ <Story />
+ </div>
+ ),
+ ],
+});
+
+// What a project with remaining upgrade steps sees, opened from the sidebar.
+export const ActionNeeded = meta.story({
+ args: { readiness: "action-needed" },
+});
+
+export const Ready = meta.story({
+ args: { readiness: "ready" },
+});
+
+export const Checking = meta.story({
+ args: { readiness: "checking" },
+});