Skip to main content
Set up Langfuse to trace agent execution and analyze performance in your Langfuse dashboard. Before starting, complete the quickstart guide to have an agent running on Idun Agent Platform.

​
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

Create an observability configuration

  1. On the Idun Agent Platform main page, navigate to Observability
  2. Click Add configuration
  3. Select Langfuse
  4. Enter a Configuration Name (for example, “Langfuse Server 1”)
  5. Fill in the required API credentials:
    • Host URL: Your Langfuse instance URL (for example, https://cloud.langfuse.com or your self-hosted URL)
    • Public Key: Your Langfuse public key (starts with pk-lf-...)
    • Secret Key: Your Langfuse secret key (starts with sk-lf-...)
  6. Click Create configuration
After creating, you can click the Verify button on the configuration card to check that the connection works.
Keep your secret key secure. Do not commit it to version control or share it publicly.
Observability configurations are saved and reusable across multiple agents. You only need to set up your API keys once.
3

Attach Langfuse to your agent

  1. Navigate to the agent you want to trace
  2. Click Edit Agent
  3. Click Next to reach the observability configuration step
  4. Select Langfuse as the observability provider
  5. Select the Langfuse configuration you want to use
  6. Click Next
  7. Click Save changes to finalize
After saving, click Restart on your agent page to reload the configuration and enable Langfuse observability.

​
View observability data

Once your agent is running with observability enabled:
  1. Interact with your agent through the Manager UI or API
  2. Open your Langfuse dashboard at cloud.langfuse.com
  3. Navigate to your project to view traces
You will see traces showing:
  • 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

ADK does not currently support simultaneous tracing with both Langfuse and GCP tracing. If you need this feature, open an issue on GitHub or join the Discord server.

​
Observability not working?

  1. Check API keys: Verify that your public and secret keys are correct
  2. Verify host URL: Confirm the URL is accessible and correctly formatted
  3. Check agent logs: Look for connection errors in the agent runtime logs
  4. Test connectivity: Verify your agent can reach the Langfuse host
Last modified on March 31, 2026