grafana-tikv-dashboard.md

title	category	aliases
TiKV 重要监控指标详解	reference	/docs-cn/dev/reference/key-monitoring-metrics/tikv-dashboard/

TiKV 重要监控指标详解

使用 TiDB Ansible 部署 TiDB 集群时，一键部署监控系统 (Prometheus/Grafana)，监控架构请看 TiDB 监控框架概述。

目前 Grafana Dashboard 整体分为 PD、TiDB、TiKV、Node_exporter、Overview 等。

对于日常运维，我们通过观察 TiKV 面板上的 Metrics，可以了解 TiKV 当前的状态。

以下为 TiKV Dashboard 监控说明：

Cluster

• Store size：每个 TiKV 实例的使用的存储空间的大小
• Available size：每个 TiKV 实例的可用的存储空间的大小
• Capacity size：每个 TiKV 实例的存储容量的大小
• CPU：每个 TiKV 实例 CPU 的使用率
• Memory：每个 TiKV 实例内存的使用情况
• IO utilization：每个 TiKV 实例 IO 的使用率
• MBps：每个 TiKV 实例写入和读取的数据量大小
• QPS：每个 TiKV 实例上各种命令的 QPS
• Errps：每个 TiKV 实例上 gRPC 消息失败的个数
• leader：每个 TiKV 实例 leader 的个数
• Region：每个 TiKV 实例 Region 的个数

Errors

• Server is busy：各种会导致 server 繁忙的事件个数，如 write stall，channel full 等，正常情况下应当为 0
• Server report failures：server 报错的消息个数，正常情况下应当为 0
• Raftstore error：每个 TiKV 实例上 raftstore 发生错误的个数
• Scheduler error：每个 TiKV 实例上 scheduler 发生错误的个数
• Coprocessor error：每个 TiKV 实例上 coprocessor 发生错误的个数
• gRPC message error：每个 TiKV 实例上 gRPC 消息发生错误的个数
• Leader drop：每个 TiKV 实例上 drop leader 的个数
• Leader missing：每个 TiKV 实例上 missing leader 的个数

Server

• Leader：每个 TiKV 实例 leader 的个数
• Region：每个 TiKV 实例 Region 的个数
• CF size：每个 CF 的大小
• Store size：每个 TiKV 实例的使用的存储空间的大小
• Channel full：每个 TiKV 实例上 channel full 错误的数量，正常情况下应当为 0
• Server report failures：server 报错的消息个数，正常情况下应当为 0
• Region average written keys：每个 TiKV 实例上所有 Region 的平均 key 写入个数
• Region average written bytes：每个 TiKV 实例上所有 Region 的平均写入大小
• Active written leaders：每个 TiKV 实例上有效的 leader 个数
• Approximate Region size：每个 Region 近似的大小

Raft IO

• Apply log duration：Raft apply 日志所花费的时间
• Apply log duration per server：每个 TiKV 实例上 Raft apply 日志所花费的时间
• Append log duration：Raft append 日志所花费的时间
• Append log duration per server：每个 TiKV 实例上 Raft append 日志所花费的时间

Raft process

• Ready handled：Raft 中不同 ready 类型的个数
• Process ready duration per server：每个 TiKV 实例处理 ready 所花费的时间，99.99% 的情况下，应该小于 2s
• Process tick duration per server：每个 TiKV 实例处理 tick 所花费的时间
• 0.99 Duration of Raft store events：99% 的 raftstore 事件所花费的时间

Raft message

• Sent messages per server：每个 TiKV 实例发送 Raft 消息的个数
• Flush messages per server：每个 TiKV 实例持久化 Raft 消息的个数
• Receive messages per server：每个 TiKV 实例接受 Raft 消息的个数
• Messages：发送不同类型的 Raft 消息的个数
• Vote：Raft 投票消息发送的个数
• Raft dropped messages：丢弃不同类型的 Raft 消息的个数

Raft propose

