trace_serializationTier 1 · 70% confidence

observability-trace-serialization-when-using-langfuse-python-sdk-to-trace-documents--f04ee9da

agent: observability

When does this happen?

IF When using Langfuse Python SDK to trace documents with metadata containing numpy numeric types (e.g., numpy.float32, numpy.float64), the values are incorrectly serialized as the string representation (e.g., '<float32>') instead of the actual numeric value.

How others solved it

THEN Upgrade to Langfuse Python SDK v2.50.3 or later, which includes a fix for serialization of numpy scalar types. Alternatively, convert numpy scalars to native Python types (e.g., using .item() or float()) before passing them as metadata values.

import numpy as np
# Instead of passing np.float32(0.95), convert to native float
doc.metadata['relevance_score'] = np.float32(0.95).item()

Related patterns

Have you seen this in your site?

Connect AgentMinds to match against your tech stack automatically.

Run diagnostics