# 运维监控
运维分两段展示：SQL 直查（集群实时状态，18 个只读命令）与 Autopilot API（DMS 监控）。
表1**SQL直查** 
| 编号 | 子命令               | 说明                                            |
|:---|:---|:---|
| 1   | session           | 活动会话（非 idle），--node/--limit 过滤。                  |
| 2  | lock             | 当前锁。                                            |
| 3 | active            | 活动查询。                                           |
| 4  | conn             | 连接汇总（按 database / user / addr / application）。 |
| 5    | pool                | 连接池汇总。                                        |
| 6  | queue            | 工作负载队列状态。                                      |
| 7    | user              | 数据库用户与角色。                                       |
| 8  | detail \[--pid\] | 会话详情（可按 PID 过滤）。                                |
| 9   | perf             | 数据库性能统计。                                      |
| 10 | wait              | 等待事件会话。                                         |
| 11  | wait-node        | 按节点等待事件。                                       |
| 12   | respool          | 资源池。                                           |
| 13    | deadlock        | 潜在死锁（未授予事务锁）。                                 |
| 14 | tablelock         | 表级锁。                                             |
| 15  | lwlock           | 轻量锁等待。                                        |
| 16  | memory           | 按节点内存使用。                                       |
| 17  | topsql            | Top SQL（按总耗时）。                                 |
| 18 | guc \[--name\] | GUC 参数（pg_settings，可按名称 LIKE 过滤）。             |
   
```
# 会话 / 连接
hwc-dws-cli ops session --format table 
hwc-dws-cli ops session --node cn --limit 50 
hwc-dws-cli ops conn --format table 
hwc-dws-cli ops pool  
# 锁与死锁
hwc-dws-cli ops lock --format table 
hwc-dws-cli ops tablelock 
hwc-dws-cli ops lwlock 
hwc-dws-cli ops deadlock  
# 等待事件 / 详情
hwc-dws-cli ops wait
hwc-dws-cli ops wait-node
hwc-dws-cli ops detail --pid 12345  
# 资源与性能
hwc-dws-cli ops respool 
hwc-dws-cli ops queue 
hwc-dws-cli ops user 
hwc-dws-cli ops perf 
hwc-dws-cli ops memory --format table  
# Top SQL / GUC
hwc-dws-cli ops topsql --limit 20 
hwc-dws-cli ops guc --name work_mem
```
表2**Autopilot监控（DMS API）** 
| 命令                                                                       | 说明                               |
|:---|:---|
| ops metric \<name\> \[--from\] \[--to\] \[--limit\] \[--offset\]          | 集群指标数据（DMS API，时间戳为毫秒，默认近 1 小时）。 |
| ops metric-list \[--keyword\] \[--limit\]                                | 可用 DWS 指标名列表（支持客户端关键词过滤）。      |
| ops host-list \[--instance-name\] \[--limit\]                             | 集群主机概览。                           |
| ops alarm show \[--from\] \[--to\] \[--time-zone\] \[--limit\]            | 告警列表（DBSEvent API，默认近 6 天）。     |
| ops alarm search \[--keyword\] \[--cluster\] \[--severity\] \[--status\] | 告警搜索（客户端过滤：关键词 / 集群 / 级别 / 状态）。  |
   
```
# 指标数据（RFC3339 时间，默认近 1 小时）
hwc-dws-cli ops metric cpu_usage --format table 
hwc-dws-cli ops metric disk_usage --from 2026-10-14T00:00:00Z --to 2026-10-14T12:00:00Z  
# 指标名列表（可按关键词过滤）
hwc-dws-cli ops metric-list --keyword cpu  
# 主机概览
hwc-dws-cli ops host-list --format table 
hwc-dws-cli ops host-list --instance-name dn_1  
# 告警（show 与 search）
hwc-dws-cli ops alarm show --format table 
hwc-dws-cli ops alarm search --severity urgent --format table 
hwc-dws-cli ops alarm search --keyword "connection" --cluster <cluster_id> --status 0
```
