tikv config: 补充 resource-metering.enable-network-io-collection 配置项说明

tikv-configuration-file.md

@@ -2675,6 +2675,21 @@ Raft Engine 相关的配置项。
 + 在默认的一个 TSO 物理时钟更新周期内 (50ms)，PD 最多提供 262144 个 TSO，超过这个数量后 PD 会暂缓 TSO 请求的处理。这个配置用于避免 PD 的 TSO 消耗殆尽、影响其他业务的使用。如果增大这个参数，建议同时减小 PD 的 [`tso-update-physical-interval`](/pd-configuration-file.md#tso-update-physical-interval) 参数，以获得足够的 TSO。
 + 默认值：8192
 
+## resource-metering
+
+资源计量 (Resource Metering) 相关的配置项。
+
+### `enable-network-io-collection`
+
++ 是否在 TopSQL 中额外采集网络流量和逻辑 I/O 信息。
++ 开启后，TiKV 会在请求处理过程中额外记录网络入站字节数、网络出站字节数、逻辑读字节数和逻辑写字节数。
++ 在资源消耗上报时，TiKV 会同时考虑 CPU 时间、网络流量和逻辑 I/O 来筛选 Top N 记录，并额外按 Region 维度上报这些统计结果，便于更细粒度地分析热点请求或资源消耗来源。
++ 默认值：false
+
+> **注意：**
+>
+> 逻辑 I/O 指请求在 TiKV 存储层处理的逻辑数据量，例如读取过程中扫描或处理的数据量，以及写请求自身的逻辑写入字节数；物理 I/O 指底层存储设备实际发生的磁盘读写流量，会受到 block cache、compaction、flush 等因素影响。因此，逻辑 I/O 与实际物理 I/O 并不等价，也不能直接一一对应。
+
 ## resource-control
 
 资源控制 (Resource Control) 在 TiKV 存储层相关的配置项。