• Raft proposals per ready：在一个 mio tick 内，所有 Region proposal 的个数
• Raft read/write proposals：不同类型的 proposal 的个数
• Raft read proposals per server：每个 TiKV 实例发起读 proposal 的个数
• Raft write proposals per server：每个 TiKV 实例发起写 proposal 的个数
• Propose wait duration：每个 proposal 的等待时间
• Propose wait duration per server：每个 TiKV 实例上每个 proposal 的等待时间
• Raft log speed：peer propose 日志的速度

Raft admin

• Admin proposals：admin proposal 的个数
• Admin apply：apply 命令的个数
• Check split：split check 命令的个数
• 99.99% Check split duration：99.99% 的情况下，split check 所需花费的时间

Local reader

• Local reader requests：所有请求的总数以及 local read 线程拒绝的请求数量
• Local read requests duration：local read 请求的等待时间
• Local read requests batch size：local read 请求的批量大小

Storage

• Storage command total：收到不同命令的个数
• Storage async request error：异步请求出错的个数
• Storage async snapshot duration：异步处理 snapshot 所花费的时间，99% 的情况下，应该小于 1s
• Storage async write duration：异步写所花费的时间，99% 的情况下，应该小于 1s

Scheduler

• Scheduler stage total：每种命令不同阶段的个数，正常情况下，不会在短时间内出现大量的错误
• Scheduler priority commands：不同优先级命令的个数
• Scheduler pending commands：每个 TiKV 实例上 pending 命令的个数

Scheduler - batch_get

• Scheduler stage total：batch_get 中每个命令所处不同阶段的个数，正常情况下，不会在短时间内出现大量的错误
• Scheduler command duration：执行 batch_get 命令所需花费的时间，正常情况下，应该小于 1s
• Scheduler latch wait duration：由于 latch wait 造成的时间开销，正常情况下，应该小于 1s
• Scheduler keys read：batch_get 命令读取 key 的个数
• Scheduler keys written：batch_get 命令写入 key 的个数
• Scheduler scan details：执行 batch_get 命令时，扫描每个 CF 中 key 的详细情况
• Scheduler scan details：执行 batch_get 命令时，扫描每个 lock CF 中 key 的详细情况
• Scheduler scan details [write]：执行 batch_get 命令时，扫描每个 write CF 中 key 的详细情况
• Scheduler scan details [default]：执行 batch_get 命令时，扫描每个 default CF 中 key 的详细情况

Scheduler - cleanup

• Scheduler stage total：cleanup 中每个命令所处不同阶段的个数，正常情况下，不会在短时间内出现大量的错误
• Scheduler command duration：执行 cleanup 命令所需花费的时间，正常情况下，应该小于 1s
• Scheduler latch wait duration：由于 latch wait 造成的时间开销，正常情况下，应该小于 1s
• Scheduler keys read：cleanup 命令读取 key 的个数
• Scheduler keys written：cleanup 命令写入 key 的个数
• Scheduler scan details：执行 cleanup 命令时，扫描每个 CF 中 key 的详细情况
• Scheduler scan details [lock]：执行 cleanup 命令时，扫描每个 lock CF 中 key 的详细情况
• Scheduler scan details [write]：执行 cleanup 命令时，扫描每个 write CF 中 key 的详细情况
• Scheduler scan details [default]：执行 cleanup 命令时，扫描每个 default CF 中 key 的详细情况

Scheduler - commit

• Scheduler stage total：commit 中每个命令所处不同阶段的个数，正常情况下，不会在短时间内出现大量的错误
• Scheduler command duration：执行 commit 命令所需花费的时间，正常情况下，应该小于 1s
• Scheduler latch wait duration：由于 latch wait 造成的时间开销，正常情况下，应该小于 1s
• Scheduler keys read：commit 命令读取 key 的个数
• Scheduler keys written：commit 命令写入 key 的个数
• Scheduler scan details：执行 commit 命令时，扫描每个 CF 中 key 的详细情况
• Scheduler scan details [lock]：执行 commit 命令时，扫描每个 lock CF 中 key 的详细情况
• Scheduler scan details [write]：执行 commit 命令时，扫描每个 write CF 中 key 的详细情况
• Scheduler scan details [default]：执行 commit 命令时，扫描每个 default CF 中 key 的详细情况

Scheduler - gc

