SuperAPI AI 工具集

gcp-logs-monitoring

部署与运维

查看项目

更新于 10-15 20:06

技能介绍

用途:从终端快速、可重复地检查 Cloud Logging 与 Cloud Monitoring 数据,用于事件分诊、调试和运维分析。

主要能力:提供前置条件校验、Cloud Logging 日志查询、Cloud Monitoring 时间序列查询三类脚本,并给出日志与指标时间戳关联、根因推断与后续检查建议的工作流。

使用方式:先收集 project_id、调查时间窗口、服务/资源上下文、关注信号(错误、延迟、CPU、内存、请求数、重启)和输出格式。校验前置条件:bash .agents/skills/gcp-logs-monitoring/scripts/check_prereqs.sh --project <project_id>。查询日志:bash .agents/skills/gcp-logs-monitoring/scripts/read_logs.sh --project <project_id> --filter '<LOG_FILTER>' --freshness 1h --limit 100 --format json。查询指标:bash .agents/skills/gcp-logs-monitoring/scripts/read_metrics.sh --project <project_id> --filter '<METRIC_FILTER>' --start <UTC_ISO8601> --end <UTC_ISO8601> --format json。

常用过滤模板:Cloud Run 错误 resource.type="cloud_run_revision" severity>=ERROR;GKE 容器错误 resource.type="k8s_container" severity>=ERROR;负载均衡 5xx resource.type="http_load_balancer" jsonPayload.statusDetails=~"5..";超时文本搜索 textPayload:"timeout" OR jsonPayload.message:"timeout"。指标示例:run.googleapis.com/request_count、run.googleapis.com/request_latencies、compute.googleapis.com/instance/cpu/utilization。

限制与护栏:每条命令优先传 --project,避免修改全局 gcloud 配置;从短窗口(15m 至 2h)开始,必要时再扩大;输出需解析或跨源比较时用 --format json;认证或项目检查失败时先修复环境再重跑查询。具体收费、平台支持范围等资料暂未提供。