用途:该技能通过 Glances REST API(v4)只读访问系统指标,用于查询服务器健康与资源使用情况。触发场景包括系统健康、CPU/内存/磁盘占用、容器统计、进程列表等。
主要能力:可获取 CPU 总体与每核使用率、负载均值;内存与交换分区;磁盘 I/O 与文件系统空间;各网卡流量、IP、WiFi 信号与 TCP 连接状态;温度、风扇、电池及 GPU 传感器;Docker/Podman 容器统计;进程列表与状态计数;系统告警与插件列表。所有操作均为只读 GET 请求。
使用方式:先在目标系统以服务模式启动 Glances,例如 glances -w --disable-webui(仅 API)或 glances -w(API 加 Web UI)。在 ~/.homelab-skills/.env 中配置 GLANCES_URL(默认端口 61208)、GLANCES_USERNAME、GLANCES_PASSWORD(无认证可留空)。随后调用脚本,如 ./scripts/glances-api.sh dashboard、cpu、mem、fs、processlist --top 10、containers、alert、sensors 等,输出为 JSON,可用 jq 格式化。
适用场景:服务器日常巡检、资源瓶颈排查、容器与进程监控、温度与磁盘健康检查。
限制:需要网络访问 Glances 服务器;部分插件在无对应硬件时返回空数据;认证可选;多服务器支持需脚本更新,资料注明尚未实现;通过 zsh-tool 调用脚本时须使用 pty: true,否则输出不可见。