• Scheduler stage total：gc 中每个命令所处不同阶段的个数，正常情况下，不会在短时间内出现大量的错误
• Scheduler command duration：执行 gc 命令所需花费的时间，正常情况下，应该小于 1s
• Scheduler latch wait duration：由于 latch wait 造成的时间开销，正常情况下，应该小于 1s
• Scheduler keys read：gc 命令读取 key 的个数
• Scheduler keys written：gc 命令写入 key 的个数
• Scheduler scan details：执行 gc 命令时，扫描每个 CF 中 key 的详细情况
• Scheduler scan details [lock]：执行 gc 命令时，扫描每个 lock CF 中 key 的详细情况
• Scheduler scan details [write]：执行 gc 命令时，扫描每个 write CF 中 key 的详细情况
• Scheduler scan details [default]：执行 gc 命令时，扫描每个 default CF 中 key 的详细情况

Scheduler - get

• Scheduler stage total：get 中每个命令所处不同阶段的个数，正常情况下，不会在短时间内出现大量的错误
• Scheduler command duration：执行 get 命令所需花费的时间，正常情况下，应该小于 1s
• Scheduler latch wait duration：由于 latch wait 造成的时间开销，正常情况下，应该小于 1s
• Scheduler keys read：get 命令读取 key 的个数
• Scheduler keys written：get 命令写入 key 的个数
• Scheduler scan details：执行 get 命令时，扫描每个 CF 中 key 的详细情况
• Scheduler scan details [lock]：执行 get 命令时，扫描每个 lock CF 中 key 的详细情况
• Scheduler scan details [write]：执行 get 命令时，扫描每个 write CF 中 key 的详细情况
• Scheduler scan details [default]：执行 get 命令时，扫描每个 default CF 中 key 的详细情况

Scheduler - key_mvcc

• Scheduler stage total：key_mvcc 中每个命令所处不同阶段的个数，正常情况下，不会在短时间内出现大量的错误
• Scheduler command duration：执行 key_mvcc 命令所需花费的时间，正常情况下，应该小于 1s
• Scheduler latch wait duration：由于 latch wait 造成的时间开销，正常情况下，应该小于 1s
• Scheduler keys read：key_mvcc 命令读取 key 的个数
• Scheduler keys written：key_mvcc 命令写入 key 的个数
• Scheduler scan details：执行 key_mvcc 命令时，扫描每个 CF 中 key 的详细情况
• Scheduler scan details [lock]：执行 key_mvcc 命令时，扫描每个 lock CF 中 key 的详细情况
• Scheduler scan details [write]：执行 key_mvcc 命令时，扫描每个 write CF 中 key 的详细情况
• Scheduler scan details [default]：执行 key_mvcc 命令时，扫描每个 default CF 中 key 的详细情况

Scheduler - prewrite

• Scheduler stage total：prewrite 中每个命令所处不同阶段的个数，正常情况下，不会在短时间内出现大量的错误
• Scheduler command duration：执行 prewrite 命令所需花费的时间，正常情况下，应该小于 1s
• Scheduler latch wait duration：由于 latch wait 造成的时间开销，正常情况下，应该小于 1s
• Scheduler keys read：prewrite 命令读取 key 的个数
• Scheduler keys written：prewrite 命令写入 key 的个数
• Scheduler scan details：执行 prewrite 命令时，扫描每个 CF 中 key 的详细情况
• Scheduler scan details [lock]：执行 prewrite 命令时，扫描每个 lock CF 中 key 的详细情况
• Scheduler scan details [write]：执行 prewrite 命令时，扫描每个 write CF 中 key 的详细情况
• Scheduler scan details [default]：执行 prewrite 命令时，扫描每个 default CF 中 key 的详细情况

Scheduler - resolve_lock

