🪢 Open source agent evals & observability: Trace, evaluate, and improve LLM applications with one open platform.
TypeScript analyticsautogenevaluationlangchainlarge-language-modelsllama-indexllmllm-evaluationllm-observabilityllmopsmonitoringobservabilityopen-sourceopenaiplaygroundprompt-engineeringprompt-managementself-hostedycombinator
feat(api): say legacy endpoints delay data by about 10 minutes (#17260)
Max Deichmann2c44151e2a1f
diff --git a/web/src/__tests__/server/unit/openapi-deprecations.servertest.ts b/web/src/__tests__/server/unit/openapi-deprecations.servertest.tsindex e352d01c48..04f70cdbb8 100644--- a/web/src/__tests__/server/unit/openapi-deprecations.servertest.ts+++ b/web/src/__tests__/server/unit/openapi-deprecations.servertest.ts@@ -12,6 +12,14 @@ import {stampDeprecations,} from "../../../../scripts/openapi/stamp-deprecations";import {+ DATASET_RUN_ITEMS_DEPRECATION,+ DATASET_RUNS_DEPRECATION,+ METRICS_DEPRECATION,+ OBSERVATIONS_V1_DEPRECATION,+ SCORES_DEPRECATION,+ SESSIONS_DEPRECATION,+ TRACES_DEPRECATION,+ V3_DELAY_NOTICE,V3_SUNSET_DATE,V3_SUNSET_HUMAN,} from "@/src/features/public-api/server/deprecations";@@ -158,6 +166,24 @@ describe("OpenAPI deprecations", () => {).toBe(V3_SUNSET_HUMAN);});+ // Every family that already stamps `_deprecation` shares V3_NOTICE, so a new+ // family that forgets it would ship without the delay warning.+ it("puts the 10-minute delay on every legacy `_deprecation.message`", () => {+ const families = [+ OBSERVATIONS_V1_DEPRECATION,+ TRACES_DEPRECATION,+ SESSIONS_DEPRECATION,+ SCORES_DEPRECATION,+ METRICS_DEPRECATION,+ DATASET_RUN_ITEMS_DEPRECATION,+ DATASET_RUNS_DEPRECATION,+ ];++ for (const family of families) {+ expect(family.message).toContain(V3_DELAY_NOTICE);+ }+ });+it("supports deprecated endpoints at a service base path", () => {withDefinition({diff --git a/web/src/features/public-api/server/deprecations.ts b/web/src/features/public-api/server/deprecations.tsindex ca05b02680..bd0ab3f0d3 100644--- a/web/src/features/public-api/server/deprecations.ts+++ b/web/src/features/public-api/server/deprecations.ts@@ -13,7 +13,10 @@ export const V3_SUNSET_HUMAN = "November 16, 2026";// Shared deprecation reason — references the deprecated Langfuse v3 system// version (not an API version). Customer-facing wording lives here — edit once.-const V3_NOTICE = `On Langfuse Cloud, Langfuse v3 is deprecated and this endpoint will be removed on ${V3_SUNSET_HUMAN}.`;+export const V3_DELAY_NOTICE =+ "Data on this API is delayed by about 10 minutes. Real-time is only OpenTelemetry writes plus v2 observations and v2 metrics reads.";++const V3_NOTICE = `On Langfuse Cloud, Langfuse v3 is deprecated and this endpoint will be removed on ${V3_SUNSET_HUMAN}. ${V3_DELAY_NOTICE}`;// v4 replacement endpoints, referenced by both the message and `replacement`.// Placeholder style matches rateLimitUpgradePaths (<from>, <to>, filters).