scriptoriumadmin/litellm
1
0
Fork 0
mirror of https://github.com/BerriAI/litellm.git synced 2026-09-28 01:32:17 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 43

feat: upgrade Langfuse integration to SDK v4 and add deprecation warning

Browse source 
Addresses #33383, as requested by the Langfuse team.

Changes:

1. pyproject.toml: Bump langfuse dependency from >=2.59.7,<3.0 to >=4.7,<5
   in both proxy-runtime and dev dependency groups. The v4 ingestion path
   (Langfuse Cloud Fast Preview) requires SDK 4.7+.

2. litellm/integrations/langfuse/langfuse.py: Add DeprecationWarning to
   LangFuseLogger.__init__ directing users to LangfuseOtelLogger (the
   langfuse_otel callback). The OTel callback already carries the required
   x-langfuse-ingestion-version: 4 header via _build_langfuse_otel_headers
   and is the recommended path for Langfuse v4 Cloud Fast Preview.

Note: langfuse_otel.py already implements the v4 ingestion header correctly
via LANGFUSE_INGESTION_VERSION_HEADER / LANGFUSE_INGESTION_VERSION constants
and _build_langfuse_otel_headers; no changes are needed there.
This commit is contained in:
Vedant-2-6 2026-08-31 19:39:43 +05:30
parent 4ba8517134
commit e1f359c621
2 changed files with 14 additions and 3 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

11
litellm/integrations/langfuse/langfuse.py
View file

@ -166,6 +166,17 @@ class LangFuseLogger:
raise Exception(
f"\033[91mLangfuse not installed, try running 'pip install langfuse' to fix this error: {e}\n{traceback.format_exc()}\033[0m"
)
import warnings
warnings.warn(
"LangFuseLogger (the 'langfuse' callback) uses the Langfuse Python SDK "
"and is deprecated in favour of LangfuseOtelLogger (the 'langfuse_otel' "
"callback), which sends spans directly over OpenTelemetry and is compatible "
"with Langfuse v4 Cloud Fast Preview. "
"Set success_callback=['langfuse_otel'] to switch to the new integration.",
DeprecationWarning,
stacklevel=2,
)
self.public_key, self.secret_key, self.langfuse_host = resolve_langfuse_credentials(
langfuse_public_key=langfuse_public_key,
langfuse_secret=langfuse_secret,

6
pyproject.toml
View file

@ -146,7 +146,7 @@ proxy-runtime = [
"anthropic[vertex]>=0.84.0,<1.0",
"grpcio==1.78.0",
"prometheus-client>=0.20.0,<1.0",
"langfuse>=2.59.7,<3.0",
"langfuse>=4.7,<5",
"opentelemetry-api==1.28.0",
"opentelemetry-sdk==1.28.0",
"opentelemetry-exporter-otlp==1.28.0",
@ -195,7 +195,7 @@ dev = [
"opentelemetry-sdk==1.28.0",
"opentelemetry-exporter-otlp==1.28.0",
"opentelemetry-instrumentation-fastapi==0.49b0",
"langfuse==2.59.7",
"langfuse>=4.7,<5",
"fastapi-offline==1.7.6",
"fakeredis==2.34.1",
"pytest-rerunfailures==15.1",
@ -356,7 +356,7 @@ also_copy = [
# Run the test suite once before mutation to gather line coverage, then skip
# mutating lines no test exercises. Those mutants would survive regardless
# (no test hits the line to kill them), so generating them wastes hours of CI.
# The score now reads as "mutation score over covered code" — pair with a
# The score now reads as "mutation score over covered code" — pair with a
# line-coverage number when reporting.
mutate_only_covered_lines = true
# Disable rerun/parallel plugins for mutation runs: