langfuse.api.request.duration

API request duration

Dimensions:None

Technical Annotations (41)

Configuration Parameters (7)

orderBy.columnrecommended: timestamp

enables LIMIT 1 BY optimization instead of expensive FINAL operator

orderBy.orderrecommended: DESC

required with column to skip FINAL deduplication in ClickHouse

maskrecommended: set at client initialization only

masking function cannot be changed after client init; per-request changes cause severe latency

fetch_timeout_secondsrecommended: 20

Python SDK: timeout per API call in seconds

fetchTimeoutMsrecommended: 10000

JavaScript SDK: timeout per API call in milliseconds

timeoutrecommended: 20

SDK timeout in seconds; default 20s, minimum recommended for ingestion

debugrecommended: True

Enable detailed SDK logging to diagnose timeout and connectivity issues

Error Signatures (8)

java.net.SocketTimeoutException: timeoutexception

com.langfuse.client.core.LangfuseClientException: Network error executing HTTP requestexception

API failureserror code

content policy violationserror code

parsing errorserror code

504 Gateway Time-outhttp status

HTTPSConnectionPool(host='...'): Read timed out. (read timeout=exception

Read timed out. (read timeout=exception

CLI Commands (3)

pyinstrument profiler.start(); langfuse_context.configure(...); profiler.stop(); print(profiler.output_text(color=True, show_all=True))

diagnostic

curl -v -X POST https://langfuse.perso.be/api/public/ingestion -H "Content-Type: application/json" -H "Authorization: Basic <base64_creds>" -d '{"batch": [{"type": "trace-create", "id": "test-trace-001", "timestamp": "2025-07-12T12:00:00.000Z", "body": {"id": "test-trace-001", "timestamp": "2025-07-12T12:00:00.000Z", "name": "curl-test"}}]}'

diagnostic

curl -v https://langfuse.perso.be/api/public/ingestiondiagnostic

Technical References (23)

ReplacingMergeTreecomponentFINALconceptLIMIT 1 BYconceptgetTracesTableGenericcomponentweb/src/server/api/routers/traces.tsfile pathtraces.metricscomponenttraces.allcomponentapi/public/observationscomponentapi/public/v2/observationscomponentClickHousecomponentlangfuse-java v0.1.2componentlangfuse_contextcomponentLangfuseDecoratorcomponentobserve decoratorcomponentcircuit breaker patternconceptsamplingconceptbatch transmissionconceptspan ingestionscomponentinternal networking stackcomponenthigh cardinality dimensionsconcept/api/public/ingestionendpointnginxcomponentingestion workercomponent

Related Insights (10)

Missing orderBy parameter causes 20x slowdown in traces.metrics endpointcritical

▸

V1 observations endpoint experiences 10x latency increase after v2 releasewarning

▸

langfuse_context.configure() causes multi-second latency on subsequent callscritical

▸

Response latency degradation indicates prompt performance issueswarning

▸

Synchronous tracing increases P99 latency from 200ms to 800mswarning

▸

Internal networking delays cause span ingestion timeouts and cascading failurescritical

▸

High cardinality dimensions blocked from grouping in v2 Metrics APIwarning

▸

Prompt fetch operations timeout before completionwarning

▸

504 Gateway Timeout on ingestion endpoint while other API endpoints workcritical

▸

SDK timeout too short for ingestion processing delayswarning

▸