GLANCES(1) Glances GLANCES(1)

glances - ابزار پایش و نظارت بر سیستم مبتنی بر curses

glances [گزینه‌ها]

برنامه glances یک ابزار پایش و نظارت چندسکویی مبتنی بر curses است که هدف آن ارائه بیشترین حجم اطلاعات در کمترین فضای ممکن است؛ به گونه‌ای که به طور ایده‌آل در یک ترمینال استاندارد 80x24 یا بزرگ‌تر برای نمایش جزئیات بیشتر جا می‌گیرد. این ابزار می‌تواند با توجه به اندازه ترمینال، خود را به صورت پویا با اطلاعات نمایشی تطبیق دهد. همچنین می‌تواند در حالت کارخواه/کارساز (client/server) کار کند. پایش از راه دور می‌تواند از طریق ترمینال یا رابط وب انجام شود.

برنامه glances به زبان پایتون نوشته شده است و از کتابخانه psutil برای دریافت اطلاعات از سیستم شما استفاده می‌کند.

نمایش این پیام راهنما و خروج
نمایش نسخه برنامه و خروج
فعال‌سازی حالت اشکال‌زدایی (دیباگ)
تولید اسکریپت‌های تکمیل خودکار کلید تب (tab completion) برای خط فرمان Glances
مسیر فایل پیکربندی
مسیر پوشه حاوی پلاگین‌های اضافی
نمایش فهرست ماژول‌ها (پلاگین‌ها و صادرکننده‌ها) و خروج
غیرفعال‌سازی PLUGIN (فهرست جداشده با کاما)
فعال‌سازی PLUGIN (فهرست جداشده با کاما)
نمایش آمارها در خروجی استاندارد (فهرست جداشده با کاما از پلاگین‌ها/صفت‌های پلاگین)
فعال‌سازی ماژول صادرکننده EXPORT (فهرست جداشده با کاما)
مسیر فایل برای صادرکننده CSV
مسیر فایل برای صادرکننده JSON
غیرفعال‌سازی ماژول فرآیندها (کاهش مصرف پردازنده توسط Glances)
غیرفعال‌سازی رابط کاربری وب (تنها API مبتنی بر RESTful پاسخگو خواهد بود)
حالت سبک برای رابط 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)
غیرفعال‌سازی حالت قلم توپر (bold) در ترمینال
غیرفعال‌سازی رنگ‌های پس‌زمینه در ترمینال
فعال‌سازی آمارهای گسترده برای فرآیندهای برتر
اتصال به یک سرور Glances از طریق نشانی IPv4/IPv6، نام میزبان یا hostname:port
اجرای Glances در حالت کارساز (server mode)
راه‌اندازی مرورگر مرکزی Glances در حالت رابط کاربری متنی (TUI)؛ برای راه‌اندازی مرورگر مرکزی در رابط کاربری وب (WebUI) از --browser -w استفاده کنید
غیرفعال‌سازی قابلیت کشف خودکار (autodiscover)
تعیین درگاه TCP کارخواه/کارساز [پیش‌فرض: 61209]
متصل کردن کارساز (bind) به نشانی IPv4/IPv6 یا نام میزبان داده‌شده
تعیین نام کاربری برای کارخواه/کارساز
تعیین گذرواژه برای کارخواه/کارساز
جامعه (community) در پروتکل SNMP
درگاه پروتکل SNMP
نسخه پروتکل SNMP (شامل 1، 2c یا 3)
نام کاربری SNMP (تنها برای SNMPv3)
کلید احراز هویت SNMP (تنها برای SNMPv3)
اجبار به استفاده از حالت SNMP
تنظیم زمان بازآوری بر حسب ثانیه [پیش‌فرض: ۳ ثانیه]
اجرای Glances در حالت کارساز وب (نیازمند کتابخانه FastAPI است)
فعال‌سازی کارساز پروتکل زمینه مدل (MCP) در کنار کارساز وب (نیازمند بسته mcp است؛ به مستندات کارساز MCP مراجعه کنید)
تنظیم مسیر اتصال کارساز MCP [پیش‌فرض: /mcp]
تنظیم مدت نگهداری در حافظه موقت (کش) کارساز [پیش‌فرض: ۱ ثانیه]
تلاش برای باز کردن رابط وب در مرورگر وب پیش‌فرض
عدم نمایش رابط curses
تنظیم الگوی فیلتر فرآیندها (عبارت منظم / regular expression)
اجبار به استفاده از نام کوتاه برای فرآیندها
پنهان کردن رشته‌های هسته (kernel threads) در فهرست فرآیندها (در ویندوز در دسترس نیست)
نمایش نرخ شبکه بر حسب بایت در ثانیه
نمایش سیستم فایل رم (RAM FS) در پلاگین DiskIO
نمایش عملیات ورودی/خروجی بر ثانیه (IOPS) در پلاگین DiskIO
نمایش دما بر حسب فارنهایت (پیش‌فرض سلسیوس است)
نمایش فضای آزاد سیستم فایل به جای فضای مصرف‌شده
بهینه‌سازی رنگ‌های نمایشی برای پس‌زمینه سفید
غیرفعال‌سازی بررسی آنلاین نسخه جدید Glances

