adk-observability-guide
Originally fromeliasecchig/adk-docs
Installation
Summary
Observability setup guide for ADK agents covering tracing, logging, analytics, and third-party integrations.
- Four observability tiers: Cloud Trace (always enabled, distributed tracing), Prompt-Response Logging (GenAI interactions to GCS/BigQuery), BigQuery Agent Analytics (structured agent events), and third-party platforms (AgentOps, Phoenix, MLflow, Weave, Arize, Monocle, Freeplay)
- Cloud Trace automatically configured in scaffolded projects and Agent Engine deployments; captures execution flow, latency, and errors via OpenTelemetry spans
- Prompt-Response Logging privacy-preserving by default (metadata only); controlled via
OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENTenvironment variable - Includes troubleshooting table for common issues (missing traces, privacy misconfiguration, cost optimization) and reference files for Terraform infrastructure and BigQuery plugin setup
SKILL.md
ADK Observability Guide
Scaffolded project? Cloud Trace and prompt-response logging are pre-configured by Terraform. See
references/cloud-trace-and-logging.mdfor infrastructure details, env vars, and verification commands.No scaffold? Follow the ADK docs links below for manual setup. For production infrastructure, scaffold with
/adk-scaffold.
Reference Files
| File | Contents |
|---|---|
references/cloud-trace-and-logging.md |
Scaffolded project details — Terraform-provisioned resources, environment variables, verification commands, enabling/disabling locally |
references/bigquery-agent-analytics.md |
BQ Agent Analytics plugin — enabling, key features, GCS offloading, tool provenance |
Observability Tiers
Choose the right level of observability based on your needs:
Related skills