>
> Langfuse v3.0.0 includes infrastructure changes when self-hosting Langfuse. Refer to the [v3 migration guide](https://langfuse.com/self-hosting/upgrade-guides/upgrade-v2-to-v3) for more details.
>
> If you use Langfuse Cloud, there are no breaking changes if you use SDKs >= v2.0.0 (released in December 2023).
What's Changed
Infrastructure Changes
Excerpt from [v3 migration guide](https://langfuse.com/self-hosting/upgrade-guides/upgrade-v2-to-v3)
> 
>
> Langfuse has gained significant traction over the last months, both in our Cloud environment and in self-hosted setups.
> With Langfuse v3 we introduce changes that allow our backend to handle hundreds of events per second with higher reliability.
> To achieve this scale, we introduce a second Langfuse container and additional storage services like S3/Blob store, Clickhouse, and Redis which are better suited for the required workloads than our previous Postgres-based setup.
>
> In short, Langfuse v3 adds:
>
> - A new worker container that processes events asynchronously.
> - A new S3/Blob store for storing large objects.
> - A new Clickhouse instance for storing traces, observations, and scores.
> - Redis/Valkey for queuing events and caching data.
See [v3 migration guide](https://langfuse.com/self-hosting/upgrade-guides/upgrade-v2-to-v3) for reasoning, deployment guides, and more details.
Feat
* feat: improve generations table default query time by maxdeichmann in https://github.com/langfuse/langfuse/pull/4440
* feat(media): broaden content type support by hassiebp in https://github.com/langfuse/langfuse/pull/4442
* feat(ui): add more explicit confirmation prompt before deleting a dataset by marcklingen in https://github.com/langfuse/langfuse/pull/4424
* feat: move exports to ch by maxdeichmann in https://github.com/langfuse/langfuse/pull/4634
* feat(comments): add support for comment button on each trace preview in session view by marliessophie in https://github.com/langfuse/langfuse/pull/3848
* feat: adjust trace redirect to uniqueness of trace ids to projects by maxdeichmann in https://github.com/langfuse/langfuse/pull/4598
* feat: add ui for background migrations by maxdeichmann in https://github.com/langfuse/langfuse/pull/4602
* feat: set v3 default variables by maxdeichmann in https://github.com/langfuse/langfuse/pull/4613
* feat: increase trace upsert delay by maxdeichmann in https://github.com/langfuse/langfuse/pull/4619
* feat(comments): increase content character limit to 3,000 by marliessophie in https://github.com/langfuse/langfuse/pull/4577
* feat(url): support AWS S3 signed images in trace/observation preview by marliessophie in https://github.com/langfuse/langfuse/pull/4575
* feat(ui): add "not found" error page for unknown traces and sessions by marcklingen in https://github.com/langfuse/langfuse/pull/4548
* feat(auth): add KeyCloak authentication option by RTae in https://github.com/langfuse/langfuse/pull/2866
* feat(cloud): update entitlements to account for limits, add self-hosted pro plan by marcklingen in https://github.com/langfuse/langfuse/pull/3913
* feat(auth): add GitHub Enterprise Authentication Provider by jay0129 in https://github.com/langfuse/langfuse/pull/4463
* feat(playground+evals): add gemini and vertex support by hassiebp in https://github.com/langfuse/langfuse/pull/4485
Fix
* fix: change the default of the migration script by maxdeichmann in https://github.com/langfuse/langfuse/pull/4419
* fix(auth): improve name and password verification by marcklingen in https://github.com/langfuse/langfuse/pull/4434
* fix(playground): unique prompt names in save to prompt by hassiebp in https://github.com/langfuse/langfuse/pull/4437
* fix: do not log stack trace in trpc checkupdate when no internet access by marcklingen in https://github.com/langfuse/langfuse/pull/4436
* fix: override score name when config is set by marcklingen in https://github.com/langfuse/langfuse/pull/4445
* fix(media): increase isolationLevel on concurrent upserts by hassiebp in https://github.com/langfuse/langfuse/pull/4458
* fix: adjust generations table default again by maxdeichmann in https://github.com/langfuse/langfuse/pull/4446
* fix(ui): trace timeline peek drawer should not be full-width by marcklingen in https://github.com/langfuse/langfuse/pull/4462
* fix: fix generations search in clickhouse by maxdeichmann in https://github.com/langfuse/langfuse/pull/4472
* fix(media): increase retries by hassiebp in https://github.com/langfuse/langfuse/pull/4474
* fix(ui): account for prereleases in update check by marcklingen in https://github.com/langfuse/langfuse/pull/4503
* fix(ui): overflow of session view on mobile by marcklingen in https://github.com/langfuse/langfuse/pull/4515
* fix(ui): disallow creation of projects if project name already exists in the org by marcklingen in https://github.com/langfuse/langfuse/pull/4516
* fix: fix score source public api filter by maxdeichmann in https://github.com/langfuse/langfuse/pull/4520
* fix(media): use db upserts instead of prisma by hassiebp in https://github.com/langfuse/langfuse/pull/4521
* fix: no need to decode nextjs path variables, causes issues with special characters by marcklingen in https://github.com/langfuse/langfuse/pull/4522
* fix(IO-ui): render additional input in pretty view by hassiebp in https://github.com/langfuse/langfuse/pull/4524
* fix(io-ui): padding additional input by hassiebp in https://github.com/langfuse/langfuse/pull/4526
* fix: on cache schema change, delete cached api keys by marcklingen in https://github.com/langfuse/langfuse/pull/4527
* fix: show dataset run if not run item exists yet by maxdeichmann in https://github.com/langfuse/langfuse/pull/4528
* fix(media): add wait time before retries by hassiebp in https://github.com/langfuse/langfuse/pull/4547
* fix: remove LANGFUSE_CSP_DISABLE (did not work) and disable csp headers on HF Spaces by marcklingen in https://github.com/langfuse/langfuse/pull/4545
* fix: check postgres negative flag by maxdeichmann in https://github.com/langfuse/langfuse/pull/4624
* fix: support reading observations from clickhouse for observations in annotation queue by marliessophie in https://github.com/langfuse/langfuse/pull/4621
* fix: fix trace bookmarking by maxdeichmann in https://github.com/langfuse/langfuse/pull/4638
* fix: fix trace tagging without postgres by maxdeichmann in https://github.com/langfuse/langfuse/pull/4639
* fix: default to empty string for csv export in case of null by maxdeichmann in https://github.com/langfuse/langfuse/pull/4640
* fix: always pull the project_id for generations queries by maxdeichmann in https://github.com/langfuse/langfuse/pull/4641
* fix: allow userId filter on /api/public/observations again by Steffen911 in https://github.com/langfuse/langfuse/pull/4644
* fix: fern spec for MediaContentType by STRRL in https://github.com/langfuse/langfuse/pull/4627
* fix: fix front end confirmations to delete traces by maxdeichmann in https://github.com/langfuse/langfuse/pull/4601
* fix(experiments): don't create experiment run items for archived dataset items by marliessophie in https://github.com/langfuse/langfuse/pull/4611
* fix: fix numeric chart for dashboards by maxdeichmann in https://github.com/langfuse/langfuse/pull/4615
* fix: fix traces publishing in V3 without postgres by maxdeichmann in https://github.com/langfuse/langfuse/pull/4620
* fix: only read trace and score from prisma if `LANGFUSE_POSTGRES_INGESTION_ENABLED` by marliessophie in https://github.com/langfuse/langfuse/pull/4618
* fix: return timestamps in API response as ISO strings by Steffen911 in https://github.com/langfuse/langfuse/pull/4593
* fix: show correct scores if dataset runs link same traces by maxdeichmann in https://github.com/langfuse/langfuse/pull/4582
* fix: perform batch trace deletion on clickhouse by Steffen911 in https://github.com/langfuse/langfuse/pull/4570
* fix(cloud): only active evals count towards free plan limit by marcklingen in https://github.com/langfuse/langfuse/pull/4572
* fix: convert json strings to json in traces api metadata field by Steffen911 in https://github.com/langfuse/langfuse/pull/4564
* fix(ui): show scrollbar for scores in column visibility by marliessophie in https://github.com/langfuse/langfuse/pull/4569
* fix(media): add self host env vars by hassiebp in https://github.com/langfuse/langfuse/pull/4578
* fix: disable x frame options header on Hugging Face by marcklingen in https://github.com/langfuse/langfuse/pull/4558
* fix: increase attempts for evals by maxdeichmann in https://github.com/langfuse/langfuse/pull/4487
* fix(auth): add nonce check for Cognito NextAuth provider by crw2998 in https://github.com/langfuse/langfuse/pull/4401
* fix: fix time to first token by maxdeichmann in https://github.com/langfuse/langfuse/pull/4549
* fix: do not authenticate with Docker Hub for pull request CI. (4476) by marcklingen in https://github.com/langfuse/langfuse/pull/4477
Chore
* chore: explicitly cast names for traces table by Steffen911 in https://github.com/langfuse/langfuse/pull/4433
* chore: make trace deletion asynchronous by Steffen911 in https://github.com/langfuse/langfuse/pull/4398
* chore: restrict trace.name length to 1000 characters by Steffen911 in https://github.com/langfuse/langfuse/pull/4441
* chore(cloud): improve logs of usage metering job by marcklingen in https://github.com/langfuse/langfuse/pull/4447
* chore: remove log line by maxdeichmann in https://github.com/langfuse/langfuse/pull/4466
* chore: use s3 region `auto` in docker-compose.yml by marcklingen in https://github.com/langfuse/langfuse/pull/4630
* chore: add logs for media API by maxdeichmann in https://github.com/langfuse/langfuse/pull/4471
* chore(deps): bump stripe from 16.8.0 to 17.4.0 by dependabot in https://github.com/langfuse/langfuse/pull/4377
* chore(deps): bump posthog-node from 3.6.3 to 4.3.1 by dependabot in https://github.com/langfuse/langfuse/pull/4450
* chore(deps): bump lucide-react from 0.447.0 to 0.462.0 by dependabot in https://github.com/langfuse/langfuse/pull/4475
* chore: fix typo in ingestion queue concurrency and adjust default by Steffen911 in https://github.com/langfuse/langfuse/pull/4495
* chore: apply v3 defaults to environment variables by Steffen911 in https://github.com/langfuse/langfuse/pull/4498
* chore: move batch export s3 env variable names into new naming pattern by Steffen911 in https://github.com/langfuse/langfuse/pull/4511
* chore: ignore latency for prompts-ui.servertest.ts by Steffen911 in https://github.com/langfuse/langfuse/pull/4513
* chore: remove backend cloud version checks by Steffen911 in https://github.com/langfuse/langfuse/pull/4512
* chore: add logging for datasets router by maxdeichmann in https://github.com/langfuse/langfuse/pull/4519
* chore: add LANGFUSE_CSP_DISABLE to .env.prod.example by marcklingen in https://github.com/langfuse/langfuse/pull/4533
* chore: include projectId in event processing error message by Steffen911 in https://github.com/langfuse/langfuse/pull/4535
* chore: migrate traces all API route to Clickhouse by Steffen911 in https://github.com/langfuse/langfuse/pull/4542
* chore: migrate /metrics/daily API route to Clickhouse by Steffen911 in https://github.com/langfuse/langfuse/pull/4546
* chore: refactor tests async by maxdeichmann in https://github.com/langfuse/langfuse/pull/4552
* chore: remove public users api by maxdeichmann in https://github.com/langfuse/langfuse/pull/4553
* chore: double ingestion API rate limits by maxdeichmann in https://github.com/langfuse/langfuse/pull/4544
* chore: increase timeout for daily metrics query by Steffen911 in https://github.com/langfuse/langfuse/pull/4565
* chore(ingestion): add back async ingestion processing flag by hassiebp in https://github.com/langfuse/langfuse/pull/4573
* chore(cost-tracking): add gpt-4o-2024-11-20 prices by hassiebp in https://github.com/langfuse/langfuse/pull/4576
* chore: explicitly mention worker/src/ee by marcklingen in https://github.com/langfuse/langfuse/pull/4581
* chore: add aggregateScores tests by maxdeichmann in https://github.com/langfuse/langfuse/pull/4580
* chore: check early whether clickhouse url is configured by Steffen911 in https://github.com/langfuse/langfuse/pull/4595
* chore: make project deletion asynchronous by Steffen911 in https://github.com/langfuse/langfuse/pull/4399
* chore: add wait time during validation of clickhouse background migra… by Steffen911 in https://github.com/langfuse/langfuse/pull/4596
* chore: drop FK v3 constraints by maxdeichmann in https://github.com/langfuse/langfuse/pull/4612
* chore: move eval to correct ee directory by maxdeichmann in https://github.com/langfuse/langfuse/pull/4616
* chore: hide background migrations on cloud and show queued status by Steffen911 in https://github.com/langfuse/langfuse/pull/4628
Other
* refactor(cloud): move usage metering job to clickhouse by marcklingen in https://github.com/langfuse/langfuse/pull/4448
* perf: improve clickhouse traces table perfromance by maxdeichmann in https://github.com/langfuse/langfuse/pull/4451
* perf: prevent duplicated parallel executions of cloud metering job by marcklingen in https://github.com/langfuse/langfuse/pull/4455
* perf: increase performance for traces default table by maxdeichmann in https://github.com/langfuse/langfuse/pull/4459
* chore: expand error logging for queue worker errors by Steffen911 in https://github.com/langfuse/langfuse/pull/4457
* perf: extract traces table metrics from clickhouse traces.all query by maxdeichmann in https://github.com/langfuse/langfuse/pull/4460
* perf: single clickhouse query for cloud usage job across all orgs/projects by marcklingen in https://github.com/langfuse/langfuse/pull/4453
* refactor: move session tests to async suite by maxdeichmann in https://github.com/langfuse/langfuse/pull/4636
* perf: fetch observations using timestamps by maxdeichmann in https://github.com/langfuse/langfuse/pull/4629
* build: add latest tags to v3 tags by Steffen911 in https://github.com/langfuse/langfuse/pull/4648
* perf: improve user metrics for large projects by maxdeichmann in https://github.com/langfuse/langfuse/pull/4568
* perf: improve single trace public API performance by maxdeichmann in https://github.com/langfuse/langfuse/pull/4537
* perf: improve count query performance for scores public api by maxdeichmann in https://github.com/langfuse/langfuse/pull/4538
* perf: add a user_id bloom filter by maxdeichmann in https://github.com/langfuse/langfuse/pull/4554
* perf: improve scores API query performance by maxdeichmann in https://github.com/langfuse/langfuse/pull/4534
* perf: improve dataset run item performance by maxdeichmann in https://github.com/langfuse/langfuse/pull/4514
* docs: add list of dependents to readme by marcklingen in https://github.com/langfuse/langfuse/pull/4518
* perf: improve datasets view by maxdeichmann in https://github.com/langfuse/langfuse/pull/4486
* perf: add improved default performance to traces table by maxdeichmann in https://github.com/langfuse/langfuse/pull/4469
* build: cancel concurrent PR jobs on new commit by Steffen911 in https://github.com/langfuse/langfuse/pull/4517
New Contributors
* crw2998 made their first contribution in https://github.com/langfuse/langfuse/pull/4401
* jay0129 made their first contribution in https://github.com/langfuse/langfuse/pull/4463
* RTae made their first contribution in https://github.com/langfuse/langfuse/pull/2866
* STRRL made their first contribution in https://github.com/langfuse/langfuse/pull/4627
**Full Changelog**: https://github.com/langfuse/langfuse/compare/v2.93.0...v3.0.0