glances 4.5.8 常用 CLI 命令与工具详解
glances 4.5.8 六种运行模式实测:TUI/stdout/Web+REST API 分层取数/client-server 远程监控/中央浏览器/CSV 与 JSON 导出,含 --password 排障实录与参数速查表。
glances 4.5.8 常用 CLI 命令与工具详解
目标:系统梳理 glances 4.5.8 的全部运行模式与命令行用法——standalone(TUI/stdout)、Web 服务器与 REST API、client/server 远程监控、中央浏览器与导出器,每条命令均给出真实回显与参数速查。全部命令与输出均在 Ubuntu 24.04.5 服务器(glances 4.5.8 pipx 安装,PsUtil 7.2.2)实测通过。
一、环境信息
- 操作系统:Ubuntu 24.04.5 LTS(x86_64,内核 6.8.0-138-generic,12 CPU 核,31GB 内存)
- glances 版本:4.5.8(
pipx install 'glances[all]'安装,可执行文件/root/.local/bin/glances;安装过程见《Ubuntu 24.04 安装 glances 4.5.8 指南》) - 实测端口:Web/API 模式 61208;client/server 模式 61209
- 配置文件:
/etc/glances/glances.conf(v4.5.8 官方模板,参数详解见《glances 4.5.8 配置参数详解》)
二、工具概览
glances 是单一命令 glances 的多模式工具,没有子命令体系,运行模式由选项决定。六种运行模式与对应的启动选项:
| 模式 | 启动命令 | 默认端口 | 用途 |
|---|---|---|---|
| standalone(TUI) | glances | — | 终端全屏实时监控(本机) |
| standalone(stdout) | glances --stdout | — | 面向脚本的单行/JSON/CSV 输出 |
| Web 服务器 | glances -w | 61208 | WebUI + REST API(FastAPI/Uvicorn) |
| server(XML-RPC) | glances -s | 61209 | 被客户端连接的服务端 |
| client | glances -c <host> | 61209 | 连接 server 远程监控 |
| 中央浏览器 | glances --browser | 61209 | 多台 server 集中浏览(TUI) |
| 导出 | glances --export <目标> | — | 统计外发(CSV/JSON/文件/时序库) |
💡 技术拓展:glances 的「远程数据获取」通道不止 client/server 一条,常见三类对比——① XML-RPC(
-s/-c,61209 端口,TUI 客户端直连,轻量);② RESTful API(-w,61208 端口,HTTP/JSON,适合脚本与二次开发,也可用--browser -w的 WebUI 中央浏览器);③ SNMP(--snmp-community等参数,对无法装 glances 的网络设备采集)。本文按 ①→② 实测,③ 仅列参数。本文实测采用 XML-RPC 与 RESTful 双通道。
三、前置条件
- glances 4.5.8 已安装且
glances --version正常输出; - Web 模式需要
[web]extras(pipx[all]或[web]安装已包含,FastAPI/Uvicorn/Jinja2); - 文中 REST API 示例统一用
curl访问http://127.0.0.1:61208/api/4/...,无需认证(默认配置未启用 JWT)。
四、版本与模块信息命令
4.1 查看版本
glances --version
Glances version: 4.5.8
Glances API version: 4
PsUtil version: 7.2.2
Log file: /root/.local/share/glances/glances.log
要点解读:三行分别对应 glances 版本、REST API 版本(URL 前缀 /api/4 的依据)与底层 psutil 版本;日志文件路径随运行用户变化(root 在 /root/.local/share/glances/)。注意 3.x 老版本输出是单行 Glances v3.4.0.3 with PsUtil v5.9.8 格式,可据此快速分辨大版本(apt 发行版包场景)。
4.2 列出全部模块(插件与导出器)
glances --module-list
Plugins list: alert, amps, cloud, connections, containers, core, cpu, diskio, folders, fs, gpu, help, ip, irq, load, mem, memswap, mpp, network, now, npu, percpu, ports, processcount, processlist, programlist, psutilversion, quicklook, raid, sensors, smart, system, uptime, version, vms, wifi
Exporters list: cassandra, clickhouse, couchdb, csv, duckdb, elasticsearch, graph, graphite, influxdb, influxdb2, influxdb3, json, kafka, mongodb, mqtt, nats, opentsdb, prometheus, rabbitmq, restful, riemann, statsd, timescaledb, zeromq
要点解读:v4.5.8 内置 36 个插件与 24 个导出器;两个清单的名字就是 --disable-plugin <名>、--export <名> 的合法取值。
4.3 命令行参数速查(--help 分组解读)
glances --help 全文共 234 行(实测),按用途分组的高频参数如下(默认值均为 help 原文标注的真实默认):
显示控制类:
| 参数 | 作用 | 默认值 |
|---|---|---|
-t TIME, --time | 刷新间隔(秒) | 2 |
-1, --percpu | 每核 CPU 视图 | 关 |
-0, --disable-irix | 单进程 CPU 按全机核数折算 | 关(默认单进程口径) |
-2, --disable-left-sidebar | 关闭左侧栏(网络/磁盘/FS/传感器) | 关 |
-3, --disable-quicklook | 关闭概览区 | 关 |
-5, --disable-top | 关闭顶部菜单(QL/CPU/MEM/SWAP/LOAD) | 关 |
--light | 轻量模式(只留顶部菜单) | 关 |
-b, --byte | 网络速率按字节显示 | 关(按 bit) |
--diskio-iops | 磁盘 IO 显示 IOPS | 关(显示速率) |
--diskio-latency | 磁盘 IO 显示延迟 | 关 |
--fahrenheit | 温度用华氏度 | 关(摄氏) |
--fs-free-space | FS 显示剩余而非已用 | 关 |
--sparkline | 用火花线代替进度条(curses) | 关 |
--sort-processes <key> | 进程排序键 | cpu_percent,memory_percent,username,cpu_times,io_counters,name,cpu_num 之一(自动) |
-f, --process-filter | 进程过滤(正则) | 无 |
--hide-kernel-threads | 隐藏内核线程 | 关 |
模式与连接类:
| 参数 | 作用 | 默认值 |
|---|---|---|
-w, --webserver | Web 服务器模式 | 关 |
--disable-webui | 只开 API 不开 WebUI | 关 |
-s, --server | XML-RPC 服务端 | 关 |
-c CLIENT, --client | 连接服务端 | 无 |
--browser | 中央浏览器(加 -w 为 WebUI 版) | 关 |
-p PORT, --port | client/server 端口 | 61209 |
-B, --bind | 服务端绑定地址 | 全部接口 |
-u USERNAME_USED | 用户名 | glances |
--password | 触发密码设置/输入(交互式,不接值) | 关 |
--snmp-community | SNMP 团体字 | public |
--snmp-port | SNMP 端口 | 161 |
--snmp-version | SNMP 版本 | 2c(可选 1/2c/3) |
--snmp-force | 强制 SNMP 模式 | 关 |
--disable-autodiscover | 关闭局域网自动发现(UDP 广播) | 关 |
导出与输出类:
| 参数 | 作用 | 默认值 |
|---|---|---|
--export EXPORT | 启用导出模块(逗号分隔,见 4.2 Exporters 清单) | 无 |
--export-csv-file <路径> | CSV 导出文件 | — |
--export-csv-overwrite | 覆盖已有 CSV | 追加 |
--export-json-file <路径> | JSON 导出文件 | — |
--export-graph-path <目录> | SVG 图表输出目录 | 配置 [graph] path=/tmp/glances |
--export-process-filter | 仅导出匹配进程 | 无 |
--stdout <清单> | stdout 模式(plugin 或 plugin.attribute 逗号分隔) | 无 |
--stdout-json <清单> | stdout JSON 模式 | 无 |
--stdout-csv <清单> | stdout CSV 模式 | 无 |
运行与诊断类:
| 参数 | 作用 | 默认值 |
|---|---|---|
-q, --quiet | 不显示 curses 界面(配导出/stdout 用) | 关 |
--stop-after N | 刷新 N 次后退出 | 无限 |
-C CONF_FILE, --config | 指定配置文件 | 按查找顺序 |
--enable-mcp | Web 模式附带 MCP 服务器 | 关(挂载路径 /mcp) |
--cached-time | 服务端缓存时间 | 1 秒 |
--disable-plugin <清单> | 禁插件(可 all) | 无 |
--enable-plugin <清单> | 启插件(配 all 用) | 无 |
--disable-history | 关闭内存历史 | 关 |
--issue | 测试全部插件并输出诊断后退出 | — |
--api-restful-doc | 输出 RESTful API 文档 | — |
--fetch | 输出 (neo)fetch 风格摘要并退出 | — |
--disable-config-exec | 禁配置中的命令执行(官方推荐服务场景加) | 关 |
五、standalone 模式:TUI 与 stdout
5.1 终端 TUI(glances 直接运行)
glances
这是 glances 的默认形态:全屏 curses 界面,从上到下依次为系统信息行、概览(CPU/MEM/LOAD/SWAP 条形)、CPU/MEM/SWAP/LOAD 详情、网络/磁盘/文件系统/传感器、进程列表。异常项按 careful/warning/critical 显示黄/橙/红背景色。退出按键 q 或 Esc。
TUI 高频快捷键速查(来源:官方文档 Quick start 与 TUI 界面内 h 帮助页,查询日期 2026-10-23):
| 按键 | 功能 |
|---|---|
q / Esc | 退出 |
h | 帮助(键位总览) |
a | 循环切换刷新间隔(2s→3s→…→60s) |
1 | 每核 CPU / 总 CPU 切换 |
2 | 左侧栏开关 |
3 | 概览区开关 |
m | 内存/交换视图切换 |
n | 网络模块开关 |
d | 磁盘 IO 开关 |
f | 文件系统开关 |
s | 传感器开关 |
y | 硬盘温度(hddtemp)开关 |
l | 进程日志(alert)开关 |
w | 告警事件列表开关 |
p | 进程按名称排序 |
c | 进程按 CPU 排序 |
M | 进程按内存排序 |
i | 进程按 I/O 排序 |
k | kill 选中的进程(先回车选中) |
e | 进程树视图 |
z | 进程零值过滤 |
I | Irix 模式(单进程 CPU 口径)切换 |
0 | 单进程 CPU 按全机折算开关 |
g | 历史曲线(graphs) |
r | 重置历史 |
x | 磁盘 IO 汇总/明细切换 |
A | AMP 应用监控开关 |
F | 文件系统剩余/已用切换 |
T | 网络累计流量开关 |
U | 网络累计速率视图 |
E | 进程行展开/收起 |
B | 磁盘/网络单位 bit/byte 切换 |
D | Docker 容器统计开关 |
K | 连接(TCP)统计开关 |
Q | IRQ 统计开关 |
5 | Quick look + load 极简视图 |
ENTER | 选中进程(配合 k/e) |
💡 说明:
D键的容器视图需 Docker/Podman socket 可访问(见《glances 4.5.8 配置参数详解》5.12 节);键位以运行中按h看到的帮助为准,不同版本可能微调。
5.2 stdout 模式(面向脚本)
stdout 模式让 glances 以非交互方式周期输出指定统计,适合塞进脚本与定时任务。三种格式实测:
glances --stdout now,cpu.total,mem.percent,load.min1
now: {'iso': '2026-10-22T23:28:31+00:00', 'custom': '2026-10-22 23:28:31 UTC'}
cpu.total: 13.7
mem.percent: 58.2
load.min1: 0.685546875
glances --stdout-csv now,cpu.total,mem.percent
now.iso,now.custom,cpu.total,mem.percent
2026-10-22T23:28:36+00:00,2026-10-22 23:28:36 UTC,4.6,58.1
2026-10-22T23:28:38+00:00,2026-10-22 23:28:38 UTC,4.6,58.1
glances --stdout-json load
{"load": {"min1": 0.80126953125, "min5": 1.6845703125, "min15": 2.74853515625, "cpucore": 12}}
要点解读:取数路径写法为 插件名.字段(如 cpu.total、load.min1),只写插件名(如 load)则输出整个插件统计;--stdout-csv 每 2 秒(默认刷新率)追加一行。实测命令均按 Ctrl+C 停止。
5.3 --fetch 摘要模式
一次性输出机器摘要后退出(可截图贴报告):
glances --fetch
✨ glances-run | 10.89.65.3 | Uptime: 3 days, 7:41:02
⚙️ Ubuntu 24.04 64bit / Linux 6.8.0-138-generic
💡 LOAD 0.80/min1 | 1.68/min5 | 2.75/min15
⚡ CPU ■■■□□□□□□□□□□□□□□□ 15.6% of 12 cores
🧠 MEM ■■■■■■■■■■□□□□□□□□ 58.0% (18.2G / 31.3G)
💾 DISK ■■■■■■■■■■□□□□□□□□ 57.8% (434G / 786G) for /shared
📡 NET ↓ 0b/s ↑ 0b/s for eth0
🔥 TOP PROCESS by CPU
1️⃣ glances ⚡ 86.3% CPU 🧠 61.2MB MEM
2️⃣ glances ⚡ 0.0% CPU 🧠 96.4MB MEM
🔥 TOP PROCESS by MEM
1️⃣ glances 🧠 96.4MB MEM ⚡ 0.0% CPU
(输出节选,实测首尾;DISK 行对每个挂载点各一行,此处省略多余挂载点。)要点解读:--fetch 也支持 --fetch-template <文件> 自定义模板;该模式零交互、输出即退出,适合巡检脚本生成快报。
5.4 刷新率与定时退出
glances -t 5 --stop-after 3 -q --stdout-cpu total
-t 5:5 秒刷新一次(下限受配置 [global] refresh 约束);--stop-after 3:采集 3 个周期后自动退出(无人值守采样利器);-q:不开 curses 界面。
六、Web 服务器模式与 REST API(-w)
6.1 启动 Web 服务器
glances -w
INFO: Started server process [4026]
INFO: Waiting for application startup.
INFO: Application startup complete.
INFO: Uvicorn running on http://0.0.0.0:61208 (Press CTRL+C to quit)
要点解读:4.x 的 Web 层基于 FastAPI + Uvicorn,默认监听 0.0.0.0:61208;进程前台运行,生产环境用 systemd 常驻(见《Ubuntu 24.04 安装 glances 4.5.8 指南》9.2 节)。后台运行加 --disable-webui 只开 API。
6.2 WebUI 验证
curl -s -o /dev/null -w 'WebUI HTTP %{http_code}\n' http://127.0.0.1:61208/
curl -s http://127.0.0.1:61208/ | grep -m1 '<title>'
WebUI HTTP 200
<title>Glances</title>
浏览器访问 http://<服务器IP>:61208/ 即是 WebUI(深色主题仪表盘,结构与 TUI 一致且支持左侧导航)。
6.3 REST API 端点实测(/api/4)
API 根路径 http://localhost:61208/api/4,支持两级取数:/api/4/<插件> 取全量、/api/4/<插件>/<字段> 取单值、/api/4/<插件>/history 取历史序列。以下全部为本机 curl 实测回显:
curl -s http://127.0.0.1:61208/api/4/system
{"os_name": "Linux", "hostname": "glances-run", "platform": "64bit", "os_version": "6.8.0-138-generic", "linux_distro": "Ubuntu 24.04", "hr_name": "Ubuntu 24.04 64bit / Linux 6.8.0-138-generic"}
curl -s http://127.0.0.1:61208/api/4/version
"4.5.8"
curl -s http://127.0.0.1:61208/api/4/pluginslist
["percpu", "help", "now", "ports", "uptime", "quicklook", "containers", "ip", "programlist", "network", "psutilversion", "system", "version", "processcount", "processlist", "mem", "diskio", "sensors", "fs", "core", "gpu", "memswap", "alert", "load", "wifi", "cpu", "amps", "folders"]
curl -s http://127.0.0.1:61208/api/4/cpu
{"total": 6.9, "user": 3.3, "nice": 0.0, "system": 2.3, "idle": 93.0, "iowait": 0.0, "irq": 0.0, "steal": 0.0, "guest": 0.0, "ctx_switches": 304793, "interrupts": 216219, "soft_interrupts": 39983, "syscalls": 0, "cpucore": 12, "time_since_update": 6.172227382659912, "ctx_switches_gauge": 6303237993, "ctx_switches_rate_per_sec": 49381.0, ...}
(输出节选,实测首尾。)time_since_update 与 *_gauge/*_rate_per_sec 是 glances 对速率类指标的差分计算字段。
curl -s http://127.0.0.1:61208/api/4/mem
{"total": 33607299072, "available": 14183989248, "percent": 57.8, "used": 19423309824, "free": 7025434624, "active": 9380925440, "inactive": 13885501440, "buffers": 947920896, "cached": 7490396160, "shared": 719085568, "percent_min": 57.8, "percent_max": 57.9, "percent_mean": 57.85}
curl -s http://127.0.0.1:61208/api/4/load
{"min1": 0.88134765625, "min5": 1.779296875, "min15": 2.8076171875, "cpucore": 12}
curl -s http://127.0.0.1:61208/api/4/uptime
curl -s http://127.0.0.1:61208/api/4/now
"3 days, 7:40:34"
{"iso": "2026-10-22T23:28:15+00:00", "custom": "2026-10-22 23:28:15 UTC"}
单字段与历史取数:
curl -s http://127.0.0.1:61208/api/4/cpu/total
curl -s http://127.0.0.1:61208/api/4/mem/percent
curl -s http://127.0.0.1:61208/api/4/load/min1
{"total": 0.0}
{"percent": 57.9}
{"min1": 1.21435546875}
curl -s http://127.0.0.1:61208/api/4/cpu/history
{"user": [["2026-10-22T23:43:49.048154+00:00", 9.7], ["2026-10-22T23:43:58.449188+00:00", 0.0], ...], "system": ...}
(输出节选,实测首部。)历史长度受配置 [global] history_size(默认 1200 点)约束。
告警与端口扫描端点:
curl -s http://127.0.0.1:61208/api/4/alert
[{"begin": 1792711675, "state": "CRITICAL", "type": "MEMSWAP", "min": 99.67822967191634, "max": 99.6786111423705, "sum": 199.35684081428684, "count": 2, "avg": 99.67842040714342, "top": ["glances", "sleep"], "desc": "", "sort": "memory_percent", "global_msg": "High swap (paging) usage", "end": -1}]
curl -s http://127.0.0.1:61208/api/4/ports
[{"host": "10.89.65.1", "port": 0, "description": "DefaultGateway", "refresh": 30, "timeout": 3, "status": null, "rtt_warning": null, "indice": "port_0", "key": "indice"}, {"host": "127.0.0.1", "port": "61208", "description": "Glances WebUI", "status": 7.2e-05, "refresh": 30, "timeout": 3, "rtt_warning": null, "indice": "port_1", "key": "indice"}]
错误行为实测(不存在的插件返回 400 + 可用清单):
curl -s -w ' HTTP=%{http_code}\n' http://127.0.0.1:61208/api/4/notaplug
{"detail":"Unknown plugin notaplug (available plugins: ['percpu', 'help', 'now', 'ports', ...])"} HTTP=400
6.4 REST API 文档自举
glances --api-restful-doc | head -20
Restful/JSON API documentation
==============================
This documentation describes the Glances API version 4 (Restful/JSON) interface.
An OpenAPI specification file is available at:
``https://raw.githubusercontent.com/nicolargo/glances/refs/heads/develop/docs/api/openapi.json``
Run the Glances API server
--------------------------
The Glances Restful/API server could be ran using the following command line:
.. code-block:: bash
# glances -w --disable-webui
要点解读:该命令输出内置 API 文档全文(RST 格式);4.x 同时提供 OpenAPI 规范文件,Web 服务器运行时 Uvicorn 自身也暴露 OpenAPI 描述,可用代码生成客户端。
七、client/server 模式:远程监控(-s / -c)
7.1 启动服务端
glances -s
Glances XML-RPC server is running on 0.0.0.0:61209
WARNING: XML-RPC server is running without authentication and with CORS Allow-Origin: *.
Mitigations: set a password (-P/--password) and/or restrict
cors_origins in glances.conf [outputs] section.
WARNING: Glances XML-RPC server is running without Host header validation.
DNS rebinding attacks may allow untrusted pages to read the XML-RPC API.
Set xmlrpc_allowed_hosts in glances.conf [outputs] to restrict access:
xmlrpc_allowed_hosts=localhost,127.0.0.1,<your-hostname>
Announce the Glances server on the LAN (using 10.89.65.3 IP address)
要点解读:server 默认监听 0.0.0.0:61209 并在局域网 UDP 广播自己(供 --browser 自动发现);无密码时启动日志给出两条安全提示——认证与 Host 头校验,公网部署必须处理(密码用 --password,Host 白名单配置见《glances 4.5.8 配置参数详解》5.2 节)。
⚠️ 排障实录(--password 传参报错):4.x 的 --password 是开关型参数,不接值,密码在交互提示中输入。实测错误用法:
glances -s --password q1w2e3r4
glances: error: unrecognized arguments: q1w2e3r4
正确姿势:glances -s --password,按提示输入两遍密码(define the Glances server password: / Confirm new password:),密码哈希会存入 ~/.config/glances/ 下的 .pwd 文件,此后再次启动自动读取不再提示。客户端连接时同样输入一次密码,同样落本地文件。
7.2 客户端连接
在另一台装有 glances 的服务器上连接(实测从第二台服务器连接本节 7.1 的 server):
glances -c <server主机名或IP>
成功后进入与本地监控一致的 TUI,数据来自远端 server(标题行显示的是 server 端主机名与系统信息)。退出按 q。
脚本化取数实测(client + stdout 组合,免交互取远端数据):
glances -c glances-run --stdout-json cpu,mem -t 2 --stop-after 2
{"cpu": {"total": 10.4, "user": 6.1, "nice": 0.0, "system": 2.7, "idle": 89.5, "iowait": 0.1, "irq": 0.0, "steal": 0.0, "guest": 0.0, "ctx_switches": 0, "interrupts": 0, "soft_interrupts": 0, "syscalls": 0, "cpucore": 12, "time_since_update": 26.87586736679077, ...}, "mem": {"total": 33607299072, "available": 13728382976, "percent": 59.2, ...}}
(输出节选,实测。)要点解读:-c 与 --stdout-json 组合可把「远程采集」变成一行命令,--stop-after 2 定时退出,适合把远端机器数据拉到本地再走本地导出器。
7.3 中央浏览器
glances --browser # TUI 版多机列表(Tab 切换主机,回车进入)
glances --browser -w # WebUI 版多机列表(浏览器访问 61208)
浏览器模式扫描两类来源:局域网 UDP 自动发现(--disable-autodiscover 关闭)与配置 [serverlist] 静态清单(见《glances 4.5.8 配置参数详解》5.14 节)。
7.4 SNMP 采集模式
对无法安装 glances 的设备(交换机/打印机/嵌入式),客户端可用 SNMP 取数:
glances -c <设备IP> --snmp-community public --snmp-version 2c --snmp-force
参数族:--snmp-community(默认 public)、--snmp-port(默认 161)、--snmp-version(1/2c/3)、--snmp-user/--snmp-auth(SNMPv3)、--snmp-force(强制 SNMP 而非先试 XML-RPC)。SNMP 模式仅能取到设备侧有限的系统组指标(CPU/内存/网络等 OID 覆盖面因设备而异)。
八、导出器命令
8.1 CSV 导出(实测全链路)
glances -q --export csv --export-csv-file /var/tmp/glances.csv --stop-after 5
head -3 /var/tmp/glances.csv | cut -c1-120
wc -l /var/tmp/glances.csv
timestamp,percpu.0.key,percpu.0.cpu_number,percpu.0.total,percpu.0.user,percpu.0.system,percpu.0.idle,percpu.0.nice,percpu.0.iowait,percpu.0.irq,percpu.0.softirq,...
2026-10-22 23:28:58,cpu_number,0,7.2,1.0,1.0,92.8,0.0,0.0,0.0,5.3,0.0,...
2026-10-22 23:29:00,cpu_number,1,4.0,1.0,1.5,96.0,0.0,0.0,0.0,1.5,0.0,...
5 /var/tmp/glances.csv
要点解读:--stop-after 5 采 5 个周期;首列 timestamp 是本地时间,之后每个导出对象一列(<插件>.<实例>.<字段>,percpu 每核一组);默认追加写文件,--export-csv-overwrite 才覆盖。CSV 导出没有配置段(无需 conf),文件路径与覆盖行为都在命令行。
8.2 JSON 导出(实测)
glances -q --export json --export-json-file /var/tmp/glances.json --stop-after 3
head -c 400 /var/tmp/glances.json
{"percpu": {"0.key": "cpu_number", "0.cpu_number": 0, "0.total": 13.2, "0.user": 3.8, "0.system": 2.4, "0.idle": 86.8, "0.nice": 0.0, "0.iowait": 0.0, "0.irq": 0.0, "0.softirq": 7.1, "0.steal": 0.0, ...}
要点解读:JSON 导出把每个周期统计追加为文件中的独立 JSON 对象,字段含插件的完整统计与阈值元数据(*_careful/*_warning/*_critical);按行处理时用 jq 等工具逐对象解析。
8.3 导出器全景与配置对接
--export 的全部合法取值即 glances --module-list 的 Exporters 清单(24 个,见 4.2 节实测)。文件类(csv/json/graph)走命令行参数,其余 21 个走配置文件对应段([influxdb2]、[prometheus]、[elasticsearch]、[kafka] 等,段配置详解见《glances 4.5.8 配置参数详解》5.15 节)。以 InfluxDB 2 为例:
glances -t 5 --export influxdb2
要点解读:推模式导出器随 glances 进程常驻外发(-t 5 控制导出节奏);[prometheus] 是拉模式例外——glances 起一个 metrics HTTP 端点等 Prometheus 来抓。
九、注意事项
- 认证与暴露面:
-w与-s默认无认证且绑定全部网卡,除内网外必须处理——Web 模式用[outputs]的webui_allowed_hosts/JWT/TLS,server 模式用--password+xmlrpc_allowed_hosts(两处 WARNING 提示在 6.1/7.1 节实测回显中均可见)。 - API 版本:脚本对接固定用
/api/4/前缀;glances 升级大版本时 API 路径会变(v3 → v4 有不兼容调整),升级前先在测试机验证。 - 刷新率与开销:
-t下限受[global] refresh约束;低配机器把 refresh 调到 5 以上、并禁用不用的插件(--disable-plugin)可显著降低 CPU 占用。 - 自动发现隐私:
-s模式默认局域网广播(UDP),多租户内网建议--disable-autodiscover。 - stdout 与导出的互补:一次性取数用 stdout 模式(无需清理文件);持续归档用导出器(CSV 追加写、时序库推模式),两者可同时用。
十、常见问题(FAQ)
Q1:glances -w 报缺少依赖?
Web 模式需要 FastAPI/Uvicorn/Jinja2(glances[web] extras)。pipx 场景重新执行 pipx install 'glances[all]'(先 uninstall 或用 pipx reinstall);venv 场景在 venv 内 pip install 'glances[web]'。详见《Ubuntu 24.04 安装 glances 4.5.8 指南》FAQ Q4。
Q2:glances -s --password <密码> 报 unrecognized arguments?
4.x 的 --password 是开关参数不接值,密码走交互输入(见 7.1 节排障实录)。首次设置后密码哈希落 ~/.config/glances/*.pwd,之后启动自动读取。
Q3:client 连接 server 提示认证失败或一直重试密码?
两端密码必须一致;client 输错的密码也会存本地 .pwd,后续重连会自动用错密码。删掉 client 侧 ~/.config/glances/ 下的 .pwd 文件再重连即可重新输入。
Q4:glances -c <IP> 连上了但界面空白/卡顿?
优先排查:① server 端 61209 端口防火墙(ss -ltn | grep 61209 应有监听);② 两端 glances 版本差异过大(建议同为 4.x);③ --cached-time 默认 1 秒的缓存导致数据「不动」,属正常现象。
Q5:TUI 里中文/特殊字符乱码?
终端需 UTF-8 locale;仍异常可加 --disable-unicode(ASCII 字符渲染)或 --disable-bg(关闭背景色)。
Q6:如何让一次监控跑 N 秒自动结束?
glances --stop-after <次数> -t <秒> -q(次数×秒=总时长);配合 --stdout-json 或导出器即为无人值守采样(5.4 与 8.1 节实测)。
十一、参考链接
- 官方 README(模式与安装):https://github.com/nicolargo/glances (查询日期 2026-10-23)
- 官方文档 Quick start:https://glances.readthedocs.io/en/latest/quickstart.html
- RESTful API 文档(v4):https://glances.readthedocs.io/en/latest/api.html
- v4.5.8 官方配置模板:https://github.com/nicolargo/glances/blob/v4.5.8/conf/glances.conf
- 本站同系列实测文档:《glances 介绍与选型指南》、《Ubuntu 24.04 安装 glances 4.5.8 指南》、《glances 4.5.8 配置参数详解》