SuperAPI AI 工具集

monitoring-authoring

部署与运维

查看项目

更新于 10-15 22:38

技能介绍

用途:该技能用于创建和修改 Kubernetes 监控资源,包括告警规则、抓取配置、告警路由与合成健康检查。查询 Prometheus 或排查告警需使用 prometheus 与 sre 技能。

主要能力:支持 PrometheusRule(告警与记录规则)、ServiceMonitor(抓取 Service 指标)、PodMonitor(直接抓取 Pod 指标)、ScrapeConfig(高级抓取配置)、AlertmanagerConfig(路由、接收器、静默)、Silence(声明式静默)以及 Canary(HTTP、TCP、K8s 合成健康检查)。

使用方式:PrometheusRule 必须带 release: kube-prometheus-stack 标签才能被发现。告警按严重度设置 for 时长:critical 2m-5m、warning 5m-15m、info 10m-30m;瞬时故障可用 0m,易抖动指标建议 10m-15m。ServiceMonitor 优先通过 Helm values 启用,手动创建时放在 monitoring 命名空间并用 namespaceSelector 指向目标命名空间。PodMonitor 用于无 Service 的 Pod,端口需加引号。Canary 放在 config/canary-checker/ 或应用配置旁,Kubernetes 检查推荐用 CEL 表达式而非 ready: true。新增组件流程:先查 Helm values 是否支持监控,否则手动创建资源,放入正确目录并注册到 kustomization,执行 task k8s:validate,部署后用 kubectl exec 查询 targets 与 rules 验证。

限制与常见错误:缺少必需标签会导致资源被忽略;selector 不匹配会静默无指标;硬编码域名会破坏跨集群;为不存在的指标建告警会一直 pending。具体文件放置与命名约定见 references/file-placement.md。