| GLANCES(1) | Glances | GLANCES(1) |
نام (NAME)
glances - ابزار پایش و نظارت بر سیستم مبتنی بر curses
خلاصه دستور (SYNOPSIS)
glances [گزینهها]
توضیحات (DESCRIPTION)
برنامه glances یک ابزار پایش و نظارت چندسکویی مبتنی بر curses است که هدف آن ارائه بیشترین حجم اطلاعات در کمترین فضای ممکن است؛ به گونهای که به طور ایدهآل در یک ترمینال استاندارد 80x24 یا بزرگتر برای نمایش جزئیات بیشتر جا میگیرد. این ابزار میتواند با توجه به اندازه ترمینال، خود را به صورت پویا با اطلاعات نمایشی تطبیق دهد. همچنین میتواند در حالت کارخواه/کارساز (client/server) کار کند. پایش از راه دور میتواند از طریق ترمینال یا رابط وب انجام شود.
برنامه glances به زبان پایتون نوشته شده است و از کتابخانه psutil برای دریافت اطلاعات از سیستم شما استفاده میکند.
گزینهها (OPTIONS)
گزینههای خط فرمان (COMMAND-LINE OPTIONS)
- -h, --help
- نمایش این پیام راهنما و خروج
- -V, --version
- نمایش نسخه برنامه و خروج
- -d, --debug
- فعالسازی حالت اشکالزدایی (دیباگ)
- --print-completion
- تولید اسکریپتهای تکمیل خودکار کلید تب (tab completion) برای خط فرمان Glances
- -C CONF_FILE, --config CONF_FILE
- مسیر فایل پیکربندی
- -P PLUGIN_DIRECTORY, --plugins PLUGIN_DIRECTORY
- مسیر پوشه حاوی پلاگینهای اضافی
- --modules-list
- نمایش فهرست ماژولها (پلاگینها و صادرکنندهها) و خروج
- --disable-plugin PLUGIN
- غیرفعالسازی PLUGIN (فهرست جداشده با کاما)
- --enable-plugin PLUGIN
- فعالسازی PLUGIN (فهرست جداشده با کاما)
- --stdout PLUGINS_STATS
- نمایش آمارها در خروجی استاندارد (فهرست جداشده با کاما از پلاگینها/صفتهای پلاگین)
- --export EXPORT
- فعالسازی ماژول صادرکننده EXPORT (فهرست جداشده با کاما)
- --export-csv-file EXPORT_CSV_FILE
- مسیر فایل برای صادرکننده CSV
- --export-json-file EXPORT_JSON_FILE
- مسیر فایل برای صادرکننده JSON
- --disable-process
- غیرفعالسازی ماژول فرآیندها (کاهش مصرف پردازنده توسط Glances)
- --disable-webui
- غیرفعالسازی رابط کاربری وب (تنها API مبتنی بر RESTful پاسخگو خواهد بود)
- --light, --enable-light
- حالت سبک برای رابط Curses (غیرفعالسازی تمامی بخشها به جز منوی بالا)
- -0, --disable-irix
- تقسیم مصرف پردازنده هر وظیفه بر تعداد کل پردازندهها
- -1, --percpu
- راهاندازی Glances در حالت تفکیک به ازای هر پردازنده
- -2, --disable-left-sidebar
- غیرفعالسازی ماژولهای شبکه، ورودی/خروجی دیسک، سیستم فایل و حسگرها
- -3, --disable-quicklook
- غیرفعالسازی ماژول نگاه سریع (quick look)
- -4, --full-quicklook
- غیرفعالسازی تمامی بخشها به جز نگاه سریع و بار سیستم (load)
- -5, --disable-top
- غیرفعالسازی منوی بالا (شامل QuickLook، CPU، MEM، SWAP و LOAD)
- -6, --meangpu
- راهاندازی Glances در حالت میانگین پردازنده گرافیکی (GPU)
- --disable-bold
- غیرفعالسازی حالت قلم توپر (bold) در ترمینال
- --disable-bg
- غیرفعالسازی رنگهای پسزمینه در ترمینال
- --enable-process-extended
- فعالسازی آمارهای گسترده برای فرآیندهای برتر
- -c CLIENT, --client CLIENT
- اتصال به یک سرور Glances از طریق نشانی IPv4/IPv6، نام میزبان یا hostname:port
- -s, --server
- اجرای Glances در حالت کارساز (server mode)
- --browser
- راهاندازی مرورگر مرکزی Glances در حالت رابط کاربری متنی (TUI)؛ برای راهاندازی مرورگر مرکزی در رابط کاربری وب (WebUI) از --browser -w استفاده کنید
- --disable-autodiscover
- غیرفعالسازی قابلیت کشف خودکار (autodiscover)
- -p PORT, --port PORT
- تعیین درگاه TCP کارخواه/کارساز [پیشفرض: 61209]
- -B BIND_ADDRESS, --bind BIND_ADDRESS
- متصل کردن کارساز (bind) به نشانی IPv4/IPv6 یا نام میزبان دادهشده
- --username
- تعیین نام کاربری برای کارخواه/کارساز
- --password
- تعیین گذرواژه برای کارخواه/کارساز
- --snmp-community SNMP_COMMUNITY
- جامعه (community) در پروتکل SNMP
- --snmp-port SNMP_PORT
- درگاه پروتکل SNMP
- --snmp-version SNMP_VERSION
- نسخه پروتکل SNMP (شامل 1، 2c یا 3)
- --snmp-user SNMP_USER
- نام کاربری SNMP (تنها برای SNMPv3)
- --snmp-auth SNMP_AUTH
- کلید احراز هویت SNMP (تنها برای SNMPv3)
- --snmp-force
- اجبار به استفاده از حالت SNMP
- -t TIME, --time TIME
- تنظیم زمان بازآوری بر حسب ثانیه [پیشفرض: ۳ ثانیه]
- -w, --webserver
- اجرای Glances در حالت کارساز وب (نیازمند کتابخانه FastAPI است)
- --enable-mcp
- فعالسازی کارساز پروتکل زمینه مدل (MCP) در کنار کارساز وب (نیازمند بسته mcp است؛ به مستندات کارساز MCP مراجعه کنید)
- --mcp-path MCP_PATH
- تنظیم مسیر اتصال کارساز MCP [پیشفرض: /mcp]
- --cached-time CACHED_TIME
- تنظیم مدت نگهداری در حافظه موقت (کش) کارساز [پیشفرض: ۱ ثانیه]
- --open-web-browser
- تلاش برای باز کردن رابط وب در مرورگر وب پیشفرض
- -q, --quiet
- عدم نمایش رابط curses
- -f PROCESS_FILTER, --process-filter PROCESS_FILTER
- تنظیم الگوی فیلتر فرآیندها (عبارت منظم / regular expression)
- --process-short-name
- اجبار به استفاده از نام کوتاه برای فرآیندها
- --hide-kernel-threads
- پنهان کردن رشتههای هسته (kernel threads) در فهرست فرآیندها (در ویندوز در دسترس نیست)
- -b, --byte
- نمایش نرخ شبکه بر حسب بایت در ثانیه
- --diskio-show-ramfs
- نمایش سیستم فایل رم (RAM FS) در پلاگین DiskIO
- --diskio-iops
- نمایش عملیات ورودی/خروجی بر ثانیه (IOPS) در پلاگین DiskIO
- --fahrenheit
- نمایش دما بر حسب فارنهایت (پیشفرض سلسیوس است)
- --fs-free-space
- نمایش فضای آزاد سیستم فایل به جای فضای مصرفشده
- --theme-white
- بهینهسازی رنگهای نمایشی برای پسزمینه سفید
- --disable-check-update
- غیرفعالسازی بررسی آنلاین نسخه جدید Glances
کلیدهای میانبر (INTERACTIVE COMMANDS)
دستورات زیر (فشردن کلیدها) هنگام کار با Glances پشتیبانی میشوند:
- ENTER
- تنظیم
فیلتر
فرآیندها
نکته:
فیلتر یک الگوی عبارت منظم (regular expression) است:
- gnome: با تمام فرآیندهایی که با رشته gnome شروع میشوند مطابقت دارد
- .*gnome.*: با تمام فرآیندهایی که شامل رشته gnome هستند مطابقت دارد
- a
- مرتبسازی خودکار فهرست فرآیندها
- اگر مصرف پردازنده >70% باشد، مرتبسازی فرآیندها بر اساس مصرف CPU
- اگر مصرف حافظه >70% باشد، مرتبسازی فرآیندها بر اساس مصرف MEM
- اگر زمان انتظار ورودی/خروجی پردازنده (CPU iowait) >60% باشد، مرتبسازی فرآیندها بر اساس خواندن و نوشتن I/O
- A
- فعال/غیرفعالسازی فرآیند پایش برنامهها (AMP)
- b
- تغییر واحد ورودی/خروجی شبکه بین bit/s و Byte/s
- B
- مشاهده شمارندههای ورودی/خروجی دیسک در هر ثانیه
- c
- مرتبسازی فرآیندها بر اساس مصرف پردازنده (CPU)
- C
- فعال/غیرفعالسازی آمارهای ابری (Cloud)
- d
- نمایش/پنهانسازی آمارهای ورودی/خروجی دیسک
- D
- فعال/غیرفعالسازی آمارهای داکر (Docker)
- e
- فعال/غیرفعالسازی آمارهای تکمیلی فرآیندهای برتر
- E
- پاک کردن فیلتر جاری فرآیندها
- f
- نمایش/پنهانسازی آمارهای سیستم فایل و نظارت بر پوشهها
- F
- جابجایی نمایش سیستم فایل بین فضای استفادهشده و فضای خالی
- g
- تولید نمودارها برای تاریخچه جاری
- G
- فعال/غیرفعالسازی آمارهای پردازنده گرافیکی (GPU)
- h
- نمایش/پنهانسازی صفحه راهنما
- i
- مرتبسازی فرآیندها بر اساس نرخ ورودی/خروجی (I/O)
- I
- نمایش/پنهانسازی ماژول نشانی IP
- +
- افزایش سطح nice فرآیند انتخابشده / کاهش اولویت (نیازمند مجوز است) - فقط در حالت مستقل.
- -
- کاهش سطح nice فرآیند انتخابشده / افزایش اولویت (نیازمند مجوز است) - فقط در حالت مستقل.
- k
- کشتن فرآیند انتخابشده (نیازمند مجوز است) - فقط در حالت مستقل.
- K
- نمایش/پنهانسازی اتصالات TCP
- l
- نمایش/پنهانسازی پیامهای گزارش (لاگ)
- m
- مرتبسازی فرآیندها بر اساس مصرف حافظه (MEM)
- M
- بازنشانی مقادیر کمینه/بیشینه در خلاصه فرآیندها
- n
- نمایش/پنهانسازی آمارهای شبکه
- N
- نمایش/پنهانسازی زمان جاری
- p
- مرتبسازی فرآیندها بر اساس نام
- P
- فعال/غیرفعالسازی آمارهای درگاهها (Ports)
- q|ESC|CTRL-C
- خروج از نشست جاری Glances
- Q
- نمایش/پنهانسازی ماژول وقفهها (IRQ)
- r
- بازنشانی تاریخچه
- R
- نمایش/پنهانسازی پلاگین آرایههای RAID
- s
- نمایش/پنهانسازی پلاگین حسگرها (Sensors)
- S
- فعال/غیرفعالسازی خطوط جرقه (نمودارهای متنی کوتاه / spark lines)
- t
- مرتبسازی فرآیندها بر اساس زمان پردازنده (TIME+)
- T
- مشاهده ورودی/خروجی شبکه به صورت ترکیبی
- u
- مرتبسازی فرآیندها بر اساس کاربر (USER)
- U
- مشاهده ورودی/خروجی تجمعی شبکه
- V
- نمایش/پنهانسازی پلاگین حافظه مجازی (VMS)
- w
- حذف پیامهای گزارش هشدار پایانیافته
- W
- نمایش/پنهانسازی ماژول وایفای (Wifi)
- x
- حذف پیامهای گزارش هشدار و بحرانی پایانیافته
- z
- نمایش/پنهانسازی آمارهای فرآیندها
- 0
- فعال/غیرفعالسازی
حالت Irix/Solaris
مصرف پردازنده هر فرآیند بر کل تعداد پردازندهها تقسیم خواهد شد
- 1
- جابجایی بین آمارهای کلی پردازنده و آمارهای تفکیکی به ازای هر پردازنده
- 2
- فعال/غیرفعالسازی نوار کناری سمت چپ
- 3
- فعال/غیرفعالسازی ماژول نگاه سریع (quick look)
- 4
- فعال/غیرفعالسازی تمام ماژولها به جز نگاه سریع و بار سیستم (load)
- 5
- فعال/غیرفعالسازی منوی بالا (شامل QuickLook، CPU، MEM، SWAP و LOAD)
- 6
- فعال/غیرفعالسازی حالت میانگین GPU
- 9
- تغییر تم رابط کاربری بین سیاه و سفید
- /
- جابجایی بین نمایش خط فرمان کامل یا نام دستور فرآیند
- F5 یا CTRL-R
- بازآوری رابط کاربری
- SHIFT-LEFT
- پیمایش به چپ در میان معیارهای مرتبسازی فرآیندها
- SHIFT-RIGHT
- پیمایش به راست در میان معیارهای مرتبسازی فرآیندها
- LEFT
- پیمایش به چپ در نام فرآیند
- RIGHT
- پیمایش به راست در نام فرآیند
- UP
- حرکت به بالا در فهرست فرآیندها
- DOWN
- حرکت به پایین در فهرست فرآیندها
در مرورگر کارخواه Glances (قابل دسترسی از طریق آرگومان خط فرمان --browser):
پیکربندی (CONFIGURATION)
برای استفاده از Glances هیچ فایل پیکربندی الزامی نیست.
با این وجود، برای دسترسی به تنظیمات بیشتر به یک فایل پیکربندی نیاز است.
فایلها (FILES)
نکته:
شما میتوانید فایل glances.conf خود را در مکانهای زیر قرار دهید:
| Linux, SunOS | ~/.config/glances/, /etc/glances/, /usr/share/doc/glances/ |
| *BSD | ~/.config/glances/, /usr/local/etc/glances/, /usr/share/doc/glances/ |
| macOS | ~/.config/glances/, ~/Library/Application Support/glances/, /usr/local/etc/glances/, /usr/share/doc/glances/ |
| Windows | %APPDATA%\glances\glances.conf |
| All | <venv_root_folder>/share/doc/glances/ |
- در ویندوز XP، متغیر %APPDATA% برابر است با: C:\Documents and Settings\<USERNAME>\Application Data.
- در ویندوز ویستا و جدیدتر: C:\Users\<USERNAME>\AppData\Roaming.
گزینههای اختصاصی کاربر بر گزینههای سراسری سیستم تقدم دارند، و گزینههای دادهشده در خط فرمان بر هر دو اولویت دارند.
نحو و ساختار (SYNTAX)
برنامه Glances فایلهای پیکربندی را با نحو ini میخواند.
بخش اول (با نام global) در دسترس است:
[global] # Refresh rate (default is a minimum of 2 seconds) # Can be overwritten by the -t <sec> option # It is also possible to overwrite it in each plugin section refresh=2 # Should Glances check if a newer version is available on PyPI ? check_update=true # History size (maximum number of values) # Default is 1200 values (~1h with the default refresh rate) history_size=1200 # Set the way Glances should display the date (default is %Y-%m-%d %H:%M:%S %Z) #strftime_format="%Y-%m-%d %H:%M:%S %Z" # Define external directory for loading additional plugins # The layout follows the glances standard for plugin definitions #plugin_dir=/home/user/dev/plugins
سپس بخش دوم که مربوط به رابط کاربری است:
[outputs] # Options for all UIs #-------------------- # Separator in the Curses and WebUI interface (between top and others plugins) separator=True # Set the the Curses and WebUI interface left menu plugin list (comma-separated) #left_menu=network,wifi,connections,ports,diskio,fs,irq,folders,raid,smart,sensors,now # Limit the number of processes to display (in the WebUI) max_processes_display=25 # Options for WebUI #------------------ # Set URL prefix for the WebUI and the API # Example: url_prefix=/glances/ => http://localhost/glances # Note: The final / is mandatory # Default is no prefix (/) #url_prefix=/glances/ # Set root path for WebUI statics files # Why ? On Debian system, WebUI statics files are not provided. # You can download it in a specific folder # thanks to https://github.com/nicolargo/glances/issues/2021 # then configure this folder with the webui_root_path key # Default is folder where glances_restful_api.py is hosted #webui_root_path= # CORS options # Comma separated list of origins that should be permitted to make cross-origin requests. # Default is * #cors_origins=* # Indicate that cookies should be supported for cross-origin requests. # Default is True #cors_credentials=True # Comma separated list of HTTP methods that should be allowed for cross-origin requests. # Default is * #cors_methods=* # Comma separated list of HTTP request headers that should be supported for cross-origin requests. # Default is * #cors_headers=* # Define SSL files (keyfile_password is optional) #ssl_keyfile=./glances.local+3-key.pem #ssl_keyfile_password=kfp #ssl_certfile=./glances.local+3.pem
هر پلاگین، ماژول صدور اطلاعات، و فرآیند پایش برنامه (AMP) میتواند یک بخش داشته باشد. در زیر مثالی برای پلاگین CPU آورده شده است:
[cpu] disable=False refresh=3 user_careful=50 user_warning=70 user_critical=90 iowait_careful=50 iowait_warning=70 iowait_critical=90 system_careful=50 system_warning=70 system_critical=90 steal_careful=50 steal_warning=70 steal_critical=90
یک ماژول صدور اطلاعات به InfluxDB:
[influxdb] # Configuration for the --export influxdb option # https://influxdb.com host=localhost port=8086 user=root password=root db=glances prefix=localhost #tags=foo:bar,spam:eggs
یا یک AMP برای Nginx:
[amp_nginx] # Nginx status page should be enabled (https://easyengine.io/tutorials/nginx/status-page) enable=true regex=\/usr\/sbin\/nginx refresh=60 one_line=false status_url=http://localhost/nginx_status
در Glances نسخه ۳.۰ یا بالاتر، میتوانید با استفاده از دستورات سیستمی مقادیر پیکربندی پویا تعریف کنید. برای مثال، اگر میخواهید پیشوند صدور InfluxDB را برابر با نام میزبان فعلی قرار دهید، استفاده کنید از:
[influxdb] ... prefix=`hostname`
یا اگر میخواهید نام سیستمعامل را به عنوان یک برچسب (tag) اضافه کنید:
[influxdb] ... tags=system:`uname -a`
ثبت گزارشها (LOGGING)
برنامه Glances تمامی پیامهای داخلی خود را در یک فایل گزارش (log) ثبت میکند.
پیامهای DEBUG را میتوان با استفاده از گزینه -d در خط فرمان ثبت کرد.
محل فایل گزارش Glances به سیستمعامل شما بستگی دارد. شما میتوانید مسیر کامل فایل گزارش Glances را با استفاده از دستور glances -V در خط فرمان مشاهده کنید.
این فایل زمانی که اندازه آن از ۱ مگابایت فراتر رود، به طور خودکار چرخش (rotate) پیدا میکند.
اگر میخواهید از مسیر سیستمی دیگری استفاده کنید یا ساختار پیام گزارش را تغییر دهید، میتوانید از پیکربندی ثبت گزارش اختصاصی خود استفاده کنید. پیش از هر چیز، باید یک فایل glances.json مثلاً با محتوای زیر (فرمت JSON) بسازید:
{
"version": 1,
"disable_existing_loggers": "False",
"root": {
"level": "INFO",
"handlers": ["file", "console"]
},
"formatters": {
"standard": {
"format": "%(asctime)s -- %(levelname)s -- %(message)s"
},
"short": {
"format": "%(levelname)s: %(message)s"
},
"free": {
"format": "%(message)s"
}
},
"handlers": {
"file": {
"level": "DEBUG",
"class": "logging.handlers.RotatingFileHandler",
"formatter": "standard",
"filename": "/var/tmp/glances.log"
},
"console": {
"level": "CRITICAL",
"class": "logging.StreamHandler",
"formatter": "free"
}
},
"loggers": {
"debug": {
"handlers": ["file", "console"],
"level": "DEBUG"
},
"verbose": {
"handlers": ["file", "console"],
"level": "INFO"
},
"standard": {
"handlers": ["file"],
"level": "INFO"
},
"requests": {
"handlers": ["file", "console"],
"level": "ERROR"
},
"elasticsearch": {
"handlers": ["file", "console"],
"level": "ERROR"
},
"elasticsearch.trace": {
"handlers": ["file", "console"],
"level": "ERROR"
}
}
}
و برنامه Glances را با استفاده از خط فرمان زیر راهاندازی کنید:
LOG_CFG=<path>/glances.json glances
نکته:
مثالها (EXAMPLES)
پایش سیستم محلی (که حالت مستقل یا standalone نیز نامیده میشود) با رابط کاربری متنی (TUI):
برای پایش سیستم محلی با رابط کاربری وب (WebUI)، دستور زیر را اجرا کنید:
سپس یک مرورگر وب را باز کرده و به نشانی اینترنتی (URL) ارائهشده بروید.
پایش سیستم محلی و صدور آمارها به یک فایل CSV:
پایش سیستم محلی و صدور آمارها به یک کارساز InfluxDB با زمان بازآوری ۵ ثانیه (همچنین امکان صدور به OpenTSDB، Cassandra، Statsd، ElasticSearch، RabbitMQ و Riemann وجود دارد):
همچنین امکان صدور آمارها به چندین مقصد به طور همزمان وجود دارد:
راهاندازی یک کارساز Glances (حالت کارساز یا server mode):
اتصال Glances به یک کارساز Glances (حالت کارخواه یا client mode):
اتصال به یک کارساز Glances و صدور آمارها به یک سرور StatsD:
راهاندازی مرورگر متنی مرکزی Glances (رابط TUI):
راهاندازی مرورگر مرکزی Glances تحت وب (رابط WebUI) (قابلیت جدید در Glances نسخه ۴.۳ یا بالاتر):
اگر نمیخواهید کارساز وب محلی Glances در فهرست مرورگر دیده شود، لطفاً از گزینه --disable-autodiscover استفاده کنید.
همچنین ببینید (SEE ALSO)
نویسندگان (AUTHORS)
Nicolas Hennion با نام مستعار Nicolargo <contact@nicolargo.com>
حق نشر (COPYRIGHT)
2026, Nicolas Hennion
| August 1, 2026 | 4.5.6 |