The Python SDK
The server must be configured to export that data by setting
configure_telemetry=True.Agent SDK Configuration
Before configuring an observability platform, your agent code must be “telemetry-aware.” This configuration applies to all implementations, whether you are using local Phoenix or a cloud provider like Langfuse. You must initialize instrumentation at the agent logic level and enable the export flag in the Agent Stack SDK:Simple Monitoring: Agent Logs
The quickest way to see what your agent is doing is by streaming its logs directly to your terminal. This is ideal for debugging container lifecycle events and immediate request errors.- Agent startup and initialization
- Request processing steps
- Error messages and stack traces
- Container lifecycle events
Logs are only available for managed (containerized) agents that are currently running on Agent Stack.
Advanced Observability: Traces & Metrics
By default, Agent Stack integrates with Arize Phoenix for local visualization of agent traces. For cloud-based observability and production monitoring, you can easily integrate Langfuse. Telemetry details include:- Platform version and runtime details
- Agent execution traces
Enable Phoenix Observability
Install and Enable
Install and start Phoenix using the You can run this even if your platform is already running; it will update the configuration without losing existing data.
agentstack platform start command:Verify Initialization
Spinning up the Phoenix container can take a moment, even after the CLI reports success. Go to http://localhost:6006 and check if it’s running. If not, please wait a few moments.
View Traces in Phoenix
Open http://localhost:6006 in your browser and navigate to the default project to explore the collected traces.
Enable Langfuse Observability
To route traces to Langfuse, provide a custom OTLP configuration:Get Langfuse credentials
- Sign up at cloud.langfuse.com
- Create a project and generate API keys
- Encode your keys:
echo -n "public_key:secret_key" | base64
Additional Resources
- OpenTelemetry Docs: https://opentelemetry.io/docs/
- Langfuse Docs: https://langfuse.com/docs
- Phoenix Docs: https://docs.arize.com/phoenix
- Prometheus Docs: https://prometheus.io/docs/
- Grafana Docs: https://grafana.com/docs/