更新时间：2026-06-11 GMT+08:00

使用虚表查询集群与表运维信息

GeminiDB Cassandra 提供额外内置虚表（位于system_views keyspace），用于监控集群、表及Token级别的运维指标（读写时延，系统配置参数，表级QPS等信息）。所有虚表仅支持查询，不可写入。

虚表名称	粒度	数据范围	查询代价	适用场景
node_stats	节点级	本地指标	小	节点状态监控。
table_stats	表级	本地指标	小	单节点表性能分析。
table_storage	表级	跨节点聚合	大	可以查询该实例下所有表的存储文件占用空间大小。其实现方式是通过调用文件系统命令，逐个统计每个表的存储占用量，因此查询耗时较大，尤其在超大实例下可能会出现超时情况。需要注意的是，该统计不包含备份文件及部分移动中的文件，因此统计结果可能与实例详情页面显示的总存储占用存在差异，仅供参考，不作为计费依据。
aggregate_table_stats	表级	跨节点聚合	大	全表QPS聚合监控。
token_stats	Token级	本地指标	小	Token分布与单Token性能指标。
token_stats_sensitive	Token级	本地指标	中等	需加锁的深度指标（慎用）。

cqlsh或者driver直接连接的节点即视作本地节点。如果连接时输入多个连接ip，查询连接节点可能为其中任意一个。

1. 查看节点整体状态。

SELECT * FROM system_views.node_stats;

2. 查看指定表的本地运维信息。如果计算节点没有对应表的token，部分信息为空。

SELECT * FROM system_views.table_stats  WHERE keyspace_name = 'test' AND table_name = 'users13';

3. 查看指定表的所有Token信息。如果没有对应表的token，信息为空。

SELECT * FROM system_views.token_stats  WHERE keyspace_name = 'test' AND table_name = 'users14';

4. 查看全表聚合指标（如总QPS）。

SELECT * FROM system_views.aggregate_table_stats  WHERE keyspace_name = 'test' AND table_name = 'users14';

node_stats（节点级）：均为本地节点统计值，非聚合值。

表1 **node_stats**指标说明
指标	说明
connected_clients_list	当前客户端连接ip列表。
connected_native_clients_count	当前客户端连接数。
max_background_compactions	最大后台compaction线程数。
read_threads	Read线程池线程数。
write_threads	Write线程池线程数。
is_io_blocked	当前节点是否在io block状态。
pending_range_reads_tasks	队列中的range read请求数。
pending_reads_tasks	队列中的read请求数。
pending_writes_tasks	队列中的 write请求数。

table_stats（表级）：均为本地节点统计值，非聚合值。

表2 **table_stats**指标说明
指标	说明
last_local_rw_access_timestamp_ms	该表最后一次读写的时间戳。
read_5min_qps	5分钟支平均每秒查询速率。
read_latency.mean_ms	平均Read时延。
read_latency.p99_ms	Read P99时延。
token_count_local	当前节点的该表token数。
token_count_total	该表总token数。
write_5min_qps	5分钟平均写入每秒写入速率。
write_latency.mean_ms	平均Write时延。
write_latency.p99_ms	Write P99时延。

token_stats（Token级）：均为本地节点统计值，非聚合值。

指标	说明
flushTime	memtable flush时延。
hard_pending_compaction_bytes_limit	待compaction的文件大小硬限制。
max_compaction_file_l0_file_num	最大l0 compaction输入文件数。
rocksdb_get_latency_micros	rocksdb get 时延。
rocksdb_seek_latency_micros	rocksdb seek时延。
rocksdb_write_latency_micros	rocksdb写时延。
row_key_size_bytes	key大小统计值。
row_large_row	大行统计值。
row_value_size_bytes	value大小统计值。
slowdown_writes_l0_file_num	l0 文件数，写降速触发阈值。
soft_pending_compaction_bytes_limit	待compaction的文件大小软限制。
stop_writes_l0_file_num	l0文件数，写阻塞触发阈值。

table_storage（聚合表级）：跨节点统计值。

指标	说明
space_used_bytes	该表用的文件系统中的数据文件大小，仅供参考。

aggregate_table_stats（聚合表级）：跨节点统计值。

父主题：最佳实践