用途:对 YugabyteDB universe 做可观测性驱动的问题排查。给定症状(或仅问“集群是否健康”),选择指标来源、按名称定位指标、用正确聚合查询并解读趋势,确认或排除某类问题。技能本身只读,默认只产出简要诊断与建议修复项,所有修复动作(扩缩容、改 GFlags、删表/索引、触发 compaction、重启等)都需用户明确批准,不自行执行。
主要能力:支持按问题读取的 playbook,包括未知症状快速健康检查、热点/键倾斜、CPU 高、内存/OOM、磁盘与 I/O 饱和、延迟与吞吐回退、连接倾斜、master/catalog RPC 压力、tablet 上限等。核心方法为四种视角:聚合(整体健康)、分组比较(单节点异常)、top-N(最差表/tablet/查询)、均衡度(离群检测,如标准差/均值比、max/均值比、topk/bottomk)。
使用方式:按阶段推进——先选数据源(YBA 优先,其次独立 Prometheus/PromQL,最后直抓节点 /prometheus-metrics);再按名称找指标(YBA 会在抓取时重命名和拆分标签,如 handler_latency_* 变 rpc_latency、rpc_irate_rps 等);然后进入与症状匹配的 playbook。可先用 /api/v1/label/name/values 和 /api/v1/series 确认指标与标签存在。
适用场景与限制:适用于可直连 Prometheus 或节点 /prometheus-metrics 的自管理和 YBA 托管 universe,约 2000 个指标。不适用于 YugabyteDB Aeon 的直查 API(仅暴露少量精选指标);若已配置指标导出到 Prometheus/Grafana Cloud/Datadog,则可对导出端使用。多区域/多 AZ 需按 peer group 比较,避免把设计上的不均衡误判为热点。有 Performance Advisor 时优先使用。相关技能包括 yb-performance-assessment、yb-query-analysis、yba-api、aeon-api。