• Scheduler stage total：resolve_lock 中每个命令所处不同阶段的个数，正常情况下，不会在短时间内出现大量的错误
• Scheduler command duration：执行 resolve_lock 命令所需花费的时间，正常情况下，应该小于 1s
• Scheduler latch wait duration：由于 latch wait 造成的时间开销，正常情况下，应该小于 1s
• Scheduler keys read：resolve_lock 命令读取 key 的个数
• Scheduler keys written：resolve_lock 命令写入 key 的个数
• Scheduler scan details：执行 resolve_lock 命令时，扫描每个 CF 中 key 的详细情况
• Scheduler scan details [lock]：执行 resolve_lock 命令时，扫描每个 lock CF 中 key 的详细情况
• Scheduler scan details [write]：执行 resolve_lock 命令时，扫描每个 write CF 中 key 的详细情况
• Scheduler scan details [default]：执行 resolve_lock 命令时，扫描每个 default CF 中 key 的详细情况

Scheduler - scan

• Scheduler stage total：scan 中每个命令所处不同阶段的个数，正常情况下，不会在短时间内出现大量的错误
• Scheduler command duration：执行 scan 命令所需花费的时间，正常情况下，应该小于 1s
• Scheduler latch wait duration：由于 latch wait 造成的时间开销，正常情况下，应该小于 1s
• Scheduler keys read：scan 命令读取 key 的个数
• Scheduler keys written：scan 命令写入 key 的个数
• Scheduler scan details：执行 scan 命令时，扫描每个 CF 中 key 的详细情况
• Scheduler scan details [lock]：执行 scan 命令时，扫描每个 lock CF 中 key 的详细情况
• Scheduler scan details [write]：执行 scan 命令时，扫描每个 write CF 中 key 的详细情况
• Scheduler scan details [default]：执行 scan 命令时，扫描每个 default CF 中 key 的详细情况

Scheduler - scan_lock

• Scheduler stage total：scan_lock 中每个命令所处不同阶段的个数，正常情况下，不会在短时间内出现大量的错误
• Scheduler command duration：执行 scan_lock 命令所需花费的时间，正常情况下，应该小于 1s
• Scheduler latch wait duration：由于 latch wait 造成的时间开销，正常情况下，应该小于 1s
• Scheduler keys read：scan_lock 命令读取 key 的个数
• Scheduler keys written：scan_lock 命令写入 key 的个数
• Scheduler scan details：执行 scan_lock 命令时，扫描每个 CF 中 key 的详细情况
• Scheduler scan details [lock]：执行 scan_lock 命令时，扫描每个 lock CF 中 key 的详细情况
• Scheduler scan details [write]：执行 scan_lock 命令时，扫描每个 write CF 中 key 的详细情况
• Scheduler scan details [default]：执行 scan_lock 命令时，扫描每个 default CF 中 key 的详细情况

Scheduler - start_ts_mvcc

• Scheduler stage total：start_ts_mvcc 中每个命令所处不同阶段的个数，正常情况下，不会在短时间内出现大量的错误
• Scheduler command duration：执行 start_ts_mvcc 命令所需花费的时间，正常情况下，应该小于 1s
• Scheduler latch wait duration：由于 latch wait 造成的时间开销，正常情况下，应该小于 1s
• Scheduler keys read：start_ts_mvcc 命令读取 key 的个数
• Scheduler keys written：start_ts_mvcc 命令写入 key 的个数
• Scheduler scan details：执行 start_ts_mvcc 命令时，扫描每个 CF 中 key 的详细情况
• Scheduler scan details [lock]：执行 start_ts_mvcc 命令时，扫描每个 lock CF 中 key 的详细情况
• Scheduler scan details [write]：执行 start_ts_mvcc 命令时，扫描每个 write CF 中 key 的详细情况
• Scheduler scan details [default]：执行 start_ts_mvcc 命令时，扫描每个 default CF 中 key 的详细情况

Scheduler - unsafe_destroy_range

• Scheduler stage total：unsafe_destroy_range 中每个命令所处不同阶段的个数，正常情况下，不会在短时间内出现大量的错误
• Scheduler command duration：执行 unsafe_destroy_range 命令所需花费的时间，正常情况下，应该小于 1s
• Scheduler latch wait duration：由于 latch wait 造成的时间开销，正常情况下，应该小于 1s
• Scheduler keys read：unsafe_destroy_range 命令读取 key 的个数
• Scheduler keys written：unsafe_destroy_range 命令写入 key 的个数
• Scheduler scan details：执行 unsafe_destroy_range 命令时，扫描每个 CF 中 key 的详细情况
• Scheduler scan details [lock]：执行 unsafe_destroy_range 命令时，扫描每个 lock CF 中 key 的详细情况
• Scheduler scan details [write]：执行 unsafe_destroy_range 命令时，扫描每个 write CF 中 key 的详细情况
• Scheduler scan details [default]：执行 unsafe_destroy_range 命令时，扫描每个 default CF 中 key 的详细情况