دستورات زیر (فشردن کلیدها) هنگام کار با Glances پشتیبانی می‌شوند:

تنظیم فیلتر فرآیندها

نکته:

در macOS لطفاً از کلید CTRL-H برای حذف فیلتر استفاده کنید.

فیلتر یک الگوی عبارت منظم (regular expression) است:

  • gnome: با تمام فرآیندهایی که با رشته gnome شروع می‌شوند مطابقت دارد
  • .*gnome.*: با تمام فرآیندهایی که شامل رشته gnome هستند مطابقت دارد
مرتب‌سازی خودکار فهرست فرآیندها
  • اگر مصرف پردازنده >70% باشد، مرتب‌سازی فرآیندها بر اساس مصرف CPU
  • اگر مصرف حافظه >70% باشد، مرتب‌سازی فرآیندها بر اساس مصرف MEM
  • اگر زمان انتظار ورودی/خروجی پردازنده (CPU iowait) >60% باشد، مرتب‌سازی فرآیندها بر اساس خواندن و نوشتن I/O
فعال/غیرفعال‌سازی فرآیند پایش برنامه‌ها (AMP)
تغییر واحد ورودی/خروجی شبکه بین bit/s و Byte/s
مشاهده شمارنده‌های ورودی/خروجی دیسک در هر ثانیه
مرتب‌سازی فرآیندها بر اساس مصرف پردازنده (CPU)
فعال/غیرفعال‌سازی آمارهای ابری (Cloud)
نمایش/پنهان‌سازی آمارهای ورودی/خروجی دیسک
فعال/غیرفعال‌سازی آمارهای داکر (Docker)
فعال/غیرفعال‌سازی آمارهای تکمیلی فرآیندهای برتر
پاک کردن فیلتر جاری فرآیندها
نمایش/پنهان‌سازی آمارهای سیستم فایل و نظارت بر پوشه‌ها
جابجایی نمایش سیستم فایل بین فضای استفاده‌شده و فضای خالی
تولید نمودارها برای تاریخچه جاری
فعال/غیرفعال‌سازی آمارهای پردازنده گرافیکی (GPU)
نمایش/پنهان‌سازی صفحه راهنما
مرتب‌سازی فرآیندها بر اساس نرخ ورودی/خروجی (I/O)
نمایش/پنهان‌سازی ماژول نشانی IP
+
افزایش سطح nice فرآیند انتخاب‌شده / کاهش اولویت (نیازمند مجوز است) - فقط در حالت مستقل.
-
کاهش سطح nice فرآیند انتخاب‌شده / افزایش اولویت (نیازمند مجوز است) - فقط در حالت مستقل.
کشتن فرآیند انتخاب‌شده (نیازمند مجوز است) - فقط در حالت مستقل.
نمایش/پنهان‌سازی اتصالات TCP
نمایش/پنهان‌سازی پیام‌های گزارش (لاگ)
مرتب‌سازی فرآیندها بر اساس مصرف حافظه (MEM)
بازنشانی مقادیر کمینه/بیشینه در خلاصه فرآیندها
نمایش/پنهان‌سازی آمارهای شبکه
نمایش/پنهان‌سازی زمان جاری
مرتب‌سازی فرآیندها بر اساس نام
فعال/غیرفعال‌سازی آمارهای درگاه‌ها (Ports)
خروج از نشست جاری Glances
نمایش/پنهان‌سازی ماژول وقفه‌ها (IRQ)
بازنشانی تاریخچه
نمایش/پنهان‌سازی پلاگین آرایه‌های RAID
نمایش/پنهان‌سازی پلاگین حسگرها (Sensors)
فعال/غیرفعال‌سازی خطوط جرقه (نمودارهای متنی کوتاه / spark lines)
مرتب‌سازی فرآیندها بر اساس زمان پردازنده (TIME+)
مشاهده ورودی/خروجی شبکه به صورت ترکیبی
مرتب‌سازی فرآیندها بر اساس کاربر (USER)
مشاهده ورودی/خروجی تجمعی شبکه
نمایش/پنهان‌سازی پلاگین حافظه مجازی (VMS)
حذف پیام‌های گزارش هشدار پایان‌یافته
نمایش/پنهان‌سازی ماژول وای‌فای (Wifi)
حذف پیام‌های گزارش هشدار و بحرانی پایان‌یافته
نمایش/پنهان‌سازی آمارهای فرآیندها
0
فعال/غیرفعال‌سازی حالت Irix/Solaris

