用途:当用户反馈 Zilliz Cloud 集群或 Milvus 集合不健康、变慢、卡住、返回错误、触及配额等问题时,用现有 zilliz 命令做只读诊断。前提是已安装并登录 CLI;诊断集群需集群上下文或显式传 --cluster-id;诊断集合需上下文指向该集合所属集群。
主要能力:分两个入口。集群诊断按顺序收集上下文、集群描述、集群列表、计费用量,并拉取近 1 小时与 24 小时指标(CU_COMPUTATION、CU_CAPACITY、CU_SIZE、REPLICA_COUNT、STORAGE、SLOW_QUERIES、SEARCH_QPS、SEARCH_LATENCY_P99、SEARCH_FAIL_RATE、INSERT_FAIL_RATE),在状态非 RUNNING、CU 计算接近容量、延迟上升而 QPS 持平、失败率非零、存储接近配额等条件下给出建议。集合诊断收集集合描述、统计、加载状态、索引列表与描述、分区列表及逐集合指标,检查加载状态、已加载/已索引实体数、是否缺向量索引或在大数据量上用 FLAT、索引参数是否明显不当、副本数、schema 与分区键等,并给出建议。
使用方式:命令示例:zilliz context current;zilliz cluster describe --cluster-id <id> -o json;zilliz cluster metrics --cluster-id <id> -m CU_COMPUTATION ... --period 1h;集合侧用 zilliz collection describe、get-stats、get-load-state、index list、index describe、partition list、collection metrics。对机器解析用 -o json,展示趋势用默认图表输出;非默认数据库需在每条命令加 --database <db>。
限制:技能全程只读,不执行 delete、drop、release、resume、suspend、create、update、索引创建/删除等变更命令,只作为建议呈现,由用户自行执行。每条结论须引用命令与观察到的事实。索引参数、副本数、CU 规格建议依赖 CLI 无法观测的工作负载,应表述为“起点,需基准测试确认”。CLI 看不到单查询计划、段级状态、压缩积压、GC、服务内部队列和告警规则状态,相关问题需直接说明。若用户有多个集群,先确认目标集群。