Langfuse

Documentation Index

Fetch the complete documentation index at: https://docs.idun-group.com/llms.txt

Use this file to discover all available pages before exploring further.

​

Set up Langfuse observability

1

Get your Langfuse API keys

If you do not have Langfuse API keys yet:

1. Go to Langfuse Cloud or your self-hosted instance
2. Sign up or log in to your account
3. Create a new project or select an existing one
4. Navigate to Settings > API Keys
5. Click Create New API Key
6. Copy the Public Key and Secret Key

2

Configure Langfuse in the standalone

Open the running standalone at /admin/observability/ and click Langfuse. Fill in:

• Host: Your Langfuse instance URL (e.g., https://cloud.langfuse.com or your self-hosted URL)
• Public key: Langfuse public key (starts with pk-lf-...)
• Secret key: Langfuse secret key (starts with sk-lf-...)
• Run name: (Optional) Display label for traces in Langfuse (e.g., my-agent)

Save the form. The reload pipeline re-instantiates the engine; the next agent run starts streaming traces to Langfuse. Use the Verify button to test the connection.

Keep your secret key secure. Do not commit it to version control or share it publicly.

observability:
  - provider: "LANGFUSE"
    enabled: true
    config:
      host: "https://cloud.langfuse.com"
      public_key: "${LANGFUSE_PUBLIC_KEY}"
      secret_key: "${LANGFUSE_SECRET_KEY}"
      run_name: "my-agent"

​

View observability data

1. Interact with your agent through the chat UI at / or the API at /agent/run
2. Open your Langfuse dashboard at cloud.langfuse.com
3. Navigate to your project to view traces

• Agent execution flow
• LLM calls and responses
• Tool usage and results
• Execution time and costs
• Error traces and debugging information

​

Best practices

• Use descriptive names for observability configurations to identify them when managing multiple agents
• Enable observability during development to catch issues early
• Monitor costs through your Langfuse dashboard to track token usage

​

Troubleshooting

​

Next steps