Troubleshooting

If requests fail, run zero doctor check-connector --env-name LANGFUSE_PUBLIC_KEY or zero doctor check-connector --url https://cloud.langfuse.com/api/public/traces --method GET

How to Use

All examples below assume LANGFUSE_PUBLIC_KEY and LANGFUSE_SECRET_KEY are set. Langfuse uses HTTP Basic Auth with the Public Key as the username and the Secret Key as the password.

EU Cloud (default): https://cloud.langfuse.com
US Cloud: https://us.cloud.langfuse.com

Pass credentials to curl with -u "$LANGFUSE_PUBLIC_KEY:$LANGFUSE_SECRET_KEY".

1. Batch Ingest Traces and Events

Send traces, spans, generations, events, and scores in a single batch. Each item in batch has a type (e.g. trace-create, span-create, generation-create, score-create) and a body.

Write to /tmp/langfuse_ingest.json: