google-agents-cli-observability 用于代理部署后的日志、追踪、质量指标和运行监控。它解决的不是“把服务部署上去”,而是上线后如何知道请求走了哪些工具、哪里变慢、回答质量是否下降,以及成本和错误是否异常。
部署完成后,先确认项目是否启用了 Cloud Trace、结构化日志和对应的监控资源,再按需要接入 prompt-response logging、BigQuery Analytics 或第三方观测平台。涉及用户输入和代理回答时,要先定义脱敏、保留时间和访问权限;可观测性不能成为把敏感对话无条件落盘的理由。
排查一次失败请求时,把 trace、日志、工具调用和最终回答放在同一条时间线上看;不要只盯着平均延迟。观察指标应和代理目标相连,例如任务成功、工具错误、token 使用和延迟分位数。这个 Skill 适合已经部署或准备接入生产监控的 agents-cli 项目,不能替你定义业务质量标准。