用途：为 Google ADK 智能体搭建可观测性体系，覆盖日志、链路追踪、事件分析与第三方平台接入，便于监控、调试和分析智能体行为。
主要能力：提供多种方案模板与脚本。Cloud Trace 基于 OpenTelemetry，自动为智能体运行创建 span，追踪 LLM 与工具调用及错误延迟；BigQuery Agent Analytics 插件做异步事件日志，支持多模态内容经 GCS 卸载，含 trace_id、span_id，可配置事件白/黑名单与批量写入；第三方可选 AgentOps（会话回放、成本与延迟指标）、Phoenix/Arize（开源自托管、OpenInference 自动埋点）、Weave/W&B（时间线与调用跟踪）。另有 bigquery-schema.json 定义 agent_events_v2 表结构，按日期分区、按事件类型等聚类。
使用方式：运行对应脚本，如 ./scripts/setup-cloud-trace.sh <project-id>；BigQuery 用 ./scripts/setup-bigquery-analytics.sh <project-id> <dataset-id> [bucket-name]，并配合 bq mk 建数据集与表；AgentOps 用 pip install -U agentops 后 agentops.init()；Phoenix 装 openinference-instrumentation-google-adk 与 arize-phoenix-otel；Weave 装 opentelemetry 相关包并在导入 ADK 前设置 tracer provider。密钥一律用环境变量，如 GOOGLE_CLOUD_PROJECT、AGENTOPS_API_KEY、PHOENIX_API_KEY、WANDB_API_KEY。可用 ./scripts/validate-observability.sh 校验连通性与权限。
适用场景：本地调试、生产监控、成本与令牌分析、错误率统计、多工具组合观测。
限制：资料只给出 Google ADK 相关方案，具体费用、价格与平台配额暂未提供；凭据不得硬编码，需按 IAM 最小权限与保留策略配置。