SHOW PROC
功能
查看当前集群中的特定指标。
注意
该操作需要 SYSTEM 级 OPERATE 权限。
语法
SHOW PROC { '/backends' | '/compute_nodes' | '/dbs' | '/jobs'
| '/statistic' | '/tasks' | '/frontends' | '/brokers'
| '/resources' | '/load_error_hub' | '/transactions'
| '/monitor' | '/current_queries' | '/current_backend_instances'
| '/cluster_balance' | '/routine_loads' | '/colocation_group'
| '/catalog' | '/replications' }
参数说明
参数 | 说明 |
---|---|
'/backends' | 查看当前集群的 BE 节点信息。 |
'/compute_nodes' | 查看当前集群的 CN 节点信息。 |
'/dbs' | 查看当前集群的数据库信息。 |
'/jobs' | 查看当前集群的作业信息。 |
'/statistic' | 查看当前集群各数据库的统计信息。 |
'/tasks' | 查看当前集群各种任务类型的总数和失败总数。 |
'/frontends' | 查看当前集群的 FE 节点信息。 |
'/brokers' | 查看当前集群的 Broker 节点信息。 |
'/resources' | 查看当前集群的资源信息。 |
'/load_error_hub' | 查看当前集群的 Error Hub 的配置信息。Error Hub 用于管理导入作业产生的错误信息。 |
'/transactions' | 查看当前集群的事务信息。 |
'/monitor' | 查看当前集群的监控信息。 |
'/current_queries' | 查看当前连接的FE节点正在执行的查询信息。 |
'/current_backend_instances' | 查看当前集群正在执行作业的 BE 节点。 |
'/cluster_balance' | 查看当前集群的负载信息。 |
'/routine_loads' | 查看当前集群的 Routine Load 导入信息。 |
'/colocation_group' | 查看当前集群的 Colocate Join Group 信息。 |
'/catalog' | 查看当前集群的 Catalog 信息。 |
'/replications' | 查看当前集群的数据迁移任务信息。 |
示例
示例一:查看当前集群的 BE 节点信息。
mysql> SHOW PROC '/backends'\G
*************************** 1. row ***************************
BackendId: 10004
IP: xxx.xx.92.200
HeartbeatPort: 9354
BePort: 9360
HttpPort: 8338
BrpcPort: 8360
LastStartTime: 2023-04-21 09:56:10
LastHeartbeat: 2023-04-21 09:56:10
Alive: true
SystemDecommissioned: false
ClusterDecommissioned: false
TabletNum: 2199
DataUsedCapacity: 0.000
AvailCapacity: 584.578 GB
TotalCapacity: 1.968 TB
UsedPct: 71.00 %
MaxDiskUsedPct: 71.00 %
ErrMsg:
Version: BRANCH-3.0-RELEASE-8eb8705
Status: {"lastSuccessReportTabletsTime":"N/A"}
DataTotalCapacity: 584.578 GB
DataUsedPct: 0.00 %
CpuCores: 16
NumRunningQueries: 0
MemUsedPct: 0.52 %
CpuUsedPct: 0.0 %
返回 | 说明 |
---|---|
BackendId | BE 节点 ID。 |
IP | BE 节点 IP 地址。 |
HeartbeatPort | BE 节点心跳服务端口。 |
BePort | BE 节点 Thrift Server 端口。 |
HttpPort | BE 节点 HTTP Server 端口。 |
BrpcPort | BE 节点 bRPC 端口。 |
LastStartTime | BE 节点上一次启动时间。 |
LastHeartbeat | BE 节点上一次接受 FE 心跳时间。 |
Alive | BE 节点存活状态。 |
SystemDecommissioned | BE 节点是否正在下线。 |
ClusterDecommissioned | BE 节点是否正在集群中下线。 |
TabletNum | BE 节点 Tablet 数量。 |
DataUsedCapacity | BE 节点被占用的存储空间。 |
AvailCapacity | BE 节点剩余存储空间。 |
TotalCapacity | BE 节点总存储空间。 |
UsedPct | BE 节点当前存储空间占用比例。 |
MaxDiskUsedPct | BE 节点最大存储空间占用比例。 |
ErrMsg | BE 节点错误信息。 |
Version | BE 节点 StarRocks 版本。 |
Status | BE节点状态信息,包含最近一次 BE 汇报 Tablet 的时间信息。 |
DataTotalCapacity | 数据文件所占用的磁盘空间 + 可用磁盘空间,即 DataUsedCapacity + AvailCapacity。 |
DataUsedPct | 数据文件占用磁盘的比例,即 DataUsedCapacity/DataTotalCapacity。 |
CpuCores | BE 节点 CPU 核数。 |
NumRunningQueries | 当前运行中的查询数量。 |
MemUsedPct | 当前内存使用占比。 |
CpuUsedPct | 当前 CPU 使用占比。 |
示例二:查看当前集群的数据库信息。
mysql> SHOW PROC '/dbs';
+---------+------------------------+----------+----------------+--------------------------+---------------------+
| DbId | DbName | TableNum | Quota | LastConsistencyCheckTime | ReplicaQuota |
+---------+------------------------+----------+----------------+--------------------------+---------------------+
| 1 | information_schema | 22 | 8388608.000 TB | NULL | 9223372036854775807 |
| 840997 | tpcds_100g | 25 | 1024.000 GB | NULL | 1073741824 |
| 1275196 | _statistics_ | 3 | 8388608.000 TB | 2022-09-06 23:00:58 | 9223372036854775807 |
| 1286207 | tpcds_n | 24 | 8388608.000 TB | NULL | 9223372036854775807 |
| 1381289 | test | 6 | 8388608.000 TB | 2022-01-14 23:10:18 | 9223372036854775807 |
| 6186781 | test_stddev | 1 | 8388608.000 TB | 2022-09-06 23:00:58 | 9223372036854775807 |
+---------+------------------------+----------+----------------+--------------------------+---------------------+
返回 | 说明 |
---|---|
DbId | 数据库 ID。 |
DbName | 数据库名称。 |
TableNum | 数据库包含表数量。 |
Quota | 数据库设置的存储配额。 |
LastConsistencyCheckTime | 数据库上一次一致性检查时间。 |
ReplicaQuota | 数据库的副本配额。 |
示例三:查看当前集群的作业信息。您可以通过对应的 DbId
进一步查询该数据库中的详细作业信息。
mysql> SHOW PROC '/jobs';
+-------+--------------------------------------+
| DbId | DbName |
+-------+--------------------------------------+
| 10005 | default_cluster:_statistics_ |
| 0 | default_cluster:information_schema |
| 12711 | default_cluster:starrocks_audit_db__ |
+-------+--------------------------------------+
3 rows in set (0.00 sec)
mysql> SHOW PROC '/jobs/10005';
+---------------+---------+---------+----------+-----------+-------+
| JobType | Pending | Running | Finished | Cancelled | Total |
+---------------+---------+---------+----------+-----------+-------+
| load | 0 | 0 | 3 | 0 | 3 |
| rollup | 0 | 0 | 0 | 0 | 0 |
| schema_change | 0 | 0 | 0 | 0 | 0 |
| export | 0 | 0 | 0 | 0 | 0 |
+---------------+---------+---------+----------+-----------+-------+
4 rows in set (0.00 sec)
返回 | 说明 |
---|---|
DbId | 数据库 ID。 |
DbName | 数据库名称。 |
JobType | 作业类型。 |
Pending | 待执行作业数。 |
Running | 正在执行作业数。 |
Finished | 已完成作业数。 |
Cancelled | 已取消作业数。 |
Total | 总作业数。 |
示例四:查看当前集群各数据库的统计信息。
mysql> SHOW PROC '/statistic';
+--------+----------------------------------------------------------+----------+--------------+----------+-----------+------------+--------------------+-----------------------+------------------+---------------------+
| DbId | DbName | TableNum | PartitionNum | IndexNum | TabletNum | ReplicaNum | UnhealthyTabletNum | InconsistentTabletNum | CloningTabletNum | ErrorStateTabletNum |
+--------+----------------------------------------------------------+----------+--------------+----------+-----------+------------+--------------------+-----------------------+------------------+---------------------+
| 10004 | _statistics_ | 3 | 3 | 3 | 30 | 60 | 0 | 0 | 0 | 0 |
| 1 | information_schema | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 |
| 92498 | stream_load_test_db_03afc714_b1cb_11ed_a82c_00163e237e98 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 |
| 92542 | stream_load_test_db_79876e92_b1da_11ed_b50e_00163e237e98 | 1 | 1 | 1 | 3 | 3 | 0 | 0 | 0 | 0 |
| 115476 | testdb | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 |
| 10002 | zq_test | 8 | 8 | 8 | 5043 | 7063 | 0 | 0 | 0 | 2 |
| Total | 6 | 12 | 12 | 12 | 5076 | 7126 | 0 | 0 | 0 | 2 |
+--------+----------------------------------------------------------+----------+--------------+----------+-----------+------------+--------------------+-----------------------+------------------+---------------------+
7 rows in set (0.01 sec)
mysql> show proc '/statistic/10002';
+------------------+---------------------+----------------+-------------------+
| UnhealthyTablets | InconsistentTablets | CloningTablets | ErrorStateTablets |
+------------------+---------------------+----------------+-------------------+
| [] | [] | [] | [116703, 116706] |
+------------------+---------------------+----------------+-------------------+
返回 | 说明 |
---|---|
DbId | 数据库 ID。 |
DbName | 数据库名称。 |
TableNum | 数据库中表的数量。 |
PartitionNum | 数据库中分区的数量。 |
IndexNum | 数据库中索引的数量。 |
TabletNum | 数据库中 Tablet 的数量。 |
ReplicaNum | 数据库中副本的数量。 |
UnhealthyTabletNum | 数据重分布过程中还未完成的 Tablet 数量。 |
InconsistentTabletNum | 数据库中不一致的 Tablet 数量。 |
CloningTabletNum | 数据库中正在进行 Clone 操作的 Tablet 数量。 |
ErrorStateTabletNum | 主键表中错误状态的 Tablet 数量。 |
ErrorStateTablets | 主键表中错误状态的 Tablet 的 ID。 |
示例五:查看当前集群各种任务类型的总数和失败总数。
mysql> SHOW PROC '/tasks';
+-------------------------+-----------+----------+
| TaskType | FailedNum | TotalNum |
+-------------------------+-----------+----------+
| CREATE | 0 | 0 |
| DROP | 0 | 0 |
| PUSH | 0 | 0 |
| CLONE | 0 | 0 |
| STORAGE_MEDIUM_MIGRATE | 0 | 0 |
| ROLLUP | 0 | 0 |
| SCHEMA_CHANGE | 0 | 0 |
| CANCEL_DELETE | 0 | 0 |
| MAKE_SNAPSHOT | 0 | 0 |
| RELEASE_SNAPSHOT | 0 | 0 |
| CHECK_CONSISTENCY | 0 | 0 |
| UPLOAD | 0 | 0 |
| DOWNLOAD | 0 | 0 |
| CLEAR_REMOTE_FILE | 0 | 0 |
| MOVE | 0 | 0 |
| REALTIME_PUSH | 0 | 0 |
| PUBLISH_VERSION | 0 | 0 |
| CLEAR_ALTER_TASK | 0 | 0 |
| CLEAR_TRANSACTION_TASK | 0 | 0 |
| RECOVER_TABLET | 0 | 0 |
| STREAM_LOAD | 0 | 0 |
| UPDATE_TABLET_META_INFO | 0 | 0 |
| ALTER | 0 | 0 |
| INSTALL_PLUGIN | 0 | 0 |
| UNINSTALL_PLUGIN | 0 | 0 |
| NUM_TASK_TYPE | 0 | 0 |
| Total | 0 | 0 |
+-------------------------+-----------+----------+
返回 | 说明 |
---|---|
TaskType | 任务类型。 |
FailedNum | 失败任务数。 |
TotalNum | 总任务数。 |
示例六:查看当前集群的 FE 节点信息。
mysql> SHOW PROC '/frontends';
+----------------------------------+---------------+-------------+----------+-----------+---------+----------+------------+-------+-------+-------------------+---------------+----------+---------------+-----------+---------+
| Name | IP | EditLogPort | HttpPort | QueryPort | RpcPort | Role | ClusterId | Join | Alive | ReplayedJournalId | LastHeartbeat | IsHelper | ErrMsg | StartTime | Version |
+----------------------------------+---------------+-------------+----------+-----------+---------+----------+------------+-------+-------+-------------------+---------------+----------+---------------+-----------+---------+
| xxx.xx.xx.xxx_9009_1600088918395 | xxx.xx.xx.xxx | 9009 | 7390 | 0 | 0 | FOLLOWER | 1747363037 | false | false | 0 | NULL | true | got exception | NULL | NULL |
+----------------------------------+---------------+-------------+----------+-----------+---------+----------+------------+-------+-------+-------------------+---------------+----------+---------------+-----------+---------+
返回 | 说明 |
---|---|
Name | FE 节点名称。 |
IP | FE 节点 IP 地址。 |
EditLogPort | FE 节点之间的通信端口。 |
HttpPort | FE 节点 HTTP Server 端口。 |
QueryPort | FE 节点 MySQL Server 端口。 |
RpcPort | FE 节点 RPC 端口。 |
Role | FE 节点角色(Leader、Follower 或 Observer)。 |
ClusterId | 集群 ID。 |
Join | FE 节点是否曾加入过集群。 |
Alive | FE 节点存活状态。 |
ReplayedJournalId | FE 节点已回放过的最大元数据日志 ID。 |
LastHeartbeat | FE 节点上一次发送心跳时间。 |
IsHelper | FE 节点是否为 BDBJE 的 Helper 节点。 |
ErrMsg | FE 节点错误信息。 |
StartTime | FE 节点启动时间。 |
Version | FE 节点 StarRocks 版本。 |
示例七:查看当前集群的 Broker 节点信息。
mysql> SHOW PROC '/brokers';
+-------------+---------------+------+-------+---------------+---------------------+--------+
| Name | IP | Port | Alive | LastStartTime | LastUpdateTime | ErrMsg |
+-------------+---------------+------+-------+---------------+---------------------+--------+
| hdfs_broker | xxx.xx.xx.xxx | 8500 | true | NULL | 2022-10-10 16:37:59 | |
| hdfs_broker | xxx.xx.xx.xxx | 8500 | true | NULL | 2022-10-10 16:37:59 | |
| hdfs_broker | xxx.xx.xx.xxx | 8500 | true | NULL | 2022-10-10 16:37:59 | |
+-------------+---------------+------+-------+---------------+---------------------+--------+
返回 | 说明 |
---|---|
Name | Broker 节点名称。 |
IP | Broker 节点 IP 地址。 |
Port | Broker 节点的 Thrift Server 端口,用于接收请求。 |
Alive | Broker 节点存活状态。 |
LastStartTime | Broker 节点上一次启动时间。 |
LastUpdateTime | Broker 节点上一次更新时间。 |
ErrMsg | Broker 节点错误信息。 |
示例八:查看当前集群的资源信息。
mysql> SHOW PROC '/resources';
+-------------------------+--------------+---------------------+------------------------------+
| Name | ResourceType | Key | Value |
+-------------------------+--------------+---------------------+------------------------------+
| hive_resource_stability | hive | hive.metastore.uris | thrift://xxx.xx.xxx.xxx:9083 |
| hive2 | hive | hive.metastore.uris | thrift://xxx.xx.xx.xxx:9083 |
+-------------------------+--------------+---------------------+------------------------------+
返回 | 说明 |
---|---|
Name | 资源名称。 |
ResourceType | 资源类型。 |
Key | 资源关键字。 |
Value | 资源值。 |
示例九:查看当前集群的事务信息。您可以通过对应的 DbId
进一步查询该数据库中的详细事务信息。
mysql> SHOW PROC '/transactions';
+-------+--------------------------------------+
| DbId | DbName |
+-------+--------------------------------------+
| 10005 | default_cluster:_statistics_ |
| 12711 | default_cluster:starrocks_audit_db__ |
+-------+--------------------------------------+
2 rows in set (0.00 sec)
mysql> SHOW PROC '/transactions/10005';
+----------+--------+
| State | Number |
+----------+--------+
| running | 0 |
| finished | 4 |
+----------+--------+
2 rows in set (0.00 sec)
返回 | 说明 |
---|---|
DbId | 数据库 ID。 |
DbName | 数据库名称。 |
State | 事务状态。 |
Number | 事务数量。 |
示例十:查看当前集群的监控信息。
mysql> SHOW PROC '/monitor';
+------+------+
| Name | Info |
+------+------+
| jvm | |
+------+------+
返回 | 说明 |
---|---|
Name | JVM 名称。 |
Info | JVM 信息。 |
示例十一:查看当前集群的负载信息。
mysql> SHOW PROC '/cluster_balance';
+-------------------+--------+
| Item | Number |
+-------------------+--------+
| cluster_load_stat | 1 |
| working_slots | 3 |
| sched_stat | 1 |
| priority_repair | 0 |
| pending_tablets | 2001 |
| running_tablets | 0 |
| history_tablets | 1000 |
+-------------------+--------+
返回 | 说明 |
---|---|
Item | cluster_balance 中的子命令。
|
Number | cluster_balance 中每个子命令正在执行的个数。 |
示例十二:查看当前集群的 Colocate Join Group 信息。
mysql> SHOW PROC '/colocation_group';
+-----------------+----------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------+------------+----------------+-------------+----------+
| GroupId | GroupName | TableIds | BucketsNum | ReplicationNum | DistCols | IsStable |
+-----------------+----------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------+------------+----------------+-------------+----------+
| 24010.177354 | 24010_lineitem_str_g1 | 177672 | 12 | 1 | varchar(-1) | true |
| 24010.182146 | 24010_lineitem_str_g2 | 182144 | 192 | 1 | varchar(-1) | true |
| 1439318.1735496 | 1439318_group_agent_uid | 1735677, 1738390 | 12 | 2 | bigint(20) | true |
| 24010.37804 | 24010_gsdaf2449s9e | 37802 | 192 | 1 | int(11) | true |
| 174844.175370 | 174844_groupa4 | 175368, 591307, 591362, 591389, 591416 | 12 | 1 | int(11) | true |
| 24010.30587 | 24010_group2 | 30585, 30669 | 12 | 1 | int(11) | true |
| 10005.181366 | 10005_lineorder_str_normal | 181364 | 192 | 1 | varchar(-1) | true |
| 1904968.5973175 | 1904968_groupa2 | 5973173 | 12 | 1 | int(11) | true |
| 24010.182535 | 24010_lineitem_str_g3 | 182533 | 192 | 1 | varchar(-1) | true |
+-----------------+----------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------+------------+----------------+-------------+----------+
返回 | 说明 |
---|---|
GroupId | Colocate Join Group 的 ID。 |
GroupName | Colocate Join Group 的名称。 |
TableIds | Colocate Join Group 所包含的表的 ID。 |
BucketsNum | Colocate Join Group 的分桶数。 |
ReplicationNum | Colocate Join Group 的副本数。 |
DistCols | Colocate Join Group 的分桶列类型。 |
IsStable | Colocate Join Group 是否稳定。 |
示例十三:查看当前集群的 Catalog 信息。
mysql> SHOW PROC '/catalog';
+--------------------------------------------------------------+----------+----------------------+
| Catalog | Type | Comment |
+--------------------------------------------------------------+----------+----------------------+
| resource_mapping_inside_catalog_hive_hive2 | hive | mapping hive catalog |
| resource_mapping_inside_catalog_hive_hive_resource_stability | hive | mapping hive catalog |
| default_catalog | Internal | Internal Catalog |
+--------------------------------------------------------------+----------+----------------------+
返回 | 说明 |
---|---|
Catalog | Catalog 名称。 |
Type | Catalog 类型。 |
Comment | Catalog 描述。 |
示例十四:查看当前集群的数据迁移任务信息。
mysql> SHOW PROC '/replications';
+-------------------------------------------------+------------+---------+-------+---------------------+---------------------+-----------+----------+-------+
| JobID | DatabaseID | TableID | TxnID | CreatedTime | FinishedTime | State | Progress | Error |
+-------------------------------------------------+------------+---------+-------+---------------------+---------------------+-----------+----------+-------+
| FAILOVER_GROUP_group1-11006-11010-1725593360156 | 11006 | 11010 | 99 | 2024-09-06 11:29:20 | 2024-09-06 11:29:21 | COMMITTED | | |
| FAILOVER_GROUP_group1-11006-11009-1725593360161 | 11006 | 11009 | 98 | 2024-09-06 11:29:20 | 2024-09-06 11:29:21 | COMMITTED | | |
| FAILOVER_GROUP_group1-11006-11074-1725593360161 | 11006 | 11074 | 100 | 2024-09-06 11:29:20 | 2024-09-06 11:29:21 | COMMITTED | | |
| FAILOVER_GROUP_group1-11006-12474-1725593360250 | 11006 | 12474 | 102 | 2024-09-06 11:29:20 | 2024-09-06 11:29:24 | COMMITTED | | |
| FAILOVER_GROUP_group1-11006-11024-1725593360293 | 11006 | 11024 | 101 | 2024-09-06 11:29:20 | 2024-09-06 11:29:24 | COMMITTED | | |
| FAILOVER_GROUP_group1-11006-13861-1725607270963 | 11006 | 13861 | 627 | 2024-09-06 15:21:10 | 2024-09-06 15:21:14 | COMMITTED | | |
+-------------------------------------------------+------------+---------+-------+---------------------+---------------------+-----------+----------+-------+
返回 | 说明 |
---|---|
JobID | 作业 ID。 |
DatabaseID | 数据库 ID。 |
TableID | 表 ID。 |
TxnID | 事务 ID。 |
CreatedTime | 任务创建时间。 |
FinishedTime | 任务完成时间。 |
State | 任务状态。有效值:INITIALIZING、SNAPSHOTING、REPLICATING、COMMITTED、ABORTED。 |
Progress | 任务进度。 |
Error | 错误信息(如有)。 |