Getting Started with Observe

Add governance, observability, and LLM cost tracking to your existing agents in minutes.

1. Create an API Key

You need an API key to connect waxell-observe to your controlplane.

2. Install waxell-observe

pip install waxell-observe

For LangChain support: pip install waxell-observe[langchain]

3. Configure

import os
os.environ["WAXELL_API_URL"] = "https://your-tenant.waxell.dev"
os.environ["WAXELL_API_KEY"] = "wax_sk_your_key_here"

# Or configure in code:
from waxell_observe import WaxellObserveClient
WaxellObserveClient.configure(
    api_url="https://your-tenant.waxell.dev",
    api_key="wax_sk_your_key_here",
)

4. Add to your agent

from waxell_observe.integrations.langchain import WaxellLangChainHandler

handler = WaxellLangChainHandler(agent_name="my-agent")

# Use with any LangChain chain, agent, or LLM
result = chain.invoke(
    {"question": "Hello"},
    config={"callbacks": [handler]}
)

# Flush telemetry when done
handler.flush_sync(result={"output": result})

5. Verify

Run your agent and check the Agent Executions page to see your data flow in. Then explore Cost Analytics for LLM spend tracking and Policies to set up governance rules.