Coprocessor

• Request duration：处理 coprocessor 读请求所花费的时间
• Wait duration：coprocessor 请求的等待时间，99.99% 的情况下，应该小于 10s
• Handle duration：处理 coprocessor 请求所花费的时间
• 95% Request duration by store：95% 的情况下，每个 TiKV 实例处理 coprocessor 读请求所花费的时间
• 95% Wait duration by store：95% 的情况下，每个 TiKV 实例上 coprocessor 请求的等待时间
• 95% Handle duration by store：95% 的情况下，每个 TiKV 实例处理 coprocessor 请求所花费的时间
• Request errors：下推的请求发生错误的个数，正常情况下，短时间内不应该有大量的错误
• DAG executors：DAG executor 的个数
• Scan keys：每个请求 scan key 的个数
• Scan details：scan 每个 CF 的详细情况
• Table Scan - Details by CF：table scan 针对每个 CF 的详细情况
• Index Scan - Details by CF：index scan 针对每个 CF 的详细情况
• Table Scan - Perf Statistics：执行 table sacn 的时候，根据 perf 统计的 RocksDB 内部 operation 的个数
• Index Scan - Perf Statistics：执行 index sacn 的时候，根据 perf 统计的 RocksDB 内部 operation 的个数

GC

• MVCC versions：每个 key 的版本个数
• MVCC delete versions：GC 删除掉的每个 key 的版本个数
• GC tasks：由 gc_worker 处理的 GC 任务的个数
• GC tasks Duration：执行 GC 任务时所花费的时间
• GC keys (write CF)：在 GC 过程中，write CF 中 受影响的 key 的个数
• TiDB GC actions result：TiDB Region 层面的 GC 结果
• TiDB GC worker actions：TiDB GC worker 的不同 action 的个数
• TiDB GC seconds：TiDB 执行 GC 花费的时间
• TiDB GC failure：TiDB GC job 失败的个数
• GC lifetime：TiDB 设置的 GC lifetime
• GC interval：TiDB 设置的 GC 间隔

Snapshot

• Rate snapshot message：发送 Raft snapshot 消息的速率
• 99% Handle snapshot duration：99% 的情况下，处理 snapshot 所需花费的时间
• Snapshot state count：不同状态的 snapshot 的个数
• 99.99% Snapshot size：99.99% 的 snapshot 的大小
• 99.99% Snapshot KV count：99.99% 的 snapshot 包含的 key 的个数

Task

• Worker handled tasks：worker 处理的任务个数
• Worker pending tasks：当前 worker 中，pending 和 running 的任务个数，正常情况下，应该小于 1000
• FuturePool handled tasks：future pool 处理的任务个数
• FuturePool pending tasks：当前 future pool 中，pending 和 running 的任务个数

Thread CPU

• Raft store CPU：raftstore 线程的 CPU 使用率，通常应低于 80%
• Async apply CPU：async apply 线程的 CPU 使用率，通常应低于 90%
• Scheduler CPU：scheduler 线程的 CPU 使用率，通常应低于 80%
• Scheduler worker CPU：scheduler worker 线程的 CPU 使用率
• Storage ReadPool CPU：Readpool 线程的 CPU 使用率
• Coprocessor CPU：coprocessor 线程的 CPU 使用率
• Snapshot worker CPU：snapshot worker 线程的 CPU 使用率
• Split check CPU：split check 线程的 CPU 使用率
• RocksDB CPU：RocksDB 线程的 CPU 使用率
• gRPC poll CPU：gRPC 线程的 CPU 使用率，通常应低于 80%

RocksDB - kv