مصرف پردازنده هر فرآیند بر کل تعداد پردازنده‌ها تقسیم خواهد شد

1
جابجایی بین آمارهای کلی پردازنده و آمارهای تفکیکی به ازای هر پردازنده
2
فعال/غیرفعال‌سازی نوار کناری سمت چپ
3
فعال/غیرفعال‌سازی ماژول نگاه سریع (quick look)
4
فعال/غیرفعال‌سازی تمام ماژول‌ها به جز نگاه سریع و بار سیستم (load)
5
فعال/غیرفعال‌سازی منوی بالا (شامل QuickLook، CPU، MEM، SWAP و LOAD)
6
فعال/غیرفعال‌سازی حالت میانگین GPU
9
تغییر تم رابط کاربری بین سیاه و سفید
/
جابجایی بین نمایش خط فرمان کامل یا نام دستور فرآیند
بازآوری رابط کاربری
پیمایش به چپ در میان معیارهای مرتب‌سازی فرآیندها
پیمایش به راست در میان معیارهای مرتب‌سازی فرآیندها
پیمایش به چپ در نام فرآیند
پیمایش به راست در نام فرآیند
حرکت به بالا در فهرست فرآیندها
حرکت به پایین در فهرست فرآیندها

در مرورگر کارخواه Glances (قابل دسترسی از طریق آرگومان خط فرمان --browser):

اجرای کارساز انتخاب‌شده
حرکت به بالا در فهرست کارسازها
حرکت به پایین در فهرست کارسازها
خروج از Glances

برای استفاده از Glances هیچ فایل پیکربندی الزامی نیست.

با این وجود، برای دسترسی به تنظیمات بیشتر به یک فایل پیکربندی نیاز است.

نکته:

یک قالب پیش‌فرض در پوشه /usr{,/local}/share/doc/glances (در سیستم‌های شبه یونیکس) یا به طور مستقیم در گیت‌هاب در دسترس است: https://raw.githubusercontent.com/nicolargo/glances/master/conf/glances.conf.

شما می‌توانید فایل 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.

گزینه‌های اختصاصی کاربر بر گزینه‌های سراسری سیستم تقدم دارند، و گزینه‌های داده‌شده در خط فرمان بر هر دو اولویت دارند.

برنامه 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`

برنامه 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

نکته:

مقدار <path> را با پوشه‌ای که فایل glances.json شما در آن قرار دارد جایگزین کنید.

پایش سیستم محلی (که حالت مستقل یا standalone نیز نامیده می‌شود) با رابط کاربری متنی (TUI):

$ glances

برای پایش سیستم محلی با رابط کاربری وب (WebUI)، دستور زیر را اجرا کنید:

$ glances -w

سپس یک مرورگر وب را باز کرده و به نشانی اینترنتی (URL) ارائه‌شده بروید.

پایش سیستم محلی و صدور آمارها به یک فایل CSV:

$ glances --export csv --export-csv-file /tmp/glances.csv

پایش سیستم محلی و صدور آمارها به یک کارساز InfluxDB با زمان بازآوری ۵ ثانیه (همچنین امکان صدور به OpenTSDB، Cassandra، Statsd، ElasticSearch، RabbitMQ و Riemann وجود دارد):

$ glances -t 5 --export influxdb

همچنین امکان صدور آمارها به چندین مقصد به طور همزمان وجود دارد:

$ glances -t 5 --export influxdb,statsd,csv

راه‌اندازی یک کارساز Glances (حالت کارساز یا server mode):

$ glances -s

اتصال Glances به یک کارساز Glances (حالت کارخواه یا client mode):

$ glances -c <ip_server>

اتصال به یک کارساز Glances و صدور آمارها به یک سرور StatsD:

$ glances -c <ip_server> --export statsd

راه‌اندازی مرورگر متنی مرکزی Glances (رابط TUI):

$ glances --browser

راه‌اندازی مرورگر مرکزی Glances تحت وب (رابط WebUI) (قابلیت جدید در Glances نسخه ۴.۳ یا بالاتر):

$ glances --browser -w

اگر نمی‌خواهید کارساز وب محلی Glances در فهرست مرورگر دیده شود، لطفاً از گزینه --disable-autodiscover استفاده کنید.

htop(1), top(1)

Nicolas Hennion با نام مستعار Nicolargo <contact@nicolargo.com>

2026, Nicolas Hennion

August 1, 2026 4.5.6