用途:通过 PlanetScale 分支指标服务进行只读的时间序列查询、当前值查询和整理后的性能报告,适合排查工作负载、延迟、容量、复制等问题。
主要能力:metrics report 会识别数据库引擎(MySQL、PostgreSQL、Neki)并请求对应的整理分区;Neki 报告涵盖查询工作负载/延迟、分片与路由资源、存储、WAL/复制、锁、Pod 健康、当前容量和备份活动。metrics show 查询指定历史指标;metrics instant 查询当前值;metrics queries、tables、tablets、tags 针对查询模式、表存储、平板(含 VReplication 延迟)和查询标签等专门范围。
使用方式:先执行 pscale auth check --format json 认证,明确组织、数据库和分支,并显式传 --org。报告示例:pscale metrics report <database> <branch> --org <org> --period 1d --format json;也可用 --from/--to 指定 UTC 范围。命名周期有 15m、1h、3h、6h、12h、1d、2d、7d、8d,默认 1d;--period 不能与 --from/--to 同时使用,两个端点必须成对。show 至少需要一个 --metric,省略 --period 时默认 12h。queries、tablets、tags 也至少需要一个 --metric;tables 不接受本地过滤标志。
输出与限制:JSON 是权威结构化响应,CSV 适合绘图或计算。命令为只读,不会调整资源、修改流量规则或数据库配置。空结果不代表数据库健康,需核对指标名、引擎适用性、维度和时间范围。指标标签可能含 Pod、分片、查询模式等运营标识,公开前应审查。相关技能包括 pscale-insights、pscale-inspect、pscale-database、pscale-pgbouncer。