如何監(jiān)控 PlanetScale 數(shù)據(jù)庫(kù)指標(biāo)pscale metrics 查詢(xún)與報(bào)表實(shí)戰(zhàn)指南【免費(fèi)下載鏈接】cliThe CLI for PlanetScale Database項(xiàng)目地址: https://gitcode.com/gh_mirrors/cli31/cli本文帶你快速掌握 PlanetScale 數(shù)據(jù)庫(kù)指標(biāo)監(jiān)控方法。通過(guò) PlanetScale 官方命令行工具pscale的metrics命令組你可以在終端里一鍵查詢(xún)數(shù)據(jù)庫(kù)分支的歷史指標(biāo)、當(dāng)前實(shí)時(shí)值并自動(dòng)生成按引擎MySQL / PostgreSQL分類(lèi)的性能報(bào)表是運(yùn)維和開(kāi)發(fā)者排查數(shù)據(jù)庫(kù)性能問(wèn)題的利器。一、3 個(gè)子命令看懂 PlanetScale 指標(biāo)監(jiān)控 metrics命令組提供了三種互補(bǔ)的查詢(xún)方式覆蓋了從快速看一眼到全面體檢的所有場(chǎng)景子命令作用適用場(chǎng)景pscale metrics show查詢(xún)指定時(shí)間范圍內(nèi)的歷史指標(biāo)序列回溯過(guò)去 1 小時(shí)/1 天的 QPS、延遲變化pscale metrics instant獲取指標(biāo)的當(dāng)前實(shí)時(shí)值查看磁盤(pán)使用率、連接數(shù)等瞬時(shí)狀態(tài)pscale metrics report自動(dòng)檢測(cè)數(shù)據(jù)庫(kù)引擎生成分組性能報(bào)表一次拿到 CPU、延遲、存儲(chǔ)、WAL 等全套健康數(shù)據(jù)三者都支持三種輸出格式Human默認(rèn)終端友好的表格帶迷你趨勢(shì)圖sparklineJSON保留完整 API 響應(yīng)適合腳本處理CSV每個(gè)采樣點(diǎn)一行方便導(dǎo)入 Excel 或分析工具二、pscale metrics show歷史指標(biāo)序列查詢(xún)實(shí)戰(zhàn) 這是最常用的命令用于查詢(xún)某個(gè)數(shù)據(jù)庫(kù)分支在指定時(shí)間窗口內(nèi)的指標(biāo)走勢(shì)?；居梅ú榭?main 分支最近 1 小時(shí)的查詢(xún)量與 p99 延遲pscale metrics show mydb main --org myorg \ --metric queries --metric latency_p99 --period 1h時(shí)間范圍三種指定方式參數(shù)說(shuō)明--period命名周期如1h、12h、1d默認(rèn) 12h--from--to自定義 ISO 8601 時(shí)間區(qū)間二者必須同時(shí)使用--steps請(qǐng)求的數(shù)據(jù)點(diǎn)數(shù)量 小提示--period與--from/--to不能混用命令行會(huì)自動(dòng)校驗(yàn)并給出清晰報(bào)錯(cuò)。常用過(guò)濾參數(shù)show支持大量維度過(guò)濾幫你把數(shù)據(jù)切到最小粒度--metric可重復(fù)使用或逗號(hào)分隔一次查多個(gè)指標(biāo)--keyspace/--shard按 Vitess 命名空間和分片過(guò)濾--query-id/--fingerprint按查詢(xún)模式 ID 或指紋過(guò)濾--role/--pod/--pods按角色、Pod 過(guò)濾Postgres 場(chǎng)景--budget-id/--rule-id關(guān)聯(lián)流量控制規(guī)則與預(yù)算-q/--search按關(guān)鍵詞模糊搜索三、pscale metrics instant一鍵查看當(dāng)前指標(biāo)值 ?想知道現(xiàn)在數(shù)據(jù)庫(kù)狀態(tài)如何用instant子命令# 查看每個(gè) Postgres Pod 的當(dāng)前磁盤(pán)使用率 pscale metrics instant mydb main --org myorg \ --metric planetscale_volume_usage_percentage它同樣支持--role、--shard、--container、--pod等過(guò)濾參數(shù)。如果查詢(xún)沒(méi)有返回任何當(dāng)前值終端會(huì)給出明確提示而不是空白輸出。四、pscale metrics report自動(dòng)生成分組性能報(bào)表 這是metrics命令組最省心的功能自動(dòng)識(shí)別數(shù)據(jù)庫(kù)引擎MySQL 或 PostgreSQL按預(yù)設(shè)的指標(biāo)分組批量拉取輸出一份結(jié)構(gòu)化的性能報(bào)表。# 生成最近 1 天的人類(lèi)可讀報(bào)表 pscale metrics report mydb main --org myorg --period 1d支持的報(bào)表周期15m、1h、3h、6h、12h、1d、2d、7d、8d默認(rèn) 1d。不同引擎的報(bào)表內(nèi)容MySQL 報(bào)表包含 7 個(gè)分組定義見(jiàn) report_catalog.go報(bào)表分組核心指標(biāo)示例Workload, errors, and traffic controlqueries、query_errors、connections、violationsLatency and execution timelatency_p50/p95/p99/p999、vtgate 延遲Query efficiency and fan-outrows_read_per_query、avg_shard_queriesBuffer and block activityblocks_hit、block_cache_hit_ratioNetwork trafficingress/egress_bytesVTGate utilization by availability zonevtgate_cpu_by_az、vtgate_memory_by_azStorage by tablestorage_per_tablePostgreSQL 報(bào)表則擴(kuò)展到 14 個(gè)分組額外覆蓋 PgBouncer 連接池、CPU/內(nèi)存/IOPS、內(nèi)存構(gòu)成RSS/Mmap/Cache、存儲(chǔ)容量、事務(wù)與 WAL 復(fù)制、Pod OOM 健康度以及連接容量、存儲(chǔ)容量、備份活動(dòng)等實(shí)時(shí)值分組。五、三種輸出格式怎么選# 完整 API 響應(yīng)自動(dòng)化場(chǎng)景 pscale metrics show mydb main --org myorg --metric queries --period 1h --format json # 每行一個(gè)采樣點(diǎn)數(shù)據(jù)分析場(chǎng)景 pscale metrics show mydb main --org myorg --metric queries --period 1h --format csvHuman 格式的兩大貼心設(shè)計(jì)迷你趨勢(shì)圖每條序列附帶▁▂▄▇█這樣的 sparkline12 個(gè)字符就能看出走勢(shì)方向單位自動(dòng)換算字節(jié)自動(dòng)轉(zhuǎn)成GiB/MiB速率指標(biāo)追加/s延遲自動(dòng)加ms/s后綴百分比自動(dòng)帶%無(wú)需自己心算格式化邏輯見(jiàn) format.go六、常用指標(biāo)速查表 ?指標(biāo)名含義queries查詢(xún)量QPS 基礎(chǔ)latency_p50/latency_p95/latency_p99查詢(xún)延遲分位數(shù)connections活躍連接數(shù)rows_read/rows_returned/rows_written讀取 / 返回 / 寫(xiě)入行數(shù)block_cache_hit_ratio塊緩存命中率planetscale_volume_usage_percentage存儲(chǔ)卷使用率planetscale_replica_lag_seconds副本延遲Postgresplanetscale_pods_cpu_util_percentagesPod CPU 利用率Postgres七、實(shí)戰(zhàn)工作流建議 日常巡檢每天早上跑一次pscale metrics report mydb main --org myorg --period 1d用--format json存檔對(duì)比故障回溯事故發(fā)生后用--from/--to精確定位時(shí)間窗口配合--metric latency_p99觀察延遲尖峰腳本監(jiān)控用--format csv導(dǎo)出后接入你的告警系統(tǒng)或 BI 工具分片下鉆MySQL 場(chǎng)景加--keyspace和--shard參數(shù)快速定位問(wèn)題分片八、相關(guān)源碼與文檔 內(nèi)容路徑命令組入口metrics.go歷史序列查詢(xún)show.go實(shí)時(shí)值查詢(xún)instant.go分組報(bào)表report.go引擎報(bào)表目錄report_catalog.go格式化與趨勢(shì)圖format.goAPI 服務(wù)封裝metrics.go測(cè)試用例metrics_test.go 注意metrics命令必須攜帶--org參數(shù)指定組織且需要先完成pscale auth login登錄?，F(xiàn)在打開(kāi)終端試試給你的數(shù)據(jù)庫(kù)分支生成第一份性能報(bào)表吧【免費(fèi)下載鏈接】cliThe CLI for PlanetScale Database項(xiàng)目地址: https://gitcode.com/gh_mirrors/cli31/cli創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考