• Get operations：get 操作的个数
• Get duration：get 操作的耗时
• Seek operations：seek 操作的个数
• Seek duration：seek 操作的耗时
• Write operations：write 操作的个数
• Write duration：write 操作的耗时
• WAL sync operations：sync WAL 操作的个数
• WAL sync duration：sync WAL 操作的耗时
• Compaction operations：compaction 和 flush 操作的个数
• Compaction duration：compaction 和 flush 操作的耗时
• SST read duration：读取 SST 所需的时间
• Write stall duration：由于 write stall 造成的时间开销，正常情况下应为 0
• Memtable size：每个 CF 的 memtable 的大小
• Memtable hit：memtable 的命中率
• Block cache size：block cache 的大小。如果将 shared block cache 禁用，即为每个 CF 的 block cache 的大小
• Block cache hit：block cache 的命中率
• Block cache flow：不同 block cache 操作的流量
• Block cache operations 不同 block cache 操作的个数
• Keys flow：不同操作造成的 key 的流量
• Total keys：每个 CF 中 key 的个数
• Read flow：不同读操作的流量
• Bytes / Read：每次读的大小
• Write flow：不同写操作的流量
• Bytes / Write：每次写的大小
• Compaction flow：compaction 相关的流量
• Compaction pending bytes：等待 compaction 的大小
• Read amplification：每个 TiKV 实例的读放大
• Compression ratio：每一层的压缩比
• Number of snapshots：每个 TiKV 的 snapshot 的数量
• Oldest snapshots duration：最旧的 snapshot 保留的时间
• Number files at each level：每一层的文件个数
• Ingest SST duration seconds：ingest SST 所花费的时间
• Stall conditions changed of each CF：每个 CF stall 的原因

RocksDB - raft

• Get operations：get 操作的个数
• Get duration：get 操作的耗时
• Seek operations：seek 操作的个数
• Seek duration：seek 操作的耗时
• Write operations：write 操作的个数
• Write duration：write 操作的耗时
• WAL sync operations：sync WAL 操作的个数
• WAL sync duration：sync WAL 操作的耗时
• Compaction operations：compaction 和 flush 操作的个数
• Compaction duration：compaction 和 flush 操作的耗时
• SST read duration：读取 SST 所需的时间
• Write stall duration：由于 write stall 造成的时间开销，正常情况下应为 0
• Memtable size：每个 CF 的 memtable 的大小
• Memtable hit：memtable 的命中率
• Block cache size：block cache 的大小。如果将 shared block cache 禁用，即为每个 CF 的 block cache 的大小
• Block cache hit：block cache 的命中率
• Block cache flow：不同 block cache 操作的流量
• Block cache operations 不同 block cache 操作的个数
• Keys flow：不同操作造成的 key 的流量
• Total keys：每个 CF 中 key 的个数
• Read flow：不同读操作的流量
• Bytes / Read：每次读的大小
• Write flow：不同写操作的流量
• Bytes / Write：每次写的大小
• Compaction flow：compaction 相关的流量
• Compaction pending bytes：等待 compaction 的大小
• Read amplification：每个 TiKV 实例的读放大
• Compression ratio：每一层的压缩比
• Number of snapshots：每个 TiKV 的 snapshot 的数量
• Oldest snapshots duration：最旧的 snapshot 保留的时间
• Number files at each level：每一层的文件个数
• Ingest SST duration seconds：ingest SST 所花费的时间
• Stall conditions changed of each CF：每个 CF stall 的原因

gRPC

• gRPC message count：每种 gRPC 消息的个数
• gRPC message failed：失败的 gRPC 消息的个数
• 99% gRPC message duration：在 99% gRPC 消息的执行时间
• gRPC GC message count：gRPC GC 消息的个数
• 99% gRPC KV GC message duration：在 99% 情况下，gRPC GC 消息的执行时间

PD

• PD requests：TiKV 发送给 PD 的请求个数
• PD request duration (average)：TiKV 发送给 PD 的请求所需的平均时间
• PD heartbeats：发送给 PD 的心跳个数
• PD validate peers：通过 PD 验证 TiKV 的 peer 有效的个数