{"slug": "langfuse-v4-agent-evals-and-traces-rebuilt-on-one-immutable-clickhouse-table", "title": "Langfuse v4: agent evals and traces rebuilt on one immutable ClickHouse table", "summary": "Langfuse v4 is live on Langfuse Cloud and generally available for self-hosted deployments, rebuilding traces and evaluations on one immutable ClickHouse table to cut initial table loads from seconds to milliseconds and speed up dashboards at least 10x for large projects. Langfuse Cloud becomes v4-only on November 16, 2026, with most projects requiring no migration, while self-hosted v3 receives security patches through January 2027. New features include Monitors, Code evaluators, Filter search bar, Full-text search, Pulse, Langfuse Assistant, Observations API v2, and Metrics API v2.", "body_md": "[← Back to changelog](/changelog#2026-08-17-langfuse-v4)\n\n# Langfuse v4 is live: faster at scale, with more ways to search, monitor, and evaluate\n\nQuery and evaluate every agent step directly, with initial table loads in milliseconds and at least 10x faster dashboards for large projects.\n\nLangfuse v4 is live on Langfuse Cloud and generally available for [self-hosted deployments](/self-hosting/upgrade/upgrade-guides/upgrade-v3-to-v4). It makes it faster to debug, evaluate, and monitor complex LLM applications by letting you work with every LLM call, tool execution, and agent step directly. Initial table loads over large datasets drop from seconds to milliseconds, and dashboards over longer time ranges load at least 10x faster in large projects.\n\nLangfuse Cloud becomes v4-only on **November 16, 2026** (`2026-11-16`\n\n). Most projects need no migration. If the **Migration Assistant** shows actions for your project, complete them before this date.\n\n### New to Langfuse\n\nThere is nothing to migrate. Start tracing with the v4 data model.\n\n### Using Langfuse Cloud\n\nOpen the Migration status page and complete only the checks detected for your project.\n\n### Self-hosting Langfuse\n\nPlan the upgrade on your schedule and review the infrastructure requirements first.\n\n[What we shipped in Langfuse v4](#what-we-shipped-in-langfuse-v4)\n\nLangfuse v4 is much faster and also ships new ways to search, monitor, evaluate, and query your application data. Check them out:\n\n### Monitors\n\nWatch cost, quality, and latency thresholds and notify teams through Slack, webhooks, or GitHub Actions.\n\n### Code evaluators\n\nRun deterministic Python or TypeScript checks on live observations and experiments.\n\n### Filter search bar\n\nCombine typed filters, metadata, and scores in one shareable query.\n\n### Full-text search\n\nFind words and phrases across observation inputs, outputs, and metadata.\n\n### Pulse\n\nPlot count, cost, or latency above the Observations table and select a spike to inspect its operations.\n\n### Langfuse Assistant\n\nAsk questions about traces, observations, sessions, and metrics in plain language.\n\n### Observations API v2\n\nRetrieve selected observation fields with cursor-based pagination.\n\n### Metrics API v2\n\nAggregate cost, tokens, volume, latency, and scores across observations.\n\n[Upgrade Langfuse Cloud projects](#upgrade-langfuse-cloud-projects)\n\nLangfuse Cloud deprecates v3 endpoints and features on **November 16, 2026** (`2026-11-16`\n\n). Please complete any migration requirements for your projects before this date.\n\nNew projects already use v4 and need no migration.\n\nFor existing projects, organization owners can open the **Migration Assistant** sidebar and the [ Migration status page](https://cloud.langfuse.com/v4-migration) to see if any actions are required:\n\nWe will email project owners and admins a summary of the actions required for their projects. Complete those actions by **November 16, 2026** (`2026-11-16`\n\n).\n\nFollow the [upgrade guide](/faq/all/upgrade-to-langfuse-v4) for more details.\n\n[Upgrade self-hosted Langfuse instance](#upgrade-self-hosted-langfuse-instance)\n\nLangfuse v4 is generally available for self-hosted deployments. There is no forced cutover date, and Langfuse v3 will receive security patches through January 2027.\n\nFollow the [self-hosted v3 to v4 migration guide](/self-hosting/upgrade/upgrade-guides/upgrade-v3-to-v4) to review the infrastructure requirements and plan your upgrade.\n\n[Technical background: V4 does less work for the same query](#technical-background-v4-does-less-work-for-the-same-query)\n\n**Queries scan less data.** One denormalized observations table replaces read-time joins between traces and observations.**Ingestion writes less data.** Each completed observation is written once.**Immutable data creates room to optimize.** Append-only observations give us the architectural freedom to introduce optimizations such as materialized views in the future.\n\nOlder SDKs sent updates to both traces and observations, which we stored in separate tables. Before ClickHouse could return a result, it had to join those tables and deduplicate the updates. This was slow at scale.\n\nThe Langfuse Python SDK 4.7.0 or later and JS/TS SDK 5.4.0 or later add trace-level attributes such as `user_id`\n\nand `session_id`\n\nto every observation before it is ingested into Langfuse. Each observation is written to a new immutable, append-only table. The same query now needs neither a join nor deduplication, which makes it much faster.\n\n[Questions](#questions)\n\nAsk rollout and migration questions via the in-app support form or on the [v4 GitHub Discussion post](https://github.com/orgs/langfuse/discussions/12518).\n\nYou can also join a live Q&A with the Langfuse engineering team. Bring migration questions or your actual setup:\n\n| Date | Americas | Europe | Asia | Registration |\n|---|---|---|---|---|\n| Wed, Aug 19 | 12:00 AM PT · 3:00 AM ET | 9:00 AM CEST | 12:30 PM IST · 3:00 PM SGT |\n|\n\n[Register](https://lu.ma/iw93peeb)[Register](https://lu.ma/tqys8cxi)[Register](https://lu.ma/g1d7jvkr)\n\n### Step-by-step upgrade guide\n\n### Versions & Compatibility\n\n### Working with observations", "url": "https://wpnews.pro/news/langfuse-v4-agent-evals-and-traces-rebuilt-on-one-immutable-clickhouse-table", "canonical_source": "https://langfuse.com/changelog/2026-08-17-langfuse-v4", "published_at": "2026-08-19 12:46:51+00:00", "updated_at": "2026-08-19 13:15:21.666672+00:00", "lang": "en", "topics": ["developer-tools", "ai-infrastructure"], "entities": ["Langfuse", "Langfuse Cloud", "ClickHouse", "GitHub Actions", "Slack"], "alternates": {"html": "https://wpnews.pro/news/langfuse-v4-agent-evals-and-traces-rebuilt-on-one-immutable-clickhouse-table", "markdown": "https://wpnews.pro/news/langfuse-v4-agent-evals-and-traces-rebuilt-on-one-immutable-clickhouse-table.md", "text": "https://wpnews.pro/news/langfuse-v4-agent-evals-and-traces-rebuilt-on-one-immutable-clickhouse-table.txt", "jsonld": "https://wpnews.pro/news/langfuse-v4-agent-evals-and-traces-rebuilt-on-one-immutable-clickhouse-table.jsonld"}}