adk-observability-guide
CommunityMonitor and troubleshoot ADK agents
AuthorSeanChenR
Version1.0.0
Installs0
System Documentation
What problem does it solve?
The ADK Observability Guide helps engineers and SREs configure, verify, and troubleshoot tracing, prompt-response logging, and analytics for ADK agents so they can understand execution flow, debug agent behavior, and audit GenAI interactions in production.
Core Features & Use Cases
- Cloud Trace: Always-on distributed tracing via OpenTelemetry to visualize invocation span trees, latency, and errors across agents and tool executions.
- Prompt-Response Logging: Configurable capture of GenAI interactions exported to GCS, BigQuery, and Cloud Logging for auditing, compliance, and replay.
- BigQuery Agent Analytics: Optional plugin for structured event logging, SQL analytics, Looker Studio dashboards, and GCS offloading for multimodal content.
- Third-Party Integrations & Troubleshooting: Guidance for AgentOps, Arize, Phoenix, MLflow, Monocle, Weave, and operational troubleshooting steps, IAM checks, and verification commands.
Quick Start
Enable scaffolded telemetry or set LOGS_BUCKET_NAME and OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT then run the ADK service and verify traces and logs in the Cloud Console.
Dependency Matrix
Required Modules
None requiredComponents
references
💻 Claude Code Installation
Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.
Please help me install this Skill: Name: adk-observability-guide Download link: https://github.com/SeanChenR/maestro-agent/archive/main.zip#adk-observability-guide Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
Agent Skills Search Helper
Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.