用途:面向智能体的 Google Cloud 运维监控技能,用于查看 Cloud Run 服务与 Cloud Functions 的健康、指标和日志。
主要能力:列出 Cloud Run 服务与 Cloud Functions;查询 Cloud Monitoring 时间序列指标;读取 Cloud Logging 日志条目。关键指标包括 Cloud Run 的 request_count、request_latencies、container/instance_count、container/cpu/utilization,以及 Cloud Functions 的 execution_count、execution_times、active_instances。
使用方式:通过智能体动作 gcloud 调用,支持 services、metrics、logs 三种模式,不要从智能体直接调用 /api/gcloud/*。服务端文件为 server/lib/gcloud.ts,导出 listCloudRunServices、listCloudFunctions、queryMetrics、getServiceMetrics、listLogEntries 等函数,并提供 GET /api/gcloud/services、/api/gcloud/metrics、/api/gcloud/logs 路由。仪表盘位于 /adhoc/gcloud。
连接与认证:项目来自设置中的数据源 BIGQUERY_PROJECT_ID;使用 GOOGLE_APPLICATION_CREDENTIALS_JSON 服务账号凭据,无 ADC 回退;所需 IAM 角色为 monitoring.viewer、run.viewer、cloudfunctions.viewer、logging.viewer。缓存为 5 分钟内存缓存,最多 120 条。
限制与注意:规模较大时(如 78 个 Cloud Run 服务、237+ 个 Cloud Functions)界面使用可搜索下拉框;对齐周期为 1h→60s、6h→300s、24h→600s、7d→3600s;getServiceMetrics 会根据指标名自动选择对齐器与归约器;listLogEntries 使用 POST 载荷并返回倒序条目。其他细节暂未提供。