Repository: nicolargo/glances Branch: develop Commit: 830cacd0ca6f Files: 434 Total size: 6.1 MB Directory structure: gitextract_f5ze888j/ ├── .cgcignore ├── .claude/ │ ├── settings.json │ └── skills/ │ ├── debug.md │ ├── docker.md │ ├── lint.md │ ├── new-export.md │ ├── new-plugin.md │ ├── review.md │ ├── test.md │ └── webui.md ├── .coveragerc ├── .dockerignore ├── .gitattributes ├── .github/ │ ├── FUNDING.yml │ ├── ISSUE_TEMPLATE/ │ │ ├── bug_report.md │ │ └── feature_request.md │ ├── ISSUE_TEMPLATE.md │ ├── PULL_REQUEST_TEMPLATE.md │ ├── dependabot.yml │ └── workflows/ │ ├── build.yml │ ├── build_docker.yml │ ├── ci.yml │ ├── cyber.yml │ ├── inactive_issues.yml │ ├── needs_contributor.yml │ ├── quality.yml │ ├── test.yml │ └── webui.yml ├── .gitignore ├── .mailmap ├── .pre-commit-config.yaml ├── .readthedocs.yaml ├── .reuse/ │ └── dep5 ├── AUTHORS ├── CLAUDE.md ├── CODE-OF-CONDUCT.md ├── CONTRIBUTING.md ├── COPYING ├── LICENSES/ │ └── LGPL-3.0-only.txt ├── MANIFEST.in ├── Makefile ├── NEWS.rst ├── README-pypi.rst ├── README.rst ├── SECURITY.md ├── all-requirements.txt ├── appveyor.yml ├── conf/ │ ├── empty.conf │ ├── fetch-templates/ │ │ ├── short.jinja │ │ └── with-logo.jinja │ ├── glances-grafana-flux.json │ ├── glances-grafana-influxql.json │ └── glances.conf ├── dev-requirements.txt ├── docker-bin.sh ├── docker-compose/ │ ├── docker-compose.yml │ └── glances.conf ├── docker-files/ │ ├── README.md │ ├── alpine.Dockerfile │ ├── docker-logger.json │ └── ubuntu.Dockerfile ├── docker-requirements.txt ├── docs/ │ ├── Makefile │ ├── README.txt │ ├── _static/ │ │ ├── glances-architecture.excalidraw │ │ └── glances-pyinstrument.html │ ├── _templates/ │ │ └── links.html │ ├── aoa/ │ │ ├── actions.rst │ │ ├── amps.rst │ │ ├── cloud.rst │ │ ├── connections.rst │ │ ├── containers.rst │ │ ├── cpu.rst │ │ ├── diskio.rst │ │ ├── events.rst │ │ ├── folders.rst │ │ ├── fs.rst │ │ ├── gpu.rst │ │ ├── hddtemp.rst │ │ ├── header.rst │ │ ├── index.rst │ │ ├── irq.rst │ │ ├── load.rst │ │ ├── memory.rst │ │ ├── network.rst │ │ ├── npu.rst │ │ ├── ports.rst │ │ ├── ps.rst │ │ ├── quicklook.rst │ │ ├── raid.rst │ │ ├── sensors.rst │ │ ├── smart.rst │ │ ├── vms.rst │ │ └── wifi.rst │ ├── api/ │ │ ├── mcp.rst │ │ ├── openapi.json │ │ ├── python.rst │ │ └── restful.rst │ ├── build.sh │ ├── cmds.rst │ ├── conf.py │ ├── config.rst │ ├── dev/ │ │ └── README.txt │ ├── docker.rst │ ├── faq.rst │ ├── fetch.rst │ ├── glances.rst │ ├── gw/ │ │ ├── cassandra.rst │ │ ├── couchdb.rst │ │ ├── csv.rst │ │ ├── duckdb.rst │ │ ├── elastic.rst │ │ ├── graph.rst │ │ ├── graphite.rst │ │ ├── index.rst │ │ ├── influxdb.rst │ │ ├── json.rst │ │ ├── kafka.rst │ │ ├── mongodb.rst │ │ ├── mqtt.rst │ │ ├── nats.rst │ │ ├── opentsdb.rst │ │ ├── prometheus.rst │ │ ├── rabbitmq.rst │ │ ├── restful.rst │ │ ├── riemann.rst │ │ ├── statsd.rst │ │ ├── timescaledb.rst │ │ └── zeromq.rst │ ├── index.rst │ ├── install.rst │ ├── make.bat │ ├── man/ │ │ └── glances.1 │ ├── objects.inv │ ├── quickstart.rst │ └── support.rst ├── generate_openapi.py ├── generate_webui_conf.py ├── glances/ │ ├── README.txt │ ├── __init__.py │ ├── __main__.py │ ├── actions.py │ ├── amps/ │ │ ├── __init__.py │ │ ├── amp.py │ │ ├── default/ │ │ │ └── __init__.py │ │ ├── nginx/ │ │ │ └── __init__.py │ │ ├── systemd/ │ │ │ └── __init__.py │ │ └── systemv/ │ │ └── __init__.py │ ├── amps_list.py │ ├── api.py │ ├── attribute.py │ ├── client.py │ ├── client_browser.py │ ├── config.py │ ├── cpu_percent.py │ ├── event.py │ ├── events_list.py │ ├── exports/ │ │ ├── README.rst │ │ ├── __init__.py │ │ ├── export.py │ │ ├── export_asyncio.py │ │ ├── glances_cassandra/ │ │ │ └── __init__.py │ │ ├── glances_couchdb/ │ │ │ └── __init__.py │ │ ├── glances_csv/ │ │ │ └── __init__.py │ │ ├── glances_duckdb/ │ │ │ └── __init__.py │ │ ├── glances_elasticsearch/ │ │ │ └── __init__.py │ │ ├── glances_graph/ │ │ │ └── __init__.py │ │ ├── glances_graphite/ │ │ │ └── __init__.py │ │ ├── glances_influxdb/ │ │ │ └── __init__.py │ │ ├── glances_influxdb2/ │ │ │ └── __init__.py │ │ ├── glances_influxdb3/ │ │ │ └── __init__.py │ │ ├── glances_json/ │ │ │ └── __init__.py │ │ ├── glances_kafka/ │ │ │ └── __init__.py │ │ ├── glances_mongodb/ │ │ │ └── __init__.py │ │ ├── glances_mqtt/ │ │ │ └── __init__.py │ │ ├── glances_nats/ │ │ │ └── __init__.py │ │ ├── glances_opentsdb/ │ │ │ └── __init__.py │ │ ├── glances_prometheus/ │ │ │ └── __init__.py │ │ ├── glances_rabbitmq/ │ │ │ └── __init__.py │ │ ├── glances_restful/ │ │ │ └── __init__.py │ │ ├── glances_riemann/ │ │ │ └── __init__.py │ │ ├── glances_statsd/ │ │ │ └── __init__.py │ │ ├── glances_timescaledb/ │ │ │ └── __init__.py │ │ └── glances_zeromq/ │ │ └── __init__.py │ ├── filter.py │ ├── folder_list.py │ ├── globals.py │ ├── history.py │ ├── jwt_utils.py │ ├── logger.py │ ├── main.py │ ├── outdated.py │ ├── outputs/ │ │ ├── __init__.py │ │ ├── glances_bars.py │ │ ├── glances_colors.py │ │ ├── glances_curses.py │ │ ├── glances_curses_browser.py │ │ ├── glances_json_serializer.py │ │ ├── glances_mcp.py │ │ ├── glances_restful_api.py │ │ ├── glances_sparklines.py │ │ ├── glances_stdout.py │ │ ├── glances_stdout_api_doc.py │ │ ├── glances_stdout_api_restful_doc.py │ │ ├── glances_stdout_csv.py │ │ ├── glances_stdout_fetch.py │ │ ├── glances_stdout_issue.py │ │ ├── glances_stdout_json.py │ │ ├── glances_unicode.py │ │ └── static/ │ │ ├── .prettierrc.js │ │ ├── README.md │ │ ├── css/ │ │ │ ├── custom.scss │ │ │ └── style.scss │ │ ├── eslint.config.mjs │ │ ├── js/ │ │ │ ├── App.vue │ │ │ ├── Browser.vue │ │ │ ├── app.js │ │ │ ├── browser.js │ │ │ ├── components/ │ │ │ │ ├── help.vue │ │ │ │ ├── plugin-alert.vue │ │ │ │ ├── plugin-amps.vue │ │ │ │ ├── plugin-cloud.vue │ │ │ │ ├── plugin-connections.vue │ │ │ │ ├── plugin-containers.vue │ │ │ │ ├── plugin-cpu.vue │ │ │ │ ├── plugin-diskio.vue │ │ │ │ ├── plugin-folders.vue │ │ │ │ ├── plugin-fs.vue │ │ │ │ ├── plugin-gpu.vue │ │ │ │ ├── plugin-hostname.vue │ │ │ │ ├── plugin-ip.vue │ │ │ │ ├── plugin-irq.vue │ │ │ │ ├── plugin-load.vue │ │ │ │ ├── plugin-mem.vue │ │ │ │ ├── plugin-memswap.vue │ │ │ │ ├── plugin-network.vue │ │ │ │ ├── plugin-now.vue │ │ │ │ ├── plugin-npu.vue │ │ │ │ ├── plugin-percpu.vue │ │ │ │ ├── plugin-ports.vue │ │ │ │ ├── plugin-process.vue │ │ │ │ ├── plugin-processcount.vue │ │ │ │ ├── plugin-processlist.vue │ │ │ │ ├── plugin-quicklook.vue │ │ │ │ ├── plugin-raid.vue │ │ │ │ ├── plugin-sensors.vue │ │ │ │ ├── plugin-smart.vue │ │ │ │ ├── plugin-system.vue │ │ │ │ ├── plugin-uptime.vue │ │ │ │ ├── plugin-vms.vue │ │ │ │ └── plugin-wifi.vue │ │ │ ├── filters.js │ │ │ ├── services.js │ │ │ ├── store.js │ │ │ └── uiconfig.json │ │ ├── package.json │ │ ├── public/ │ │ │ ├── browser.js │ │ │ └── glances.js │ │ ├── templates/ │ │ │ ├── browser.html │ │ │ └── index.html │ │ └── webpack.config.js │ ├── password.py │ ├── password_list.py │ ├── plugins/ │ │ ├── README.rst │ │ ├── __init__.py │ │ ├── alert/ │ │ │ └── __init__.py │ │ ├── amps/ │ │ │ └── __init__.py │ │ ├── cloud/ │ │ │ └── __init__.py │ │ ├── connections/ │ │ │ └── __init__.py │ │ ├── containers/ │ │ │ ├── __init__.py │ │ │ └── engines/ │ │ │ ├── __init__.py │ │ │ ├── docker.py │ │ │ ├── lxd.py │ │ │ └── podman.py │ │ ├── core/ │ │ │ └── __init__.py │ │ ├── cpu/ │ │ │ └── __init__.py │ │ ├── diskio/ │ │ │ └── __init__.py │ │ ├── folders/ │ │ │ └── __init__.py │ │ ├── fs/ │ │ │ ├── __init__.py │ │ │ └── zfs.py │ │ ├── gpu/ │ │ │ ├── __init__.py │ │ │ └── cards/ │ │ │ ├── __init__.py │ │ │ ├── amd.py │ │ │ ├── intel.py │ │ │ └── nvidia.py │ │ ├── help/ │ │ │ └── __init__.py │ │ ├── ip/ │ │ │ └── __init__.py │ │ ├── irq/ │ │ │ └── __init__.py │ │ ├── load/ │ │ │ └── __init__.py │ │ ├── mem/ │ │ │ └── __init__.py │ │ ├── memswap/ │ │ │ └── __init__.py │ │ ├── network/ │ │ │ └── __init__.py │ │ ├── now/ │ │ │ └── __init__.py │ │ ├── npu/ │ │ │ ├── __init__.py │ │ │ └── cards/ │ │ │ ├── __init__.py │ │ │ ├── amd.py │ │ │ ├── intel.py │ │ │ ├── npu.py │ │ │ └── rockchip.py │ │ ├── percpu/ │ │ │ └── __init__.py │ │ ├── plugin/ │ │ │ ├── __init__.py │ │ │ ├── dag.py │ │ │ └── model.py │ │ ├── ports/ │ │ │ └── __init__.py │ │ ├── processcount/ │ │ │ └── __init__.py │ │ ├── processlist/ │ │ │ └── __init__.py │ │ ├── programlist/ │ │ │ └── __init__.py │ │ ├── psutilversion/ │ │ │ └── __init__.py │ │ ├── quicklook/ │ │ │ └── __init__.py │ │ ├── raid/ │ │ │ └── __init__.py │ │ ├── sensors/ │ │ │ ├── __init__.py │ │ │ └── sensor/ │ │ │ ├── __init__.py │ │ │ ├── glances_batpercent.py │ │ │ └── glances_hddtemp.py │ │ ├── smart/ │ │ │ └── __init__.py │ │ ├── system/ │ │ │ └── __init__.py │ │ ├── uptime/ │ │ │ └── __init__.py │ │ ├── version/ │ │ │ └── __init__.py │ │ ├── vms/ │ │ │ ├── __init__.py │ │ │ └── engines/ │ │ │ ├── __init__.py │ │ │ ├── multipass.py │ │ │ └── virsh.py │ │ └── wifi/ │ │ └── __init__.py │ ├── ports_list.py │ ├── processes.py │ ├── programs.py │ ├── secure.py │ ├── server.py │ ├── servers_list.py │ ├── servers_list_dynamic.py │ ├── servers_list_static.py │ ├── snmp.py │ ├── standalone.py │ ├── stats.py │ ├── stats_client.py │ ├── stats_client_snmp.py │ ├── stats_server.py │ ├── stats_streamer.py │ ├── thresholds.py │ ├── timer.py │ ├── web_list.py │ └── webserver.py ├── glances.ipynb ├── pyproject.toml ├── renovate.json ├── requirements.txt ├── run-venv.py ├── run.py ├── snap/ │ ├── local/ │ │ └── launchers/ │ │ └── glances-launch │ └── snapcraft.yaml ├── sonar-project.properties ├── tests/ │ ├── HOW_TO_TEST_MCP.md │ ├── conftest.py │ ├── test_actions_sanitize.py │ ├── test_api.py │ ├── test_browser_restful.py │ ├── test_browser_tui.py │ ├── test_core.py │ ├── test_duckdb_sanitize.py │ ├── test_export_csv.sh │ ├── test_export_duckdb.sh │ ├── test_export_influxdb_v1.sh │ ├── test_export_influxdb_v3.sh │ ├── test_export_json.sh │ ├── test_export_nats.sh │ ├── test_export_prometheus.sh │ ├── test_export_timescaledb.sh │ ├── test_json_serializer.py │ ├── test_mcp.py │ ├── test_memoryleak.py │ ├── test_perf.py │ ├── test_plugin_cpu.py │ ├── test_plugin_diskio.py │ ├── test_plugin_fs.py │ ├── test_plugin_load.py │ ├── test_plugin_mem.py │ ├── test_plugin_memswap.py │ ├── test_plugin_network.py │ ├── test_plugin_processcount.py │ ├── test_plugin_sensors.py │ ├── test_restful.py │ ├── test_webui.py │ └── test_xmlrpc.py ├── tests-data/ │ ├── issues/ │ │ ├── CVE-2026-32633/ │ │ │ └── glances.conf │ │ ├── issue2849.py │ │ ├── issue2851.py │ │ ├── issue3027.py │ │ ├── issue3290.py │ │ ├── issue3319.py │ │ ├── issue3322-homepage/ │ │ │ ├── README.txt │ │ │ └── run-homepage.sh │ │ ├── issue3333-homeassistant/ │ │ │ ├── README.txt │ │ │ └── run-homeassistant.sh │ │ ├── issue3341-NATS/ │ │ │ ├── pub.py │ │ │ └── sub.py │ │ ├── issue3434/ │ │ │ └── docker-compose.yml │ │ └── issue869.py │ ├── plugins/ │ │ ├── fs/ │ │ │ └── zfs/ │ │ │ └── arcstats │ │ ├── gpu/ │ │ │ └── amd/ │ │ │ └── sys/ │ │ │ ├── class/ │ │ │ │ └── drm/ │ │ │ │ └── card0/ │ │ │ │ └── device/ │ │ │ │ ├── device │ │ │ │ ├── gpu_busy_percent │ │ │ │ ├── hwmon/ │ │ │ │ │ └── hwmon0/ │ │ │ │ │ ├── in1_input │ │ │ │ │ └── temp1_input │ │ │ │ ├── mem_info_gtt_total │ │ │ │ ├── mem_info_gtt_used │ │ │ │ ├── mem_info_vram_total │ │ │ │ ├── mem_info_vram_used │ │ │ │ ├── pp_dpm_mclk │ │ │ │ ├── pp_dpm_sclk │ │ │ │ └── revision │ │ │ └── kernel/ │ │ │ └── debug/ │ │ │ └── dri/ │ │ │ └── 0/ │ │ │ └── amdgpu_pm_info │ │ └── npu/ │ │ ├── amd/ │ │ │ └── sys/ │ │ │ ├── bus/ │ │ │ │ └── pci/ │ │ │ │ └── drivers/ │ │ │ │ └── amdxdna/ │ │ │ │ └── 0000_c4_00.1/ │ │ │ │ ├── accel/ │ │ │ │ │ └── accel0/ │ │ │ │ │ └── dev │ │ │ │ ├── device │ │ │ │ └── vendor │ │ │ └── class/ │ │ │ └── devfreq/ │ │ │ └── amdxdna/ │ │ │ ├── cur_freq │ │ │ ├── max_freq │ │ │ └── min_freq │ │ ├── intel/ │ │ │ └── sys/ │ │ │ └── class/ │ │ │ └── accel/ │ │ │ └── accel0/ │ │ │ └── device/ │ │ │ ├── device │ │ │ ├── hwmon/ │ │ │ │ └── hwmon2/ │ │ │ │ ├── power1_input │ │ │ │ └── temp1_input │ │ │ ├── npu_current_frequency_mhz │ │ │ ├── npu_max_frequency_mhz │ │ │ └── vendor │ │ └── rockchip/ │ │ ├── proc/ │ │ │ └── device-tree/ │ │ │ └── model │ │ └── sys/ │ │ ├── class/ │ │ │ └── devfreq/ │ │ │ └── fdab0000.npu/ │ │ │ ├── cur_freq │ │ │ ├── max_freq │ │ │ └── min_freq │ │ └── kernel/ │ │ └── debug/ │ │ └── rknpu/ │ │ ├── load │ │ ├── mm │ │ └── version │ └── tools/ │ ├── csvcheck.py │ ├── duckdbcheck.py │ └── find-duplicate-lines.sh ├── tox.ini └── uninstall.sh ================================================ FILE CONTENTS ================================================ ================================================ FILE: .cgcignore ================================================ /.git/ /.venv/ /.venv-uv/ /docker-compose/ /docker-files/ /docs/ /snap/ /tests/ /tests-data/ ================================================ FILE: .claude/settings.json ================================================ { "skills": { "test": { "description": "Run the appropriate test suite based on changed files", "path": "skills/test.md" }, "lint": { "description": "Format and lint the codebase with Ruff", "path": "skills/lint.md" }, "new-plugin": { "description": "Scaffold a new Glances monitoring plugin", "path": "skills/new-plugin.md" }, "new-export": { "description": "Scaffold a new Glances export module", "path": "skills/new-export.md" }, "review": { "description": "Review code changes against project guidelines", "path": "skills/review.md" }, "debug": { "description": "Diagnose and fix a Glances bug", "path": "skills/debug.md" }, "webui": { "description": "Build and work with the Vue.js WebUI", "path": "skills/webui.md" }, "docker": { "description": "Build and run Glances Docker images", "path": "skills/docker.md" } } } ================================================ FILE: .claude/skills/debug.md ================================================ # Skill: Debug a Glances Issue Help diagnose and fix a bug in Glances. ## Instructions 1. **Understand the issue**: Ask for or identify: - Error message or traceback - Glances version and OS - How to reproduce (standalone, web server, client/server, Docker?) - Relevant config section from `glances.conf` 2. **Locate the code path**: Based on the mode and plugin involved: - Standalone TUI: `glances/standalone.py` → `glances/outputs/glances_curses.py` - Web server: `glances/webserver.py` → `glances/outputs/glances_restful_api.py` - Client/server: `glances/client.py` / `glances/server.py` - Plugin issue: `glances/plugins//__init__.py` - Export issue: `glances/exports/glances_/__init__.py` - Process list: `glances/processes.py` - Configuration: `glances/config.py` 3. **Run Glances in debug mode** to get detailed logs: ```bash .venv-uv/bin/uv run python -m glances -d 2>&1 | tail -100 ``` 4. **Reproduce with tests** when possible: ```bash .venv-uv/bin/uv run pytest tests/test_core.py -v -k "test_name" 2>&1 ``` 5. **Fix and verify**: - Apply surgical, atomic edits - Run the relevant test suite - Run `make format && make lint` - Verify no regressions with `make test-core` ## Common pitfalls - **psutil version differences**: Some psutil APIs behave differently across OS — always check `glances/globals.py` for platform flags (`LINUX`, `MACOS`, `WINDOWS`, `BSD`) - **Plugin update cycle**: Stats are `None` on first call — handle gracefully - **Snap confinement**: `PermissionError` at `open()`, not at `read()` — wrap the right call - **Docker socket access**: Requires mounting `/var/run/docker.sock` and proper permissions ================================================ FILE: .claude/skills/docker.md ================================================ # Skill: Build and Run Docker Images Build, run, and troubleshoot Glances Docker images locally. ## Instructions ### Build images ```bash make docker # Build all images (Alpine + Ubuntu, full + minimal) make docker-alpine-full # Alpine full image make docker-alpine-minimal # Alpine minimal image make docker-ubuntu-full # Ubuntu full image make docker-ubuntu-minimal # Ubuntu minimal image ``` Requires Docker Buildx (`apt install docker-buildx` on Ubuntu). ### Run containers ```bash make run-docker-alpine-full # Run Alpine full in console mode make run-docker-ubuntu-full # Run Ubuntu full in console mode ``` Default run options: `--rm --pid host --network host` with Docker/Podman socket mounts. ### Security scan ```bash make trivy-docker # Run Trivy on all local images ``` ### Dockerfiles Located in `docker-files/`: - `alpine.Dockerfile` — multi-stage: `minimal` and `full` targets - `ubuntu.Dockerfile` — multi-stage: `minimal` and `full` targets ### Key considerations - Prefer `SYS_PTRACE` capability over `privileged: true` - Mount Docker socket read-only: `-v /var/run/docker.sock:/var/run/docker.sock:ro` - For Kubernetes: use DaemonSet (one pod per node) for system monitoring - CI builds Docker images on `develop` branch and tags only (see `.github/workflows/build_docker.yml`) ### Troubleshooting - **Socket permission errors**: Ensure the user is in the `docker` group or use Podman - **Multi-arch builds**: CI uses QEMU for cross-platform (ARM64) — local builds are native only by default - **Build timeouts**: Multi-arch builds can take 20-40 min; CI timeout is 60 min ================================================ FILE: .claude/skills/lint.md ================================================ # Skill: Lint and Format Run code formatting and linting on the Glances codebase. ## Instructions 1. Run formatting first, then linting: ```bash make format && make lint ``` 2. If there are remaining issues that `--fix` could not resolve, list them and suggest manual fixes. 3. Optionally, if the user asks for a full check, run all pre-commit hooks: ```bash make pre-commit ``` ## Tools used - **Ruff** for both formatting and linting (configured in `pyproject.toml`) - **Pre-commit hooks** include: ruff, gitleaks (secret detection), shellcheck, and others ## Notes - The virtualenv must already exist (`.venv-uv/`). If not, run `make venv-dev` first. - Never change ruff configuration without explicit approval — linting rules are shared across all contributors. ================================================ FILE: .claude/skills/new-export.md ================================================ # Skill: Create a New Export Module Scaffold a new Glances export module following project conventions. ## Instructions Ask the user for: 1. **Export name** (lowercase, e.g., `clickhouse`) 2. **Target system** (database, message queue, file format, etc.) 3. **Required Python library** (e.g., `clickhouse-driver`) Then create the export following this structure: ### File structure ``` glances/exports/glances_/ __init__.py # Export implementation ``` No registration needed — exports are auto-discovered. ### Template The export `__init__.py` must follow this pattern: ```python # # This file is part of Glances. # # SPDX-FileCopyrightText: 2024 Nicolas Hennion # # SPDX-License-Identifier: LGPL-3.0-only # """ interface class.""" from glances.exports.export import GlancesExport from glances.logger import logger class Export(GlancesExport): """This class manages the export module.""" def __init__(self, config=None, args=None): """Init the export module.""" super().__init__(config=config, args=args) # Load config from [] section in glances.conf self.host = self.config.get_value(self.export_name, 'host', default='localhost') self.port = self.config.get_int_value(self.export_name, 'port', default=9000) # Init the connection self.client = self._init_connection() # Set export_enable to True if connection succeeded self.export_enable = self.client is not None def _init_connection(self): """Connect to the target system. Return the connection object or None.""" try: # Initialize your client here client = None logger.info(f"Connected to {self.export_name} ({self.host}:{self.port})") return client except Exception as e: logger.critical(f"Cannot connect to {self.export_name} ({self.host}:{self.port}): {e}") return None def export(self, name, columns, points): """Export the stats to the target system. Args: name: Plugin name (e.g., 'cpu', 'mem') columns: List of field names points: List of field values (same order as columns) """ if not self.export_enable: return # Build and send data data = dict(zip(columns, points)) try: # Send data to target system logger.debug(f"Export {name} to {self.export_name}") except Exception as e: logger.error(f"Cannot export {name} to {self.export_name}: {e}") ``` ### Key conventions - Directory: `glances/exports/glances_/` - Class must be named `Export` (exactly) - Inherit from `GlancesExport` - Configuration is loaded from `[]` section in `glances.conf` - `export_enable` must be set to `True` when the connection is established - The `export(name, columns, points)` method is called for each plugin at each refresh cycle - Use `self.export_name` to get the export module name (auto-derived) - Mark sensitive config keys (passwords, tokens) so they are filtered from the API ### After creation 1. Add the dependency to `pyproject.toml` under the appropriate optional group 2. Add a `[]` section in `conf/glances.conf` with all config keys (commented out) 3. Add an export test script: `tests/test_export_.sh` 4. Run `make test` to verify no regressions ================================================ FILE: .claude/skills/new-plugin.md ================================================ # Skill: Create a New Plugin Scaffold a new Glances monitoring plugin following project conventions. ## Instructions Ask the user for: 1. **Plugin name** (lowercase, e.g., `battery`) 2. **What it monitors** (brief description) 3. **Data source** (psutil, sysfs, external library, etc.) Then create the plugin following this structure: ### File structure ``` glances/plugins// __init__.py # Plugin implementation ``` No registration needed — plugins are auto-discovered. ### Template The plugin `__init__.py` must follow this pattern: ```python # # This file is part of Glances. # # SPDX-FileCopyrightText: 2024 Nicolas Hennion # # SPDX-License-Identifier: LGPL-3.0-only # """ plugin.""" from glances.plugins.plugin.model import GlancesPluginModel # Fields description # https://github.com/nicolargo/glances/wiki/How-to-create-a-new-plugin-%3F fields_description = { 'field_name': { 'description': 'Human-readable description.', 'unit': 'percent', # percent, number, bytes, seconds, etc. }, } class Plugin(GlancesPluginModel): """Glances plugin.""" def __init__(self, args=None, config=None): """Init the plugin.""" super().__init__( args=args, config=config, fields_description=fields_description, ) @GlancesPluginModel._check_decorator @GlancesPluginModel._log_result_decorator def update(self): """Update the stats.""" if self.input_method == 'local': stats = {} # Collect stats here (e.g., from psutil) else: stats = self.get_init_value() self.stats = stats return self.stats ``` ### Key conventions - Class name: `Plugin` (CamelCase with `Plugin` suffix) - The `update()` method must use `@GlancesPluginModel._check_decorator` and `@GlancesPluginModel._log_result_decorator` - `fields_description` declares metadata for each stat field (unit, thresholds, rates, alerts) - Use `self.input_method == 'local'` to distinguish local vs SNMP/remote collection - Optional: add `items_history_list` for time-series history support - Optional: add `snmp_oid` dict for SNMP support - If the plugin depends on another plugin, declare it in `glances/plugins/plugin/dag.py` ### After creation 1. Create a test file: `tests/test_plugin_.py` 2. Run `make test-plugins` to verify 3. Add configuration section in `conf/glances.conf` if needed ================================================ FILE: .claude/skills/review.md ================================================ # Skill: Review Code Changes Review the current changes (staged or unstaged) against Glances project guidelines. ## Instructions 1. Get the diff to review: - If the user provides a PR number, fetch it with `gh pr diff ` - Otherwise, use `git diff` (unstaged) and `git diff --cached` (staged) - If a branch is specified, use `git diff ...` 2. Check each item on this checklist: ### Correctness - [ ] No dead code introduced (unused functions, imports, variables) - [ ] Exception handling wraps the right operation (e.g., `open()` not `read()` for Snap confinement) - [ ] No silent exception swallowing (`except: pass` or bare `except`) - [ ] No O(n²) patterns where O(n) is possible (linear search in a loop → use dict/set) - [ ] No `list.pop(0)` for queues → suggest `collections.deque(maxlen=N)` ### Security - [ ] No credentials/secrets exposed in plain text - [ ] No new endpoints without considering auth implications - [ ] Sensitive config keys filtered from API responses - [ ] No command injection, XSS, or SQL injection vectors ### Compatibility - [ ] Default behaviour unchanged (or breaking change explicitly documented) - [ ] Cross-platform considerations (Linux/macOS/Windows) - [ ] Configuration keys documented in `conf/glances.conf` ### Style - [ ] Code passes `make format && make lint` - [ ] No unnecessary comments, docstrings, or type annotations on unchanged code - [ ] Plugin/export conventions followed (class naming, auto-discovery, fields_description) 3. Report findings grouped by severity: - **Blocking** — must fix before merge - **Suggestion** — improvement, not required - **Nit** — style/cosmetic, optional 4. Use the tone from CLAUDE.md: acknowledge quality, label problems as "blocking concern", invite collaboration. ================================================ FILE: .claude/skills/test.md ================================================ # Skill: Run Tests Run the appropriate Glances test suite based on the current changes or user request. ## Instructions 1. First, check which files have been modified using `git diff --name-only` (staged + unstaged). 2. Determine which test suite(s) to run based on the changed files: - Changes in `glances/plugins/` → `make test-plugins` and/or specific `pytest tests/test_plugin_.py` - Changes in `glances/outputs/glances_restful_api.py` or `glances/outputs/glances_mcp.py` → `make test-restful` - Changes in `glances/outputs/static/` → `make test-webui` - Changes in `glances/exports/` → `make test-exports` (requires Docker) - Changes in `glances/client.py` or `glances/server.py` → `make test-xmlrpc` - Changes in core files (`glances/*.py`) → `make test-core` - If unsure or broad changes → `make test` (runs all tests) 3. If the user specifies a test target (e.g., "run core tests"), use that directly. 4. Run the tests using the Makefile targets. The virtualenv must already exist (`.venv-uv/`). 5. If tests fail, analyze the output and suggest fixes. ## Available test commands ```bash make test # All tests make test-core # Core unit tests make test-plugins # Plugin tests make test-api # API unit tests make test-restful # REST API tests make test-webui # WebUI tests (Selenium) make test-xmlrpc # XML-RPC tests make test-exports # All export integration tests (needs Docker) make test-perf # Performance tests make test-memoryleak # Memory leak tests # Single test file or specific test: .venv-uv/bin/uv run pytest tests/test_core.py .venv-uv/bin/uv run pytest tests/test_core.py::TestGlances::test_000_update ``` ================================================ FILE: .claude/skills/webui.md ================================================ # Skill: Build and Work with the WebUI Build, update, or troubleshoot the Glances Vue.js WebUI. ## Instructions ### Build the WebUI ```bash make webui ``` This runs `npm ci && npm run build` in `glances/outputs/static/`. ### Development workflow 1. Source files are in `glances/outputs/static/` 2. Built output goes to `glances/outputs/static/public/` 3. Stack: Vue.js + Bootstrap 5 + SCSS ### Audit and update dependencies ```bash make webui-audit # Run npm audit make webui-audit-fix # Fix audit issues and rebuild make webui-update # Update all JS dependencies and rebuild ``` ### Run with WebUI ```bash make run-webserver # Start Glances web server on port 61208 ``` Then open http://localhost:61208 in a browser. ### Design principles (from CLAUDE.md) - Strict typographic consistency across all plugins - Pixel-perfect sparkline alignment (CSS grid, fixed row heights) - Footer = vertical alert list (up to 10 entries) - No gauges — prefer sparklines with inline current value ### Troubleshooting - If `npm ci` fails, check Node.js version (LTS required, currently 24.x in CI) - If build artifacts are stale, delete `glances/outputs/static/public/` and rebuild - The CI builds WebUI on `develop` branch only (see `.github/workflows/webui.yml`) ================================================ FILE: .coveragerc ================================================ [report] include = *glances* omit = glances/outputs/* glances/exports/* glances/compat.py glances/autodiscover.py glances/client_browser.py glances/config.py glances/history.py glances/monitored_list.py glances/outdated.py glances/password*.py glances/snmp.py glances/static_list.py exclude_lines = pragma: no cover if PY3: if __name__ == .__main__.: if sys.platform.startswith except ImportError: raise NotImplementedError if WINDOWS if MACOS if BSD ================================================ FILE: .dockerignore ================================================ # Ignore everything * # Include only code files !/glances/**/*.py # Include WebUI files (remove when webui moved to seperate package) !/glances/outputs/static # Include Requirements files !/all-requirements.txt !/docker-requirements.txt # Include Config file !/docker-compose/glances.conf !/docker-files/docker-logger.json # Include Binary file !/docker-bin.sh # Include TOML file !/pyproject.toml ================================================ FILE: .gitattributes ================================================ glances/outputs/static/public/* -diff linguist-vendored ================================================ FILE: .github/FUNDING.yml ================================================ # These are supported funding model platforms github: nicolargo ================================================ FILE: .github/ISSUE_TEMPLATE/bug_report.md ================================================ --- name: Bug report about: Create a report to help us improve title: '' labels: '' assignees: '' --- **Check the bug** Before filling this bug report, please search if a similar issue already exists. In this case, just add a comment on this existing issue. **Describe the bug** A clear and concise description of what the bug is. **To Reproduce** Steps to reproduce the behavior: 1. Start Glances with the following options '...' 2. Press the key '....' 3. See error **Expected behavior** A clear and concise description of what you expected to happen. **Screenshots** If applicable, add screenshots to help explain your problem. **Environement (please complete the following information)** - Operating System (lsb_release -a or OS name/version): `To be completed with result of: lsb_release -a` - Glances & psutil versions: `To be completed with result of: glances -V` - How do you install Glances (Pypi package, script, package manager, source): `To be completed` - Glances test: ` To be completed with result of: glances --issue` **Additional context** Add any other context about the problem here. You can also [pastebin](https://pastebin.com/): * the Glances configuration file (https://glances.readthedocs.io/en/latest/config.html#location) * the Glances log file (https://glances.readthedocs.io/en/latest/config.html#logging) ================================================ FILE: .github/ISSUE_TEMPLATE/feature_request.md ================================================ --- name: Feature request about: Suggest an idea for this project title: '' labels: '' assignees: '' --- **Is your feature request related to a problem? Please describe.** A clear and concise description of what the problem is. Ex. I'm always frustrated when [...] **Describe the solution you'd like** A clear and concise description of what you want to happen. **Describe alternatives you've considered** A clear and concise description of any alternative solutions or features you've considered. **Additional context** Add any other context or screenshots about the feature request here. ================================================ FILE: .github/ISSUE_TEMPLATE.md ================================================ Before filling this issue, please read the manual (https://glances.readthedocs.io/en/latest/) and search if the bug do not already exists in the database (https://github.com/nicolargo/glances/issues). For any questions concerning installation or use, please open a discussion (https://github.com/nicolargo/glances/discussions), not an issue. #### Description For a bug: Describe the bug and list the steps you used when the issue occurred. For an enhancement or new feature: Describe your needs. #### Versions * Glances & psutil versions: `To be completed with result of: glances -V` * Operating System: `To be completed with result of: lsb_release -a` * How do you install Glances (Pypi package, script, package manager, source): `To be completed` * Glances test (only available with Glances 3.1.7 or higher): ``` To be completed with result of: glances --issue ``` #### Configuration and log file You can also [pastebin](https://pastebin.com/): * the Glances configuration file (https://glances.readthedocs.io/en/latest/config.html#location) * the Glances log file (https://glances.readthedocs.io/en/latest/config.html#logging) ================================================ FILE: .github/PULL_REQUEST_TEMPLATE.md ================================================ #### Description Please describe the goal of this pull request. For any questions concerning installation or use, please open a discussion (https://github.com/nicolargo/glances/discussions), not an issue. #### Resume * Bug fix: yes/no * New feature: yes/no * Fixed tickets: comma-separated list of tickets fixed by the PR, if any ================================================ FILE: .github/dependabot.yml ================================================ version: 2 updates: - package-ecosystem: "github-actions" directory: "/" schedule: interval: "weekly" groups: actions: patterns: - "*" - package-ecosystem: "npm" directory: "/glances/outputs/static" schedule: interval: "weekly" groups: npm: patterns: - "*" ================================================ FILE: .github/workflows/build.yml ================================================ # This pipeline aims at building Glances Pypi packages name: build on: workflow_call: jobs: build: name: Build distribution 📦 if: github.event_name == 'push' runs-on: ubuntu-latest timeout-minutes: 10 permissions: contents: read steps: - uses: actions/checkout@93cb6efe18208431cddfb8368fd83d5badbf9bfd # v5 - name: Set up Python uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6 with: python-version: "3.14" - name: Install pypa/build run: >- python3 -m pip install build --user - name: Build a binary wheel and a source tarball run: python3 -m build - name: Store the distribution packages uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4 with: name: python-package-distributions path: dist/ pypi: name: Publish Python 🐍 distribution 📦 to PyPI if: startsWith(github.ref, 'refs/tags') needs: - build runs-on: ubuntu-latest timeout-minutes: 5 environment: name: pypi url: https://pypi.org/p/glances permissions: attestations: write id-token: write steps: - name: Download all the dists uses: actions/download-artifact@634f93cb2916e3fdff6788551b99b062d0335ce0 # v5 with: name: python-package-distributions path: dist/ - name: Publish distribution 📦 to PyPI uses: pypa/gh-action-pypi-publish@ed0c53931b1dc9bd32cbe73a98c7f6766f8a527e # release/v1 with: skip-existing: true attestations: false print-hash: true pypi_test: name: Publish Python 🐍 distribution 📦 to TestPyPI if: github.ref == 'refs/heads/develop' needs: - build runs-on: ubuntu-latest timeout-minutes: 5 environment: name: testpypi url: https://pypi.org/p/glances permissions: attestations: write id-token: write steps: - name: Download all the dists uses: actions/download-artifact@634f93cb2916e3fdff6788551b99b062d0335ce0 # v5 with: name: python-package-distributions path: dist/ - name: Publish distribution 📦 to TestPyPI uses: pypa/gh-action-pypi-publish@ed0c53931b1dc9bd32cbe73a98c7f6766f8a527e # release/v1 with: repository-url: https://test.pypi.org/legacy/ skip-existing: true attestations: false ================================================ FILE: .github/workflows/build_docker.yml ================================================ # This pipeline aims at building Glances Docker images name: build_docker env: DEFAULT_DOCKER_IMAGE: nicolargo/glances PUSH_BRANCH: ${{ 'refs/heads/develop' == github.ref || startsWith(github.ref, 'refs/tags/v') }} # Alpine image platform: https://hub.docker.com/_/alpine # linux/arm/v6,linux/arm/v7 do not work (timeout during the build) DOCKER_PLATFORMS: linux/amd64,linux/arm64/v8 # Ubuntu image platforms list: https://hub.docker.com/_/ubuntu # linux/arm/v7 do not work (Cargo/Rust not available) DOCKER_PLATFORMS_UBUNTU: linux/amd64,linux/arm64/v8 on: workflow_call: secrets: DOCKER_USERNAME: description: 'Docker Hub username' required: true DOCKER_TOKEN: description: 'Docker Hub token' required: true jobs: create_docker_images_list: runs-on: ubuntu-latest timeout-minutes: 5 permissions: {} outputs: tags: ${{ steps.config.outputs.tags }} steps: - name: Determine image tags id: config shell: bash run: | if [[ $GITHUB_REF == refs/tags/* ]]; then VERSION=${GITHUB_REF#refs/tags/v} TAG_ARRAY="[{ \"target\": \"minimal\", \"tag\": \"${VERSION}\" }," TAG_ARRAY="$TAG_ARRAY { \"target\": \"minimal\", \"tag\": \"latest\" }," TAG_ARRAY="$TAG_ARRAY { \"target\": \"full\", \"tag\": \"${VERSION}-full\" }," TAG_ARRAY="$TAG_ARRAY { \"target\": \"full\", \"tag\": \"latest-full\" }]" elif [[ $GITHUB_REF == refs/heads/develop ]]; then TAG_ARRAY="[{ \"target\": \"dev\", \"tag\": \"dev\" }]" else TAG_ARRAY="[]" fi echo "Tags to build: $TAG_ARRAY" echo "tags=$TAG_ARRAY" >> $GITHUB_OUTPUT build_docker_images: runs-on: ubuntu-latest timeout-minutes: 60 permissions: contents: read needs: - create_docker_images_list if: needs.create_docker_images_list.outputs.tags != '[]' strategy: fail-fast: false matrix: os: ['alpine', 'ubuntu'] tag: ${{ fromJson(needs.create_docker_images_list.outputs.tags) }} steps: - name: Checkout uses: actions/checkout@93cb6efe18208431cddfb8368fd83d5badbf9bfd # v5 - name: Retrieve Repository Docker metadata id: docker_meta uses: docker/metadata-action@c299e40c65443455700f0fdfc63efafe5b349051 # v5 with: images: ${{ env.DEFAULT_DOCKER_IMAGE }} labels: | org.opencontainers.image.url=https://nicolargo.github.io/glances/ - name: Set up QEMU uses: docker/setup-qemu-action@c7c53464625b32c7a7e944ae62b3e17d2b600130 # v3 with: platforms: all - name: Set up Docker Buildx id: buildx uses: docker/setup-buildx-action@8d2750c68a42422c14e847fe6c8ac0403b4cbd6f # v3 with: version: latest - name: Login to DockerHub uses: docker/login-action@c94ce9fb468520275223c153574b00df6fe4bcc9 # v3 if: ${{ env.PUSH_BRANCH == 'true' }} with: username: ${{ secrets.DOCKER_USERNAME }} password: ${{ secrets.DOCKER_TOKEN }} - name: Build and push image uses: docker/build-push-action@10e90e3645eae34f1e60eeb005ba3a3d33f178e8 # v6 with: push: ${{ env.PUSH_BRANCH == 'true' }} tags: "${{ env.DEFAULT_DOCKER_IMAGE }}:${{ matrix.os != 'alpine' && format('{0}-', matrix.os) || '' }}${{ matrix.tag.tag }}" build-args: | CHANGING_ARG=${{ github.sha }} context: . file: "docker-files/${{ matrix.os }}.Dockerfile" platforms: ${{ matrix.os != 'ubuntu' && env.DOCKER_PLATFORMS || env.DOCKER_PLATFORMS_UBUNTU }} target: ${{ matrix.tag.target }} labels: ${{ steps.docker_meta.outputs.labels }} # GHA default behaviour overwrites last build cache. Causes alpine and ubuntu cache to overwrite each other. # Use `scope` with the os name to prevent that cache-from: 'type=gha,scope=${{ matrix.os }}' cache-to: 'type=gha,mode=max,scope=${{ matrix.os }}' ================================================ FILE: .github/workflows/ci.yml ================================================ name: ci on: pull_request: branches: [ develop ] push: branches: [ master, develop ] tags: - v* permissions: {} concurrency: group: ${{ github.workflow }}-${{ github.ref }} cancel-in-progress: ${{ github.event_name == 'pull_request' }} jobs: quality: permissions: actions: read contents: read security-events: write uses: ./.github/workflows/quality.yml test: permissions: contents: read uses: ./.github/workflows/test.yml needs: [quality] webui: if: github.ref == 'refs/heads/develop' permissions: contents: write uses: ./.github/workflows/webui.yml needs: [quality, test] build: if: github.event_name != 'pull_request' permissions: contents: read attestations: write id-token: write uses: ./.github/workflows/build.yml needs: [quality, test, webui] build_docker: if: github.event_name != 'pull_request' && (github.ref == 'refs/heads/develop' || startsWith(github.ref, 'refs/tags/')) permissions: contents: read uses: ./.github/workflows/build_docker.yml secrets: DOCKER_USERNAME: ${{ secrets.DOCKER_USERNAME }} DOCKER_TOKEN: ${{ secrets.DOCKER_TOKEN }} needs: [quality, test, webui] cyber: if: github.ref == 'refs/heads/develop' permissions: contents: read security-events: write uses: ./.github/workflows/cyber.yml needs: [quality, test] ================================================ FILE: .github/workflows/cyber.yml ================================================ name: cyber on: workflow_call: jobs: trivy: name: Trivy scan continue-on-error: true timeout-minutes: 15 runs-on: ubuntu-latest permissions: contents: read security-events: write steps: - name: Checkout code uses: actions/checkout@93cb6efe18208431cddfb8368fd83d5badbf9bfd # v5 - name: Run Trivy vulnerability scanner in repo mode uses: aquasecurity/trivy-action@57a97c7e7821a5776cebc9bb87c984fa69cba8f1 # master with: scan-type: 'fs' ignore-unfixed: true format: 'sarif' output: 'trivy-results.sarif' severity: 'CRITICAL' - name: Upload Trivy scan results to GitHub Security tab uses: github/codeql-action/upload-sarif@820e3160e279568db735cee8ed8f8e77a6da7818 # v3 with: sarif_file: 'trivy-results.sarif' ================================================ FILE: .github/workflows/inactive_issues.yml ================================================ name: Label inactive issues on: schedule: - cron: "30 1 * * *" permissions: {} jobs: close-issues: runs-on: ubuntu-latest timeout-minutes: 5 permissions: issues: write pull-requests: write steps: - uses: actions/stale@b5d41d4e1d5dceea10e7104786b73624c18a190f # v10 with: days-before-issue-stale: 90 days-before-issue-close: -1 stale-issue-label: "inactive" stale-issue-message: "This issue is stale because it has been open for 3 months with no activity." close-issue-message: "This issue was closed because it has been inactive for 30 days since being marked as stale." days-before-pr-stale: -1 days-before-pr-close: -1 repo-token: ${{ secrets.GITHUB_TOKEN }} ================================================ FILE: .github/workflows/needs_contributor.yml ================================================ name: Add a message when needs contributor tag is used on: issues: types: - labeled permissions: {} jobs: add-comment: if: github.event.label.name == 'needs contributor' runs-on: ubuntu-latest timeout-minutes: 5 permissions: issues: write steps: - name: Add comment run: gh issue comment "$NUMBER" --body "$BODY" env: GH_TOKEN: ${{ secrets.GITHUB_TOKEN }} GH_REPO: ${{ github.repository }} NUMBER: ${{ github.event.issue.number }} BODY: > This issue is available for anyone to work on. **Make sure to reference this issue in your pull request.** :sparkles: Thank you for your contribution ! :sparkles: ================================================ FILE: .github/workflows/quality.yml ================================================ name: quality on: workflow_call: jobs: analyze: name: Analyze runs-on: ubuntu-latest timeout-minutes: 15 permissions: actions: read contents: read security-events: write strategy: fail-fast: false matrix: language: [ 'javascript', 'python' ] # CodeQL supports [ 'cpp', 'csharp', 'go', 'java', 'javascript', 'python' ] # Learn more: # https://docs.github.com/en/free-pro-team@latest/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning#changing-the-languages-that-are-analyzed steps: - name: Checkout repository uses: actions/checkout@93cb6efe18208431cddfb8368fd83d5badbf9bfd # v5 # Initializes the CodeQL tools for scanning. - name: Initialize CodeQL uses: github/codeql-action/init@820e3160e279568db735cee8ed8f8e77a6da7818 # v3 with: languages: ${{ matrix.language }} # If you wish to specify custom queries, you can do so here or in a config file. # By default, queries listed here will override any specified in a config file. # Prefix the list here with "+" to use these queries and those in the config file. # queries: ./path/to/local/query, your-org/your-repo/queries@main # Autobuild attempts to build any compiled languages (C/C++, C#, or Java). # If this step fails, then you should remove it and run the build manually (see below) - name: Autobuild uses: github/codeql-action/autobuild@820e3160e279568db735cee8ed8f8e77a6da7818 # v3 # ℹ️ Command-line programs to run using the OS shell. # 📚 https://git.io/JvXDl # ✏️ If the Autobuild fails above, remove it and uncomment the following three lines # and modify them (or add more) to build your code if your project # uses a compiled language #- run: | # make bootstrap # make release - name: Perform CodeQL Analysis uses: github/codeql-action/analyze@820e3160e279568db735cee8ed8f8e77a6da7818 # v3 ================================================ FILE: .github/workflows/test.yml ================================================ # Run unitary test name: test on: workflow_call: jobs: source-code-checks: runs-on: ubuntu-24.04 timeout-minutes: 5 permissions: contents: read steps: - uses: actions/checkout@93cb6efe18208431cddfb8368fd83d5badbf9bfd # v5 # - name: Check formatting with Ruff # uses: chartboost/ruff-action@e18ae971ccee1b2d7bbef113930f00c670b78da4 # v1 # with: # args: 'format --check' - name: Check linting with Ruff uses: chartboost/ruff-action@e18ae971ccee1b2d7bbef113930f00c670b78da4 # v1 with: args: 'check' # - name: Static type check # run: | # echo "Skipping static type check for the moment, too much error..."; # # pip install pyright # # pyright glances test-linux: needs: source-code-checks # https://github.com/actions/runner-images?tab=readme-ov-file#available-images runs-on: ubuntu-24.04 timeout-minutes: 15 strategy: matrix: # Python EOL version are note tested # Multiple Python version only tested for Linux python-version: ["3.10", "3.11", "3.12", "3.13", "3.14"] permissions: contents: read steps: - uses: actions/checkout@93cb6efe18208431cddfb8368fd83d5badbf9bfd # v5 - name: Set up Python ${{ matrix.python-version }} uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6 with: python-version: ${{ matrix.python-version }} cache: 'pip' - name: Install dependencies run: | if [ -f dev-requirements.txt ]; then python -m pip install -r dev-requirements.txt; fi if [ -f requirements.txt ]; then python -m pip install -r requirements.txt; fi - name: Unitary tests run: | python -m pytest ./tests/test_core.py test-windows: needs: source-code-checks # https://github.com/actions/runner-images?tab=readme-ov-file#available-images runs-on: windows-2025 timeout-minutes: 15 strategy: matrix: # Windows-curses not available for Python 3.14 for the moment # See https://github.com/zephyrproject-rtos/windows-curses/issues/76 python-version: ["3.13"] permissions: contents: read steps: - uses: actions/checkout@93cb6efe18208431cddfb8368fd83d5badbf9bfd # v5 - name: Set up Python ${{ matrix.python-version }} uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6 with: python-version: ${{ matrix.python-version }} cache: 'pip' - name: Install dependencies run: | if (Test-Path -PathType Leaf "dev-requirements.txt") { python -m pip install -r dev-requirements.txt } if (Test-Path -PathType Leaf "requirements.txt") { python -m pip install -r requirements.txt } pip install . - name: Unitary tests run: | python -m pytest ./tests/test_core.py test-macos: needs: source-code-checks # https://github.com/actions/runner-images?tab=readme-ov-file#available-images runs-on: macos-15 timeout-minutes: 15 strategy: matrix: # Only test the latest stable version python-version: ["3.14"] permissions: contents: read steps: - uses: actions/checkout@93cb6efe18208431cddfb8368fd83d5badbf9bfd # v5 - name: Set up Python ${{ matrix.python-version }} uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6 with: python-version: ${{ matrix.python-version }} cache: 'pip' - name: Install dependencies run: | if [ -f dev-requirements.txt ]; then python -m pip install -r dev-requirements.txt; fi if [ -f requirements.txt ]; then python -m pip install -r requirements.txt; fi - name: Unitary tests run: | python -m pytest ./tests/test_core.py # test-freebsd: # needs: source-code-checks # runs-on: ubuntu-latest # strategy: # matrix: # # Only test the latest stable version # python-version: ["3.14"] # steps: # - uses: actions/checkout@93cb6efe18208431cddfb8368fd83d5badbf9bfd # v5 # - name: Set up Python ${{ matrix.python-version }} # uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6 # with: # python-version: ${{ matrix.python-version }} # cache: 'pip' # - name: Install dependencies # uses: vmactions/freebsd-vm@v1 # with: # usesh: true # run: | # pkg install -y python3 gcc devel/py-pip # python3 --version # if [ -f dev-requirements.txt ]; then python3 -m pip install -r dev-requirements.txt; fi # if [ -f requirements.txt ]; then python3 -m pip install -r requirements.txt; fi # - name: Unitary tests # uses: vmactions/freebsd-vm@v1 # with: # usesh: true # run: | # python3 -m pytest ./tests/test_core.py ================================================ FILE: .github/workflows/webui.yml ================================================ name: webui on: workflow_call: jobs: build: # continue-on-error: true timeout-minutes: 10 runs-on: ubuntu-latest permissions: contents: write strategy: matrix: # Use LTS version only # See supported Node.js release schedule at https://nodejs.org/en/about/releases/ node-version: [24.x] steps: - uses: actions/checkout@93cb6efe18208431cddfb8368fd83d5badbf9bfd # v5 - name: Glances will be build with Node.js ${{ matrix.node-version }} uses: actions/setup-node@a0853c24544627f65ddf259abe73b1d18a591444 # v5 with: node-version: ${{ matrix.node-version }} cache: 'npm' cache-dependency-path: ./glances/outputs/static/package-lock.json - name: Build Glances WebUI working-directory: ./glances/outputs/static run: | npm ci npm run build - name: Commit and push WebUI env: CI_COMMIT_MESSAGE: Continuous Integration Build Artifacts CI_COMMIT_AUTHOR: Continuous Integration run: | git config --global user.name "${{ env.CI_COMMIT_AUTHOR }}" git config --global user.email "glances@nicolargo.com" git add glances/outputs/static /bin/bash -c "git commit -m '${{ env.CI_COMMIT_MESSAGE }}' || true" git push ================================================ FILE: .gitignore ================================================ *~ *.py[co] # Packages *.egg *.egg-info dist build # Eclipse and other IDE .idea *.pydevproject .project .metadata bin/** tmp/** tmp/**/* *.tmp *.bak *.swp *~.nib local.properties .classpath .settings/ .loadpath .ipynb_checkpoints/ # External tool builders .externalToolBuilders/ *yarn.lock # Locally stored "Eclipse launch configurations" *.launch # CDT-specific .cproject # PDT-specific .buildpath # ctags .tags* # Sphinx _build # Tox .tox/ # web ui node_modules/ bower_components/ # visual stdio code .vscode/ .vs/ # Snap packaging specific /snap/.snapcraft/ /parts/ /stage/ /prime/ /*.snap /*_source.tar.bz2 # Virtual env .venv-uv/ .venv/ uv.lock .python-version # Test .coverage tests-data/issues/*/config/ # Local SSL certificates glances.local*.pem # Claudio .claude/settings.local.json ================================================ FILE: .mailmap ================================================ Nicolas Hennion Nicolargo Nicolas Hennion Nicolas Hennion Nicolas Hennion nicolargo Nicolas Hennion nicolargo Nicolas Hennion nicolargo Nicolas Hennion nicolargo Nicolas Hennion Nicolargo Nicolas Hennion nicolargo Alessio Sergi asergi Nicolas Hart nclsHart Nicolas Hart Nicolas Hart Floran Brutel Floran Brutel Brandon Philips Brandon Philips ================================================ FILE: .pre-commit-config.yaml ================================================ repos: - repo: https://github.com/gitleaks/gitleaks rev: v8.24.2 hooks: - id: gitleaks name: "🔒 security · Detect hardcoded secrets" - repo: https://github.com/astral-sh/ruff-pre-commit rev: v0.15.4 hooks: - id: ruff-format name: "🐍 python · Formatter with Ruff" types_or: [ python, pyi ] args: [ --target-version, py310, --config, './pyproject.toml' ] - id: ruff-check name: "🐍 python · Linter with Ruff" types_or: [ python, pyi ] args: [ --fix, --target-version, py310, --config, './pyproject.toml' ] # - repo: https://github.com/RobertCraigie/pyright-python # rev: v1.1.391 # hooks: # - id: pyright # name: "🐍 python · Check types" # - repo: https://github.com/biomejs/pre-commit # rev: "v2.3.7" # hooks: # - id: biome-check # name: "🟨 javascript · Lint, format, and safe fixes with Biome" - repo: https://github.com/python-jsonschema/check-jsonschema rev: 0.35.0 hooks: - id: check-github-workflows name: "🐙 github-actions · Validate gh workflow files" args: ["--verbose"] - repo: https://github.com/shellcheck-py/shellcheck-py rev: v0.11.0.1 hooks: - id: shellcheck name: "🐚 shell · Lint shell scripts" - repo: https://github.com/openstack/bashate rev: 2.1.1 hooks: - id: bashate name: "🐚 shell · Check shell script code style" entry: bashate --error E* --ignore=E006 # - repo: https://github.com/mrtazz/checkmake.git # rev: 0.2.2 # hooks: # - id: checkmake # name: "🐮 Makefile · Lint Makefile" - repo: https://github.com/pre-commit/pre-commit-hooks rev: v6.0.0 hooks: - id: check-executables-have-shebangs name: "📁 filesystem/⚙️ exec · Verify shebang presence" - id: check-shebang-scripts-are-executable name: "📁 filesystem/⚙️ exec · Verify script permissions" - id: check-case-conflict name: "📁 filesystem/📝 names · Check case sensitivity" - id: destroyed-symlinks name: "📁 filesystem/🔗 symlink · Detect broken symlinks" - id: check-merge-conflict name: "🌳 git · Detect conflict markers" - id: forbid-new-submodules name: "🌳 git · Prevent submodule creation" # - id: no-commit-to-branch # name: "🌳 git · Protect main branches" # args: ["--branch", "main", "--branch", "master"] - id: check-added-large-files name: "🌳 git · Block large file commits" args: ['--maxkb=5000'] - id: check-ast name: "🐍 python/🔍 quality · Validate Python AST" - id: check-docstring-first name: "🐍 python/📝 style · Enforce docstring at top" - id: check-json name: "📄 formats/json · Validate JSON files" - id: check-toml name: "📄 formats/toml · Validate TOML files" - id: check-yaml name: "📄 formats/yaml · Validate YAML syntax" - id: debug-statements name: "🐍 python/🪲 debug · Detect debug statements" - id: detect-private-key name: "🔐 security · Detect private keys" - id: mixed-line-ending name: "📄 text/↩️ newline · Normalize line endings" - id: requirements-txt-fixer name: "🐍 python/📦 deps · Sort requirements.txt" - repo: local hooks: - id: find-duplicate-lines name: "❗️local script · Find duplicate lines at the end of file" entry: bash tests-data/tools/find-duplicate-lines.sh language: system types: [python] pass_filenames: false ================================================ FILE: .readthedocs.yaml ================================================ # Read the Docs configuration file for Glances projects # Required version: 2 # Set the OS, Python version and other tools you might need build: os: ubuntu-22.04 tools: python: "3.12" # You can also specify other tool versions: # nodejs: "20" # rust: "1.70" # golang: "1.20" # Build documentation in the "docs/" directory with Sphinx sphinx: configuration: docs/conf.py # You can configure Sphinx to use a different builder, for instance use the dirhtml builder for simpler URLs # builder: "dirhtml" # Fail on all warnings to avoid broken references # fail_on_warning: true # Optionally build your docs in additional formats such as PDF and ePub # formats: # - pdf # - epub # Optional but recommended, declare the Python requirements required # to build your documentation # See https://docs.readthedocs.io/en/stable/guides/reproducible-builds.html python: install: - requirements: dev-requirements.txt ================================================ FILE: .reuse/dep5 ================================================ Format: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/ Upstream-Name: Glances Upstream-Contact: Nicolas Hennion Source: https://github.com/nicolargo/glances # Sample paragraph, commented out: # # Files: src/* # Copyright: $YEAR $NAME <$CONTACT> # License: ... ================================================ FILE: AUTHORS ================================================ ========== Developers ========== Nicolas Hennion (aka) Nicolargo http://blog.nicolargo.com https://twitter.com/nicolargo https://github.com/nicolargo nicolashennion@gmail.com PGP Fingerprint: A0D9 628F 5A83 A879 48EA B1FE BA43 C11F 2C8B 4347 PGP Public key: gpg --keyserver pgp.mit.edu --recv-keys 0xba43c11f2c8b4347 RazCrimson (maintainer of the Glances project) https://github.com/RazCrimson Ariel Otibili (aka) ariel-anieli (for the huge work on code quality) https://github.com/ariel-anieli Alessio Sergi (aka) Al3hex (thanks you for the great job on this project) https://twitter.com/al3hex https://github.com/asergi Floran Brutel (aka) notFloran (maintainer of the Web User Interface) https://github.com/notFloran fr4nc0is (maintainer of the Web User Interface) https://github.com/fr4nc0is Brandon Philips (aka) Philips http://ifup.org/ https://github.com/philips Jon Renner (aka) Jrenner https://github.com/jrenner Maxime Desbrus (aka) Desbma https://github.com/desbma Nicolas Hart (aka) NclsHart (for the Web user interface) https://github.com/nclsHart Sylvain Mouquet (aka) SylvainMouquet (for the Web user interface) http://github.com/sylvainmouquet Erik Eriksson (aka) Molobrakos (for the MQTT plugin and various PR) https://www.linkedin.com/in/error-errorsson/ ========= Packagers ========= 林博仁(Buo-ren Lin) Lin-Buo-Ren for the Snap package https://lin-buo-ren.github.io/ https://snapcraft.io/glances/releases Daniel Echeverry and Sebastien Badia for the Debian package https://tracker.debian.org/pkg/glances Philip Lacroix and Nicolas Kovacs for the Slackware (SlackBuild) package gasol.wu@gmail.com for the FreeBSD port Frederic Aoustin (https://github.com/fraoustin) and Nicolas Bourges (installer) for the Windows port Aljaž Srebrnič for the MacPorts package http://www.macports.org/ports.php?by=name&substr=glances John Kirkham for the conda package (at conda-forge) https://github.com/conda-forge/glances-feedstock Rui Chen for the Homebrew package https://chenrui.dev/ https://formulae.brew.sh/formula/glances ================================================ FILE: CLAUDE.md ================================================ # CLAUDE.md — Glances Maintainer Context > Auto-loaded by Claude Code at the start of every session. > Describes my role, principles, constraints, and working patterns > specific to the Glances project. --- ## Role and posture I am maintainer of **Glances** (`nicolargo/glances`), a cross-platform open-source system monitoring tool used by **thousands of users** in production. This implies: - Prioritising **non-regression** above all else: any change that breaks existing behaviour has a real cost for real users. - Being **conservative about default behaviour**: most users run Glances without any custom configuration, on a private network, for personal use. Every change to a default must be evaluated against this dominant use case. - Being **innovative in refactoring** to preserve readability, security, and long-term maintainability — provided changes are incremental and reversible. - Treating every technical decision as an **explicit trade-off** between security, usability, and backward compatibility. --- ## Tech stack | Layer | Technology | | --- | --- | | Backend | Python, psutil, FastAPI (REST API), curses (TUI) | | Frontend | Vue.js, Bootstrap 5, SCSS | | Export plugins | InfluxDB, MongoDB, MQTT, DuckDB, and others | | Infrastructure | GitHub Actions, Helm/Kubernetes, Snap (snapcraft) | | LLM abstraction | LiteLLM (multi-provider) | | GPU/NPU monitoring | pynvml, sysfs/debugfs | --- ## Development Setup ```bash make install-uv # Install UV in .venv-uv/ make venv-dev # Create virtualenv with all deps + dev tools + pre-commit hooks ``` --- ## Common Commands ### Tests ```bash make test # All tests (via pytest) make test-core # Core unit tests (tests/test_core.py) make test-plugins # Plugin tests (tests/test_plugin_*.py) make test-restful # REST API tests make test-webui # Selenium WebUI tests make test-exports # All export integration tests (shell scripts, need Docker) # Single test file or specific test: .venv-uv/bin/uv run pytest tests/test_core.py .venv-uv/bin/uv run pytest tests/test_core.py::TestGlances::test_000_update ``` ### Linting & Formatting ```bash make format # Ruff format make lint # Ruff check --fix make pre-commit # All pre-commit hooks (ruff, gitleaks, shellcheck, etc.) ``` ### WebUI ```bash make webui # npm ci && npm run build (outputs to glances/outputs/static/public/) ``` ### Running Glances ```bash .venv-uv/bin/uv run python -m glances # Standalone TUI .venv-uv/bin/uv run python -m glances -w # Web server (default port 61208) .venv-uv/bin/uv run python -m glances -C conf/glances.conf # With specific config ``` ## Architecture ### Modes (selected in `glances/main.py` → dispatched in `glances/__init__.py`) - **Standalone** — curses TUI (`glances/standalone.py`) - **Client/Server** — XML-RPC remote monitoring (`glances/client.py`, `glances/server.py`) - **Web server** — FastAPI REST API + Vue.js WebUI + optional MCP (`glances/webserver.py`) ### Stats Engine (`glances/stats.py`) Central orchestrator that dynamically discovers and loads all plugins and exports. Exposes `get()` magic methods. Runs plugin updates concurrently. ### Plugin System (`glances/plugins/`) - **Base class:** `GlancesPluginModel` in `glances/plugins/plugin/model.py` - **Convention:** each plugin lives in `glances/plugins//__init__.py`, exports a class inheriting from `GlancesPluginModel` - **Interface:** `update()` fetches data (typically from psutil), stores in `self.stats`; `fields_description` dict declares field metadata (unit, thresholds, rates, alerts) - **Dependency DAG:** `glances/plugins/plugin/dag.py` — declares inter-plugin dependencies (e.g. `cpu` depends on `core`), used by the REST API to resolve fetch order - **Auto-discovery:** plugins are discovered automatically — no central registration needed; just add a new directory under `glances/plugins/` - **~39 plugins:** cpu, mem, memswap, network, diskio, fs, containers, gpu, sensors, processlist, alert, etc. ### Export System (`glances/exports/`) - **Base class:** `GlancesExport` in `glances/exports/export.py` - **Convention:** each exporter in `glances/exports/glances_/__init__.py`, class named `Export` - **Auto-discovery:** same pattern as plugins — no central registration needed - **Non-exportable plugins** (hardcoded filter): alert, help, plugin, psutilversion, quicklook, version - **~26 exporters:** CSV, JSON, InfluxDB (v1/v2/v3), Prometheus, Elasticsearch, Kafka, MQTT, etc. ### REST API (`glances/outputs/glances_restful_api.py`) FastAPI app with Basic + JWT auth, CORS, optional TLS, DNS rebinding protection. Endpoints under `/api/` for stats, `/api//history` for time-series. All new configuration keys must be declared and loaded in `GlancesRestfulApi.load_config()`. Advanced options use config-file keys only (no CLI flag) — follow the `cors_origins` pattern. ### MCP Server (`glances/outputs/glances_mcp.py`) FastMCP-based, mounted as ASGI in the FastAPI app. Provides resources (plugin stats, limits, history) and prompts (system health, alerts analysis). ### Process Manager (`glances/processes.py`) Complex module (~31 KB) managing the process list with threading, sorting, and filtering. Used by the `processlist` plugin. ### Configuration (`glances/config.py`) INI format, searched in `~/.config/glances/`, `/etc/glances/`, and bundled `conf/`. Per-plugin sections with thresholds and options. Sensitive keys (passwords, tokens, API keys) are filtered from public API responses. --- ## Code principles ### No dead code Never merge code that is not used anywhere in the codebase, regardless of its quality. Every PR must either fix a bug, introduce an actively integrated feature, or replace existing code. Dead code burdens reviews, confuses future contributors, and misleads static analysis tools. ### Surgical edits Prefer targeted, atomic changes over full rewrites. Validate — visually or functionally — after each atomic change. Never bundle multiple distinct logical fixes into a single edit block. ### Exception handling for Snap confinement Wrap the `open()` call inside `try/except`, not just the `read()`. Snap's strict confinement blocks host file access at the open stage, not the read stage. ### Kubernetes workloads Use a **DaemonSet** (one pod per node) for system-level monitoring. Prefer `SYS_PTRACE` over `privileged: true`. --- ## Security ### General philosophy Glances runs unauthenticated by default — this is intentional and documented. The majority of users deploy it on private networks for personal use. Security mitigations must: 1. **Not change the default behaviour** — unless the vulnerability is critical and exploitable without any user action. 2. **Add a startup warning** when running in an exposed configuration (non- loopback bind, no authentication). Visible, but non-fatal. 3. **Provide optional configuration keys** for advanced deployments — commented out by default so behaviour is unchanged. 4. **Document risks and hardening recommendations** in the official docs. ### Pattern for a new optional protection ```ini # [outputs] in glances.conf # Commented out by default = unchanged behaviour (backward compatibility guaranteed) # Uncomment and configure to enable the protection # webui_allowed_hosts=localhost,127.0.0.1,myserver.example.com ``` ### Sensitive endpoints - `/api/4/config` and `/api/4/args` — never expose credentials in plain text (InfluxDB passwords, MongoDB tokens, MQTT passphrases, SSL key paths, etc.) for unauthenticated access. Use the conditional `as_dict_secure()` method, applied when `self.args.password` is `False`. - CORS: `allow_origins=["*"]` + `allow_credentials=True` is invalid per the CORS spec and reflected by Starlette. Default: `allow_credentials=False`. - DNS rebinding: `TrustedHostMiddleware` via `webui_allowed_hosts` (optional). The MCP endpoint is already protected via `mcp_allowed_hosts` + `TransportSecuritySettings` in `glances/outputs/glances_mcp.py`. ### Security documents Security reports and internal remediation plans are **confidential internal documents**. Always deliver them as downloadable files — never as inline text in a conversation. --- ## Contribution management (PRs and Issues) ### Dead code rule Systematically reject any PR that introduces unused code. Offer the contributor a path forward: - complete the PR with the actual integration, or - split it into two PRs linked by a tracking issue. Never close a PR without offering a resolution path. ### Tone with contributors - Always acknowledge the quality of the code, even when rejecting the PR. - Label the problem as a "blocking concern", not a judgement. - End with an explicit invitation to keep collaborating. - Key phrase: *"I'm not closing the PR — I just want to make sure we get this right together."* - Language: **English** for all public messages and PR comments. ### Before merging a PR - [ ] The code is actively used (no dead code) - [ ] Existing tests pass - [ ] New behaviour is covered by tests - [ ] New configuration keys are documented - [ ] Breaking changes are identified and documented - [ ] The PR targets the correct branch - [ ] Code should be formated and linted (make lint && make format) ### GitHub Issues Always deliver GitHub issues as a **downloadable `.md` file** — never as inline text in the conversation. Expected structure: - Summary / symptom - Technical analysis (with file and line references) - Proposed fix — diff or pseudo-code - Test checklist - Impact and severity - Breaking changes if any ### Responses to security reports Same structure as issues, with the addition of: - Maintainer's position on the default behaviour (justified) - What will be done / what will not be done (and why) - Timeline - Thanks to the reporter --- ## Expected output formats | Deliverable | Format | | --- | --- | | GitHub issue | Downloadable `.md` file — never inline | | Security alert response | Downloadable `.md` file, marked confidential if internal | | Audit report (architecture, security) | Downloadable `.md` file | | Changelog entry | `.rst` file following the `NEWS.rst` format | | UI prototype | Self-contained single-file `.html` | | Helm Chart | `.tgz` archive or structured directory | --- ## Safe refactoring — two-phase strategy For any medium-to-high-risk refactoring, always apply the **two-phase approach**: **Phase 1** — Introduce the new mechanism alongside the old one, with the old as fallback. No behaviour changes for existing users. **Phase 2** — Deprecate the old mechanism over one or two releases, then remove it. This ensures no existing deployment is broken during the transition, while allowing the new mechanism to be validated on a real user base before the old one is deleted. Applied example: plugin dependency DAG — keep the hardcoded dict as fallback, add class-attribute discovery, deprecate the dict over two releases. --- ## UI / TUI ### Web UI Stack: Vue.js + Bootstrap 5 + SCSS. Design principles: - Strict typographic consistency across all plugins (size, weight, opacity, letter-spacing). - Pixel-perfect sparkline alignment (CSS grid, fixed row heights). - Footer = vertical alert list (up to 10 entries), not a single horizontal row. - No gauges — prefer sparklines with an inline current value. ### TUI (curses) - 256-colour system with automatic fallback for limited terminals. - Lightweight hierarchical separators for information density. --- ## CI/CD — GitHub Actions In `build_docker.yml`, the trigger condition combines branch exclusion and event type — a dynamic matrix with zero entries causes a silent failure without this guard: ```yaml if: > github.event_name != 'pull_request' && (github.ref == 'refs/heads/develop' || startsWith(github.ref, 'refs/tags/')) ``` The `master` branch does not trigger a Docker build (empty matrix = silent failure without this condition). --- ## Communication | Context | Language | | --- | --- | | Working exchanges | French or English | | Issues, PRs, contributor messages | English | | Public documentation | English | | Internal reports (security, audit) | English | Request style: terse, numbered, precise. Respond in the same register. ================================================ FILE: CODE-OF-CONDUCT.md ================================================ # Contributor Covenant Code of Conduct ## Our Pledge In the interest of fostering an open and welcoming environment, we as contributors and maintainers pledge to making participation in our project and our community a harassment-free experience for everyone, regardless of age, body size, disability, ethnicity, gender identity and expression, level of experience, education, socioeconomic status, nationality, personal appearance, race, religion, or sexual identity and orientation. ## Our Standards Examples of behavior that contributes to creating a positive environment include: * Using welcoming and inclusive language * Being respectful of differing viewpoints and experiences * Gracefully accepting constructive criticism * Focusing on what is best for the community * Showing empathy towards other community members Examples of unacceptable behavior by participants include: * The use of sexualized language or imagery and unwelcome sexual attention or advances * Trolling, insulting/derogatory comments, and personal or political attacks * Public or private harassment * Publishing others' private information, such as a physical or electronic address, without explicit permission * Other conduct which could reasonably be considered inappropriate in a professional setting ## Our Responsibilities Project maintainers are responsible for clarifying the standards of acceptable behavior and are expected to take appropriate and fair corrective action in response to any instances of unacceptable behavior. Project maintainers have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct, or to ban temporarily or permanently any contributor for other behaviors that they deem inappropriate, threatening, offensive, or harmful. ## Scope This Code of Conduct applies both within project spaces and in public spaces when an individual is representing the project or its community. Examples of representing a project or community include using an official project e-mail address, posting via an official social media account, or acting as an appointed representative at an online or offline event. Representation of a project may be further defined and clarified by project maintainers. ## Enforcement Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by contacting the project team at nicolashennion@gmail.com. All complaints will be reviewed and investigated and will result in a response that is deemed necessary and appropriate to the circumstances. The project team is obligated to maintain confidentiality with regard to the reporter of an incident. Further details of specific enforcement policies may be posted separately. Project maintainers who do not follow or enforce the Code of Conduct in good faith may face temporary or permanent repercussions as determined by other members of the project's leadership. ## Attribution This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4, available at https://www.contributor-covenant.org/version/1/4/code-of-conduct.html [homepage]: https://www.contributor-covenant.org ================================================ FILE: CONTRIBUTING.md ================================================ # Contributing to Glances Looking to contribute something to Glances ? **Here's how you can help.** Please take a moment to review this document in order to make the contribution process easy and effective for everyone involved. Following these guidelines helps to communicate that you respect the time of the developers managing and developing this open source project. In return, they should reciprocate that respect in addressing your issue or assessing patches and features. ## Using the issue tracker The [issue tracker](https://github.com/nicolargo/glances/issues) is the preferred channel for [bug reports](#bug-reports), [features requests](#feature-requests) and [submitting pull requests](#pull-requests), but please respect the following restrictions: * Please **do not** use the issue tracker for personal support requests. An official Q&A exist. [Use it](https://groups.google.com/forum/?hl=en#!forum/glances-users)! * Please **do not** derail or troll issues. Keep the discussion on topic and respect the opinions of others. ## Bug reports A bug is a _demonstrable problem_ that is caused by the code in the repository. Good bug reports are extremely helpful, so thanks! Guidelines for bug reports: 0. **Use the GitHub issue search** — check if the issue has already been reported. 1. **Check if the issue has been fixed** — try to reproduce it using the latest `master` or `develop` branch in the repository. 2. **Isolate the problem** — ideally create a simple test bed. 3. **Give us your test environment** — Operating system name and version Glances version... Example: > Short and descriptive example bug report title. > > Glances and psutil version used (glances -V). > > Operating system description (name and version). > > A summary of the issue and the OS environment in which it occurs. If > suitable, include the steps required to reproduce the bug. > > 1. This is the first step > 2. This is the second step > 3. Further steps, etc. > > Screenshot (if useful) > > Any other information you want to share that is relevant to the issue being > reported. This might include the lines of code that you have identified as > causing the bug, and potential solutions (and your opinions on their > merits). > > You can also run Glances in debug mode (-d) and paste/bin the glances.conf file (). > > Glances 3.2.0 or higher have also a --issue option to run a simple test. Please use it and copy/paste the output. ## Feature requests Feature requests are welcome. But take a moment to find out whether your idea fits with the scope and aims of the project. It's up to _you* to make a strong case to convince the project's developers of the merits of this feature. Please provide as much detail and context as possible. ## Pull requests Good pull requests—patches, improvements, new features—are a fantastic help. They should remain focused in scope and avoid containing unrelated commits. **Please ask first** before embarking on any significant pull request (e.g. implementing features, refactoring code, porting to a different language), otherwise you risk spending a lot of time working on something that the project's developers might not want to merge into the project. First of all, all pull request should be done on the `develop` branch. Glances uses PEP8 compatible code, so use a PEP validator before submitting your pull request. Also uses the unitaries tests scripts (unitest-all.py). Similarly, when contributing to Glances's documentation, you should edit the documentation source files in [the `/doc/` and `/man/` directories of the `develop` branch](https://github.com/nicolargo/glances/tree/develop/docs) and generate the documentation outputs files by reading the [README](https://github.com/nicolargo/glances/tree/develop/docs/README.txt) file. Adhering to the following process is the best way to get your work included in the project: 1. [Fork](https://help.github.com/fork-a-repo/) the project, clone your fork, and configure the remotes: ```bash # Clone your fork of the repo into the current directory git clone https://github.com//glances.git # Navigate to the newly cloned directory cd glances # Assign the original repo to a remote called "upstream" git remote add upstream https://github.com/nicolargo/glances.git ``` 2. Get the latest changes from upstream: ```bash git checkout develop git pull upstream develop ``` 3. Create a new topic branch (off the main project development branch) to contain your feature, change, or fix (best way is to call it issue#xxx): ```bash git checkout -b ``` 4. It's coding time ! Please respect the following coding convention: [Elements of Python Style](https://github.com/amontalenti/elements-of-python-style) 5. Test you code using the Makefile: * make format ==> Format your code thanks to the Ruff linter * make run ==> Run Glances * make run-webserver ==> Run a Glances Web Server * make test ==> Run unit tests * make docs ==> Update docs * make webui ==> Compile a new Web UI 6. Commit your changes in logical chunks. Please adhere to these [git commit message guidelines](http://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html) or your code is unlikely be merged into the main project. Use Git's [interactive rebase](https://help.github.com/articles/interactive-rebase) feature to tidy up your commits before making them public. 7. Locally merge (or rebase) the upstream development branch into your topic branch: ```bash git pull [--rebase] upstream develop ``` 8. Push your topic branch up to your fork: ```bash git push origin ``` 9. [Open a Pull Request](https://help.github.com/articles/using-pull-requests/) with a clear title and description against the `develop` branch. **IMPORTANT**: By submitting a patch, you agree to allow the project owners to license your work under the terms of the [LGPLv3](COPYING) (if it includes code changes). ================================================ FILE: COPYING ================================================ GNU LESSER GENERAL PUBLIC LICENSE Version 3, 29 June 2007 Copyright (C) 2007 Free Software Foundation, Inc. Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed. This version of the GNU Lesser General Public License incorporates the terms and conditions of version 3 of the GNU General Public License, supplemented by the additional permissions listed below. 0. Additional Definitions. As used herein, "this License" refers to version 3 of the GNU Lesser General Public License, and the "GNU GPL" refers to version 3 of the GNU General Public License. "The Library" refers to a covered work governed by this License, other than an Application or a Combined Work as defined below. An "Application" is any work that makes use of an interface provided by the Library, but which is not otherwise based on the Library. Defining a subclass of a class defined by the Library is deemed a mode of using an interface provided by the Library. A "Combined Work" is a work produced by combining or linking an Application with the Library. The particular version of the Library with which the Combined Work was made is also called the "Linked Version". The "Minimal Corresponding Source" for a Combined Work means the Corresponding Source for the Combined Work, excluding any source code for portions of the Combined Work that, considered in isolation, are based on the Application, and not on the Linked Version. The "Corresponding Application Code" for a Combined Work means the object code and/or source code for the Application, including any data and utility programs needed for reproducing the Combined Work from the Application, but excluding the System Libraries of the Combined Work. 1. Exception to Section 3 of the GNU GPL. You may convey a covered work under sections 3 and 4 of this License without being bound by section 3 of the GNU GPL. 2. Conveying Modified Versions. If you modify a copy of the Library, and, in your modifications, a facility refers to a function or data to be supplied by an Application that uses the facility (other than as an argument passed when the facility is invoked), then you may convey a copy of the modified version: a) under this License, provided that you make a good faith effort to ensure that, in the event an Application does not supply the function or data, the facility still operates, and performs whatever part of its purpose remains meaningful, or b) under the GNU GPL, with none of the additional permissions of this License applicable to that copy. 3. Object Code Incorporating Material from Library Header Files. The object code form of an Application may incorporate material from a header file that is part of the Library. You may convey such object code under terms of your choice, provided that, if the incorporated material is not limited to numerical parameters, data structure layouts and accessors, or small macros, inline functions and templates (ten or fewer lines in length), you do both of the following: a) Give prominent notice with each copy of the object code that the Library is used in it and that the Library and its use are covered by this License. b) Accompany the object code with a copy of the GNU GPL and this license document. 4. Combined Works. You may convey a Combined Work under terms of your choice that, taken together, effectively do not restrict modification of the portions of the Library contained in the Combined Work and reverse engineering for debugging such modifications, if you also do each of the following: a) Give prominent notice with each copy of the Combined Work that the Library is used in it and that the Library and its use are covered by this License. b) Accompany the Combined Work with a copy of the GNU GPL and this license document. c) For a Combined Work that displays copyright notices during execution, include the copyright notice for the Library among these notices, as well as a reference directing the user to the copies of the GNU GPL and this license document. d) Do one of the following: 0) Convey the Minimal Corresponding Source under the terms of this License, and the Corresponding Application Code in a form suitable for, and under terms that permit, the user to recombine or relink the Application with a modified version of the Linked Version to produce a modified Combined Work, in the manner specified by section 6 of the GNU GPL for conveying Corresponding Source. 1) Use a suitable shared library mechanism for linking with the Library. A suitable mechanism is one that (a) uses at run time a copy of the Library already present on the user's computer system, and (b) will operate properly with a modified version of the Library that is interface-compatible with the Linked Version. e) Provide Installation Information, but only if you would otherwise be required to provide such information under section 6 of the GNU GPL, and only to the extent that such information is necessary to install and execute a modified version of the Combined Work produced by recombining or relinking the Application with a modified version of the Linked Version. (If you use option 4d0, the Installation Information must accompany the Minimal Corresponding Source and Corresponding Application Code. If you use option 4d1, you must provide the Installation Information in the manner specified by section 6 of the GNU GPL for conveying Corresponding Source.) 5. Combined Libraries. You may place library facilities that are a work based on the Library side by side in a single library together with other library facilities that are not Applications and are not covered by this License, and convey such a combined library under terms of your choice, if you do both of the following: a) Accompany the combined library with a copy of the same work based on the Library, uncombined with any other library facilities, conveyed under the terms of this License. b) Give prominent notice with the combined library that part of it is a work based on the Library, and explaining where to find the accompanying uncombined form of the same work. 6. Revised Versions of the GNU Lesser General Public License. The Free Software Foundation may publish revised and/or new versions of the GNU Lesser General Public License from time to time. Such new versions will be similar in spirit to the present version, but may differ in detail to address new problems or concerns. Each version is given a distinguishing version number. If the Library as you received it specifies that a certain numbered version of the GNU Lesser General Public License "or any later version" applies to it, you have the option of following the terms and conditions either of that published version or of any later version published by the Free Software Foundation. If the Library as you received it does not specify a version number of the GNU Lesser General Public License, you may choose any version of the GNU Lesser General Public License ever published by the Free Software Foundation. If the Library as you received it specifies that a proxy can decide whether future versions of the GNU Lesser General Public License shall apply, that proxy's public statement of acceptance of any version is permanent authorization for you to choose that version for the Library. GNU GENERAL PUBLIC LICENSE Version 3, 29 June 2007 Copyright © 2007 Free Software Foundation, Inc. Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed. Preamble The GNU General Public License is a free, copyleft license for software and other kinds of works. The licenses for most software and other practical works are designed to take away your freedom to share and change the works. By contrast, the GNU General Public License is intended to guarantee your freedom to share and change all versions of a program--to make sure it remains free software for all its users. We, the Free Software Foundation, use the GNU General Public License for most of our software; it applies also to any other work released this way by its authors. You can apply it to your programs, too. When we speak of free software, we are referring to freedom, not price. Our General Public Licenses are designed to make sure that you have the freedom to distribute copies of free software (and charge for them if you wish), that you receive source code or can get it if you want it, that you can change the software or use pieces of it in new free programs, and that you know you can do these things. To protect your rights, we need to prevent others from denying you these rights or asking you to surrender the rights. Therefore, you have certain responsibilities if you distribute copies of the software, or if you modify it: responsibilities to respect the freedom of others. For example, if you distribute copies of such a program, whether gratis or for a fee, you must pass on to the recipients the same freedoms that you received. You must make sure that they, too, receive or can get the source code. And you must show them these terms so they know their rights. Developers that use the GNU GPL protect your rights with two steps: (1) assert copyright on the software, and (2) offer you this License giving you legal permission to copy, distribute and/or modify it. For the developers' and authors' protection, the GPL clearly explains that there is no warranty for this free software. For both users' and authors' sake, the GPL requires that modified versions be marked as changed, so that their problems will not be attributed erroneously to authors of previous versions. Some devices are designed to deny users access to install or run modified versions of the software inside them, although the manufacturer can do so. This is fundamentally incompatible with the aim of protecting users' freedom to change the software. The systematic pattern of such abuse occurs in the area of products for individuals to use, which is precisely where it is most unacceptable. Therefore, we have designed this version of the GPL to prohibit the practice for those products. If such problems arise substantially in other domains, we stand ready to extend this provision to those domains in future versions of the GPL, as needed to protect the freedom of users. Finally, every program is threatened constantly by software patents. States should not allow patents to restrict development and use of software on general-purpose computers, but in those that do, we wish to avoid the special danger that patents applied to a free program could make it effectively proprietary. To prevent this, the GPL assures that patents cannot be used to render the program non-free. The precise terms and conditions for copying, distribution and modification follow. TERMS AND CONDITIONS 0. Definitions. “This License” refers to version 3 of the GNU General Public License. “Copyright” also means copyright-like laws that apply to other kinds of works, such as semiconductor masks. “The Program” refers to any copyrightable work licensed under this License. Each licensee is addressed as “you”. “Licensees” and “recipients” may be individuals or organizations. To “modify” a work means to copy from or adapt all or part of the work in a fashion requiring copyright permission, other than the making of an exact copy. The resulting work is called a “modified version” of the earlier work or a work “based on” the earlier work. A “covered work” means either the unmodified Program or a work based on the Program. To “propagate” a work means to do anything with it that, without permission, would make you directly or secondarily liable for infringement under applicable copyright law, except executing it on a computer or modifying a private copy. Propagation includes copying, distribution (with or without modification), making available to the public, and in some countries other activities as well. To “convey” a work means any kind of propagation that enables other parties to make or receive copies. Mere interaction with a user through a computer network, with no transfer of a copy, is not conveying. An interactive user interface displays “Appropriate Legal Notices” to the extent that it includes a convenient and prominently visible feature that (1) displays an appropriate copyright notice, and (2) tells the user that there is no warranty for the work (except to the extent that warranties are provided), that licensees may convey the work under this License, and how to view a copy of this License. If the interface presents a list of user commands or options, such as a menu, a prominent item in the list meets this criterion. 1. Source Code. The “source code” for a work means the preferred form of the work for making modifications to it. “Object code” means any non-source form of a work. A “Standard Interface” means an interface that either is an official standard defined by a recognized standards body, or, in the case of interfaces specified for a particular programming language, one that is widely used among developers working in that language. The “System Libraries” of an executable work include anything, other than the work as a whole, that (a) is included in the normal form of packaging a Major Component, but which is not part of that Major Component, and (b) serves only to enable use of the work with that Major Component, or to implement a Standard Interface for which an implementation is available to the public in source code form. A “Major Component”, in this context, means a major essential component (kernel, window system, and so on) of the specific operating system (if any) on which the executable work runs, or a compiler used to produce the work, or an object code interpreter used to run it. The “Corresponding Source” for a work in object code form means all the source code needed to generate, install, and (for an executable work) run the object code and to modify the work, including scripts to control those activities. However, it does not include the work's System Libraries, or general-purpose tools or generally available free programs which are used unmodified in performing those activities but which are not part of the work. For example, Corresponding Source includes interface definition files associated with source files for the work, and the source code for shared libraries and dynamically linked subprograms that the work is specifically designed to require, such as by intimate data communication or control flow between those subprograms and other parts of the work. The Corresponding Source need not include anything that users can regenerate automatically from other parts of the Corresponding Source. The Corresponding Source for a work in source code form is that same work. 2. Basic Permissions. All rights granted under this License are granted for the term of copyright on the Program, and are irrevocable provided the stated conditions are met. This License explicitly affirms your unlimited permission to run the unmodified Program. The output from running a covered work is covered by this License only if the output, given its content, constitutes a covered work. This License acknowledges your rights of fair use or other equivalent, as provided by copyright law. You may make, run and propagate covered works that you do not convey, without conditions so long as your license otherwise remains in force. You may convey covered works to others for the sole purpose of having them make modifications exclusively for you, or provide you with facilities for running those works, provided that you comply with the terms of this License in conveying all material for which you do not control copyright. Those thus making or running the covered works for you must do so exclusively on your behalf, under your direction and control, on terms that prohibit them from making any copies of your copyrighted material outside their relationship with you. Conveying under any other circumstances is permitted solely under the conditions stated below. Sublicensing is not allowed; section 10 makes it unnecessary. 3. Protecting Users' Legal Rights From Anti-Circumvention Law. No covered work shall be deemed part of an effective technological measure under any applicable law fulfilling obligations under article 11 of the WIPO copyright treaty adopted on 20 December 1996, or similar laws prohibiting or restricting circumvention of such measures. When you convey a covered work, you waive any legal power to forbid circumvention of technological measures to the extent such circumvention is effected by exercising rights under this License with respect to the covered work, and you disclaim any intention to limit operation or modification of the work as a means of enforcing, against the work's users, your or third parties' legal rights to forbid circumvention of technological measures. 4. Conveying Verbatim Copies. You may convey verbatim copies of the Program's source code as you receive it, in any medium, provided that you conspicuously and appropriately publish on each copy an appropriate copyright notice; keep intact all notices stating that this License and any non-permissive terms added in accord with section 7 apply to the code; keep intact all notices of the absence of any warranty; and give all recipients a copy of this License along with the Program. You may charge any price or no price for each copy that you convey, and you may offer support or warranty protection for a fee. 5. Conveying Modified Source Versions. You may convey a work based on the Program, or the modifications to produce it from the Program, in the form of source code under the terms of section 4, provided that you also meet all of these conditions: a) The work must carry prominent notices stating that you modified it, and giving a relevant date. b) The work must carry prominent notices stating that it is released under this License and any conditions added under section 7. This requirement modifies the requirement in section 4 to “keep intact all notices”. c) You must license the entire work, as a whole, under this License to anyone who comes into possession of a copy. This License will therefore apply, along with any applicable section 7 additional terms, to the whole of the work, and all its parts, regardless of how they are packaged. This License gives no permission to license the work in any other way, but it does not invalidate such permission if you have separately received it. d) If the work has interactive user interfaces, each must display Appropriate Legal Notices; however, if the Program has interactive interfaces that do not display Appropriate Legal Notices, your work need not make them do so. A compilation of a covered work with other separate and independent works, which are not by their nature extensions of the covered work, and which are not combined with it such as to form a larger program, in or on a volume of a storage or distribution medium, is called an “aggregate” if the compilation and its resulting copyright are not used to limit the access or legal rights of the compilation's users beyond what the individual works permit. Inclusion of a covered work in an aggregate does not cause this License to apply to the other parts of the aggregate. 6. Conveying Non-Source Forms. You may convey a covered work in object code form under the terms of sections 4 and 5, provided that you also convey the machine-readable Corresponding Source under the terms of this License, in one of these ways: a) Convey the object code in, or embodied in, a physical product (including a physical distribution medium), accompanied by the Corresponding Source fixed on a durable physical medium customarily used for software interchange. b) Convey the object code in, or embodied in, a physical product (including a physical distribution medium), accompanied by a written offer, valid for at least three years and valid for as long as you offer spare parts or customer support for that product model, to give anyone who possesses the object code either (1) a copy of the Corresponding Source for all the software in the product that is covered by this License, on a durable physical medium customarily used for software interchange, for a price no more than your reasonable cost of physically performing this conveying of source, or (2) access to copy the Corresponding Source from a network server at no charge. c) Convey individual copies of the object code with a copy of the written offer to provide the Corresponding Source. This alternative is allowed only occasionally and noncommercially, and only if you received the object code with such an offer, in accord with subsection 6b. d) Convey the object code by offering access from a designated place (gratis or for a charge), and offer equivalent access to the Corresponding Source in the same way through the same place at no further charge. You need not require recipients to copy the Corresponding Source along with the object code. If the place to copy the object code is a network server, the Corresponding Source may be on a different server (operated by you or a third party) that supports equivalent copying facilities, provided you maintain clear directions next to the object code saying where to find the Corresponding Source. Regardless of what server hosts the Corresponding Source, you remain obligated to ensure that it is available for as long as needed to satisfy these requirements. e) Convey the object code using peer-to-peer transmission, provided you inform other peers where the object code and Corresponding Source of the work are being offered to the general public at no charge under subsection 6d. A separable portion of the object code, whose source code is excluded from the Corresponding Source as a System Library, need not be included in conveying the object code work. A “User Product” is either (1) a “consumer product”, which means any tangible personal property which is normally used for personal, family, or household purposes, or (2) anything designed or sold for incorporation into a dwelling. In determining whether a product is a consumer product, doubtful cases shall be resolved in favor of coverage. For a particular product received by a particular user, “normally used” refers to a typical or common use of that class of product, regardless of the status of the particular user or of the way in which the particular user actually uses, or expects or is expected to use, the product. A product is a consumer product regardless of whether the product has substantial commercial, industrial or non-consumer uses, unless such uses represent the only significant mode of use of the product. “Installation Information” for a User Product means any methods, procedures, authorization keys, or other information required to install and execute modified versions of a covered work in that User Product from a modified version of its Corresponding Source. The information must suffice to ensure that the continued functioning of the modified object code is in no case prevented or interfered with solely because modification has been made. If you convey an object code work under this section in, or with, or specifically for use in, a User Product, and the conveying occurs as part of a transaction in which the right of possession and use of the User Product is transferred to the recipient in perpetuity or for a fixed term (regardless of how the transaction is characterized), the Corresponding Source conveyed under this section must be accompanied by the Installation Information. But this requirement does not apply if neither you nor any third party retains the ability to install modified object code on the User Product (for example, the work has been installed in ROM). The requirement to provide Installation Information does not include a requirement to continue to provide support service, warranty, or updates for a work that has been modified or installed by the recipient, or for the User Product in which it has been modified or installed. Access to a network may be denied when the modification itself materially and adversely affects the operation of the network or violates the rules and protocols for communication across the network. Corresponding Source conveyed, and Installation Information provided, in accord with this section must be in a format that is publicly documented (and with an implementation available to the public in source code form), and must require no special password or key for unpacking, reading or copying. 7. Additional Terms. “Additional permissions” are terms that supplement the terms of this License by making exceptions from one or more of its conditions. Additional permissions that are applicable to the entire Program shall be treated as though they were included in this License, to the extent that they are valid under applicable law. If additional permissions apply only to part of the Program, that part may be used separately under those permissions, but the entire Program remains governed by this License without regard to the additional permissions. When you convey a copy of a covered work, you may at your option remove any additional permissions from that copy, or from any part of it. (Additional permissions may be written to require their own removal in certain cases when you modify the work.) You may place additional permissions on material, added by you to a covered work, for which you have or can give appropriate copyright permission. Notwithstanding any other provision of this License, for material you add to a covered work, you may (if authorized by the copyright holders of that material) supplement the terms of this License with terms: a) Disclaiming warranty or limiting liability differently from the terms of sections 15 and 16 of this License; or b) Requiring preservation of specified reasonable legal notices or author attributions in that material or in the Appropriate Legal Notices displayed by works containing it; or c) Prohibiting misrepresentation of the origin of that material, or requiring that modified versions of such material be marked in reasonable ways as different from the original version; or d) Limiting the use for publicity purposes of names of licensors or authors of the material; or e) Declining to grant rights under trademark law for use of some trade names, trademarks, or service marks; or f) Requiring indemnification of licensors and authors of that material by anyone who conveys the material (or modified versions of it) with contractual assumptions of liability to the recipient, for any liability that these contractual assumptions directly impose on those licensors and authors. All other non-permissive additional terms are considered “further restrictions” within the meaning of section 10. If the Program as you received it, or any part of it, contains a notice stating that it is governed by this License along with a term that is a further restriction, you may remove that term. If a license document contains a further restriction but permits relicensing or conveying under this License, you may add to a covered work material governed by the terms of that license document, provided that the further restriction does not survive such relicensing or conveying. If you add terms to a covered work in accord with this section, you must place, in the relevant source files, a statement of the additional terms that apply to those files, or a notice indicating where to find the applicable terms. Additional terms, permissive or non-permissive, may be stated in the form of a separately written license, or stated as exceptions; the above requirements apply either way. 8. Termination. You may not propagate or modify a covered work except as expressly provided under this License. Any attempt otherwise to propagate or modify it is void, and will automatically terminate your rights under this License (including any patent licenses granted under the third paragraph of section 11). However, if you cease all violation of this License, then your license from a particular copyright holder is reinstated (a) provisionally, unless and until the copyright holder explicitly and finally terminates your license, and (b) permanently, if the copyright holder fails to notify you of the violation by some reasonable means prior to 60 days after the cessation. Moreover, your license from a particular copyright holder is reinstated permanently if the copyright holder notifies you of the violation by some reasonable means, this is the first time you have received notice of violation of this License (for any work) from that copyright holder, and you cure the violation prior to 30 days after your receipt of the notice. Termination of your rights under this section does not terminate the licenses of parties who have received copies or rights from you under this License. If your rights have been terminated and not permanently reinstated, you do not qualify to receive new licenses for the same material under section 10. 9. Acceptance Not Required for Having Copies. You are not required to accept this License in order to receive or run a copy of the Program. Ancillary propagation of a covered work occurring solely as a consequence of using peer-to-peer transmission to receive a copy likewise does not require acceptance. However, nothing other than this License grants you permission to propagate or modify any covered work. These actions infringe copyright if you do not accept this License. Therefore, by modifying or propagating a covered work, you indicate your acceptance of this License to do so. 10. Automatic Licensing of Downstream Recipients. Each time you convey a covered work, the recipient automatically receives a license from the original licensors, to run, modify and propagate that work, subject to this License. You are not responsible for enforcing compliance by third parties with this License. An “entity transaction” is a transaction transferring control of an organization, or substantially all assets of one, or subdividing an organization, or merging organizations. If propagation of a covered work results from an entity transaction, each party to that transaction who receives a copy of the work also receives whatever licenses to the work the party's predecessor in interest had or could give under the previous paragraph, plus a right to possession of the Corresponding Source of the work from the predecessor in interest, if the predecessor has it or can get it with reasonable efforts. You may not impose any further restrictions on the exercise of the rights granted or affirmed under this License. For example, you may not impose a license fee, royalty, or other charge for exercise of rights granted under this License, and you may not initiate litigation (including a cross-claim or counterclaim in a lawsuit) alleging that any patent claim is infringed by making, using, selling, offering for sale, or importing the Program or any portion of it. 11. Patents. A “contributor” is a copyright holder who authorizes use under this License of the Program or a work on which the Program is based. The work thus licensed is called the contributor's “contributor version”. A contributor's “essential patent claims” are all patent claims owned or controlled by the contributor, whether already acquired or hereafter acquired, that would be infringed by some manner, permitted by this License, of making, using, or selling its contributor version, but do not include claims that would be infringed only as a consequence of further modification of the contributor version. For purposes of this definition, “control” includes the right to grant patent sublicenses in a manner consistent with the requirements of this License. Each contributor grants you a non-exclusive, worldwide, royalty-free patent license under the contributor's essential patent claims, to make, use, sell, offer for sale, import and otherwise run, modify and propagate the contents of its contributor version. In the following three paragraphs, a “patent license” is any express agreement or commitment, however denominated, not to enforce a patent (such as an express permission to practice a patent or covenant not to sue for patent infringement). To “grant” such a patent license to a party means to make such an agreement or commitment not to enforce a patent against the party. If you convey a covered work, knowingly relying on a patent license, and the Corresponding Source of the work is not available for anyone to copy, free of charge and under the terms of this License, through a publicly available network server or other readily accessible means, then you must either (1) cause the Corresponding Source to be so available, or (2) arrange to deprive yourself of the benefit of the patent license for this particular work, or (3) arrange, in a manner consistent with the requirements of this License, to extend the patent license to downstream recipients. “Knowingly relying” means you have actual knowledge that, but for the patent license, your conveying the covered work in a country, or your recipient's use of the covered work in a country, would infringe one or more identifiable patents in that country that you have reason to believe are valid. If, pursuant to or in connection with a single transaction or arrangement, you convey, or propagate by procuring conveyance of, a covered work, and grant a patent license to some of the parties receiving the covered work authorizing them to use, propagate, modify or convey a specific copy of the covered work, then the patent license you grant is automatically extended to all recipients of the covered work and works based on it. A patent license is “discriminatory” if it does not include within the scope of its coverage, prohibits the exercise of, or is conditioned on the non-exercise of one or more of the rights that are specifically granted under this License. You may not convey a covered work if you are a party to an arrangement with a third party that is in the business of distributing software, under which you make payment to the third party based on the extent of your activity of conveying the work, and under which the third party grants, to any of the parties who would receive the covered work from you, a discriminatory patent license (a) in connection with copies of the covered work conveyed by you (or copies made from those copies), or (b) primarily for and in connection with specific products or compilations that contain the covered work, unless you entered into that arrangement, or that patent license was granted, prior to 28 March 2007. Nothing in this License shall be construed as excluding or limiting any implied license or other defenses to infringement that may otherwise be available to you under applicable patent law. 12. No Surrender of Others' Freedom. If conditions are imposed on you (whether by court order, agreement or otherwise) that contradict the conditions of this License, they do not excuse you from the conditions of this License. If you cannot convey a covered work so as to satisfy simultaneously your obligations under this License and any other pertinent obligations, then as a consequence you may not convey it at all. For example, if you agree to terms that obligate you to collect a royalty for further conveying from those to whom you convey the Program, the only way you could satisfy both those terms and this License would be to refrain entirely from conveying the Program. 13. Use with the GNU Affero General Public License. Notwithstanding any other provision of this License, you have permission to link or combine any covered work with a work licensed under version 3 of the GNU Affero General Public License into a single combined work, and to convey the resulting work. The terms of this License will continue to apply to the part which is the covered work, but the special requirements of the GNU Affero General Public License, section 13, concerning interaction through a network will apply to the combination as such. 14. Revised Versions of this License. The Free Software Foundation may publish revised and/or new versions of the GNU General Public License from time to time. Such new versions will be similar in spirit to the present version, but may differ in detail to address new problems or concerns. Each version is given a distinguishing version number. If the Program specifies that a certain numbered version of the GNU General Public License “or any later version” applies to it, you have the option of following the terms and conditions either of that numbered version or of any later version published by the Free Software Foundation. If the Program does not specify a version number of the GNU General Public License, you may choose any version ever published by the Free Software Foundation. If the Program specifies that a proxy can decide which future versions of the GNU General Public License can be used, that proxy's public statement of acceptance of a version permanently authorizes you to choose that version for the Program. Later license versions may give you additional or different permissions. However, no additional obligations are imposed on any author or copyright holder as a result of your choosing to follow a later version. 15. Disclaimer of Warranty. THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM “AS IS” WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION. 16. Limitation of Liability. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. 17. Interpretation of Sections 15 and 16. If the disclaimer of warranty and limitation of liability provided above cannot be given local legal effect according to their terms, reviewing courts shall apply local law that most closely approximates an absolute waiver of all civil liability in connection with the Program, unless a warranty or assumption of liability accompanies a copy of the Program in return for a fee. END OF TERMS AND CONDITIONS How to Apply These Terms to Your New Programs If you develop a new program, and you want it to be of the greatest possible use to the public, the best way to achieve this is to make it free software which everyone can redistribute and change under these terms. To do so, attach the following notices to the program. It is safest to attach them to the start of each source file to most effectively state the exclusion of warranty; and each file should have at least the “copyright” line and a pointer to where the full notice is found. Copyright (C) This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see . Also add information on how to contact you by electronic and paper mail. If the program does terminal interaction, make it output a short notice like this when it starts in an interactive mode: Copyright (C) This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'. This is free software, and you are welcome to redistribute it under certain conditions; type `show c' for details. The hypothetical commands `show w' and `show c' should show the appropriate parts of the General Public License. Of course, your program's commands might be different; for a GUI interface, you would use an “about box”. You should also get your employer (if you work as a programmer) or school, if any, to sign a “copyright disclaimer” for the program, if necessary. For more information on this, and how to apply and follow the GNU GPL, see . The GNU General Public License does not permit incorporating your program into proprietary programs. If your program is a subroutine library, you may consider it more useful to permit linking proprietary applications with the library. If this is what you want to do, use the GNU Lesser General Public License instead of this License. But first, please read . ================================================ FILE: LICENSES/LGPL-3.0-only.txt ================================================ GNU LESSER GENERAL PUBLIC LICENSE Version 3, 29 June 2007 Copyright (C) 2007 Free Software Foundation, Inc. Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed. This version of the GNU Lesser General Public License incorporates the terms and conditions of version 3 of the GNU General Public License, supplemented by the additional permissions listed below. 0. Additional Definitions. As used herein, "this License" refers to version 3 of the GNU Lesser General Public License, and the "GNU GPL" refers to version 3 of the GNU General Public License. "The Library" refers to a covered work governed by this License, other than an Application or a Combined Work as defined below. An "Application" is any work that makes use of an interface provided by the Library, but which is not otherwise based on the Library. Defining a subclass of a class defined by the Library is deemed a mode of using an interface provided by the Library. A "Combined Work" is a work produced by combining or linking an Application with the Library. The particular version of the Library with which the Combined Work was made is also called the "Linked Version". The "Minimal Corresponding Source" for a Combined Work means the Corresponding Source for the Combined Work, excluding any source code for portions of the Combined Work that, considered in isolation, are based on the Application, and not on the Linked Version. The "Corresponding Application Code" for a Combined Work means the object code and/or source code for the Application, including any data and utility programs needed for reproducing the Combined Work from the Application, but excluding the System Libraries of the Combined Work. 1. Exception to Section 3 of the GNU GPL. You may convey a covered work under sections 3 and 4 of this License without being bound by section 3 of the GNU GPL. 2. Conveying Modified Versions. If you modify a copy of the Library, and, in your modifications, a facility refers to a function or data to be supplied by an Application that uses the facility (other than as an argument passed when the facility is invoked), then you may convey a copy of the modified version: a) under this License, provided that you make a good faith effort to ensure that, in the event an Application does not supply the function or data, the facility still operates, and performs whatever part of its purpose remains meaningful, or b) under the GNU GPL, with none of the additional permissions of this License applicable to that copy. 3. Object Code Incorporating Material from Library Header Files. The object code form of an Application may incorporate material from a header file that is part of the Library. You may convey such object code under terms of your choice, provided that, if the incorporated material is not limited to numerical parameters, data structure layouts and accessors, or small macros, inline functions and templates (ten or fewer lines in length), you do both of the following: a) Give prominent notice with each copy of the object code that the Library is used in it and that the Library and its use are covered by this License. b) Accompany the object code with a copy of the GNU GPL and this license document. 4. Combined Works. You may convey a Combined Work under terms of your choice that, taken together, effectively do not restrict modification of the portions of the Library contained in the Combined Work and reverse engineering for debugging such modifications, if you also do each of the following: a) Give prominent notice with each copy of the Combined Work that the Library is used in it and that the Library and its use are covered by this License. b) Accompany the Combined Work with a copy of the GNU GPL and this license document. c) For a Combined Work that displays copyright notices during execution, include the copyright notice for the Library among these notices, as well as a reference directing the user to the copies of the GNU GPL and this license document. d) Do one of the following: 0) Convey the Minimal Corresponding Source under the terms of this License, and the Corresponding Application Code in a form suitable for, and under terms that permit, the user to recombine or relink the Application with a modified version of the Linked Version to produce a modified Combined Work, in the manner specified by section 6 of the GNU GPL for conveying Corresponding Source. 1) Use a suitable shared library mechanism for linking with the Library. A suitable mechanism is one that (a) uses at run time a copy of the Library already present on the user's computer system, and (b) will operate properly with a modified version of the Library that is interface-compatible with the Linked Version. e) Provide Installation Information, but only if you would otherwise be required to provide such information under section 6 of the GNU GPL, and only to the extent that such information is necessary to install and execute a modified version of the Combined Work produced by recombining or relinking the Application with a modified version of the Linked Version. (If you use option 4d0, the Installation Information must accompany the Minimal Corresponding Source and Corresponding Application Code. If you use option 4d1, you must provide the Installation Information in the manner specified by section 6 of the GNU GPL for conveying Corresponding Source.) 5. Combined Libraries. You may place library facilities that are a work based on the Library side by side in a single library together with other library facilities that are not Applications and are not covered by this License, and convey such a combined library under terms of your choice, if you do both of the following: a) Accompany the combined library with a copy of the same work based on the Library, uncombined with any other library facilities, conveyed under the terms of this License. b) Give prominent notice with the combined library that part of it is a work based on the Library, and explaining where to find the accompanying uncombined form of the same work. 6. Revised Versions of the GNU Lesser General Public License. The Free Software Foundation may publish revised and/or new versions of the GNU Lesser General Public License from time to time. Such new versions will be similar in spirit to the present version, but may differ in detail to address new problems or concerns. Each version is given a distinguishing version number. If the Library as you received it specifies that a certain numbered version of the GNU Lesser General Public License "or any later version" applies to it, you have the option of following the terms and conditions either of that published version or of any later version published by the Free Software Foundation. If the Library as you received it does not specify a version number of the GNU Lesser General Public License, you may choose any version of the GNU Lesser General Public License ever published by the Free Software Foundation. If the Library as you received it specifies that a proxy can decide whether future versions of the GNU Lesser General Public License shall apply, that proxy's public statement of acceptance of any version is permanent authorization for you to choose that version for the Library. GNU GENERAL PUBLIC LICENSE Version 3, 29 June 2007 Copyright © 2007 Free Software Foundation, Inc. Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed. Preamble The GNU General Public License is a free, copyleft license for software and other kinds of works. The licenses for most software and other practical works are designed to take away your freedom to share and change the works. By contrast, the GNU General Public License is intended to guarantee your freedom to share and change all versions of a program--to make sure it remains free software for all its users. We, the Free Software Foundation, use the GNU General Public License for most of our software; it applies also to any other work released this way by its authors. You can apply it to your programs, too. When we speak of free software, we are referring to freedom, not price. Our General Public Licenses are designed to make sure that you have the freedom to distribute copies of free software (and charge for them if you wish), that you receive source code or can get it if you want it, that you can change the software or use pieces of it in new free programs, and that you know you can do these things. To protect your rights, we need to prevent others from denying you these rights or asking you to surrender the rights. Therefore, you have certain responsibilities if you distribute copies of the software, or if you modify it: responsibilities to respect the freedom of others. For example, if you distribute copies of such a program, whether gratis or for a fee, you must pass on to the recipients the same freedoms that you received. You must make sure that they, too, receive or can get the source code. And you must show them these terms so they know their rights. Developers that use the GNU GPL protect your rights with two steps: (1) assert copyright on the software, and (2) offer you this License giving you legal permission to copy, distribute and/or modify it. For the developers' and authors' protection, the GPL clearly explains that there is no warranty for this free software. For both users' and authors' sake, the GPL requires that modified versions be marked as changed, so that their problems will not be attributed erroneously to authors of previous versions. Some devices are designed to deny users access to install or run modified versions of the software inside them, although the manufacturer can do so. This is fundamentally incompatible with the aim of protecting users' freedom to change the software. The systematic pattern of such abuse occurs in the area of products for individuals to use, which is precisely where it is most unacceptable. Therefore, we have designed this version of the GPL to prohibit the practice for those products. If such problems arise substantially in other domains, we stand ready to extend this provision to those domains in future versions of the GPL, as needed to protect the freedom of users. Finally, every program is threatened constantly by software patents. States should not allow patents to restrict development and use of software on general-purpose computers, but in those that do, we wish to avoid the special danger that patents applied to a free program could make it effectively proprietary. To prevent this, the GPL assures that patents cannot be used to render the program non-free. The precise terms and conditions for copying, distribution and modification follow. TERMS AND CONDITIONS 0. Definitions. “This License” refers to version 3 of the GNU General Public License. “Copyright” also means copyright-like laws that apply to other kinds of works, such as semiconductor masks. “The Program” refers to any copyrightable work licensed under this License. Each licensee is addressed as “you”. “Licensees” and “recipients” may be individuals or organizations. To “modify” a work means to copy from or adapt all or part of the work in a fashion requiring copyright permission, other than the making of an exact copy. The resulting work is called a “modified version” of the earlier work or a work “based on” the earlier work. A “covered work” means either the unmodified Program or a work based on the Program. To “propagate” a work means to do anything with it that, without permission, would make you directly or secondarily liable for infringement under applicable copyright law, except executing it on a computer or modifying a private copy. Propagation includes copying, distribution (with or without modification), making available to the public, and in some countries other activities as well. To “convey” a work means any kind of propagation that enables other parties to make or receive copies. Mere interaction with a user through a computer network, with no transfer of a copy, is not conveying. An interactive user interface displays “Appropriate Legal Notices” to the extent that it includes a convenient and prominently visible feature that (1) displays an appropriate copyright notice, and (2) tells the user that there is no warranty for the work (except to the extent that warranties are provided), that licensees may convey the work under this License, and how to view a copy of this License. If the interface presents a list of user commands or options, such as a menu, a prominent item in the list meets this criterion. 1. Source Code. The “source code” for a work means the preferred form of the work for making modifications to it. “Object code” means any non-source form of a work. A “Standard Interface” means an interface that either is an official standard defined by a recognized standards body, or, in the case of interfaces specified for a particular programming language, one that is widely used among developers working in that language. The “System Libraries” of an executable work include anything, other than the work as a whole, that (a) is included in the normal form of packaging a Major Component, but which is not part of that Major Component, and (b) serves only to enable use of the work with that Major Component, or to implement a Standard Interface for which an implementation is available to the public in source code form. A “Major Component”, in this context, means a major essential component (kernel, window system, and so on) of the specific operating system (if any) on which the executable work runs, or a compiler used to produce the work, or an object code interpreter used to run it. The “Corresponding Source” for a work in object code form means all the source code needed to generate, install, and (for an executable work) run the object code and to modify the work, including scripts to control those activities. However, it does not include the work's System Libraries, or general-purpose tools or generally available free programs which are used unmodified in performing those activities but which are not part of the work. For example, Corresponding Source includes interface definition files associated with source files for the work, and the source code for shared libraries and dynamically linked subprograms that the work is specifically designed to require, such as by intimate data communication or control flow between those subprograms and other parts of the work. The Corresponding Source need not include anything that users can regenerate automatically from other parts of the Corresponding Source. The Corresponding Source for a work in source code form is that same work. 2. Basic Permissions. All rights granted under this License are granted for the term of copyright on the Program, and are irrevocable provided the stated conditions are met. This License explicitly affirms your unlimited permission to run the unmodified Program. The output from running a covered work is covered by this License only if the output, given its content, constitutes a covered work. This License acknowledges your rights of fair use or other equivalent, as provided by copyright law. You may make, run and propagate covered works that you do not convey, without conditions so long as your license otherwise remains in force. You may convey covered works to others for the sole purpose of having them make modifications exclusively for you, or provide you with facilities for running those works, provided that you comply with the terms of this License in conveying all material for which you do not control copyright. Those thus making or running the covered works for you must do so exclusively on your behalf, under your direction and control, on terms that prohibit them from making any copies of your copyrighted material outside their relationship with you. Conveying under any other circumstances is permitted solely under the conditions stated below. Sublicensing is not allowed; section 10 makes it unnecessary. 3. Protecting Users' Legal Rights From Anti-Circumvention Law. No covered work shall be deemed part of an effective technological measure under any applicable law fulfilling obligations under article 11 of the WIPO copyright treaty adopted on 20 December 1996, or similar laws prohibiting or restricting circumvention of such measures. When you convey a covered work, you waive any legal power to forbid circumvention of technological measures to the extent such circumvention is effected by exercising rights under this License with respect to the covered work, and you disclaim any intention to limit operation or modification of the work as a means of enforcing, against the work's users, your or third parties' legal rights to forbid circumvention of technological measures. 4. Conveying Verbatim Copies. You may convey verbatim copies of the Program's source code as you receive it, in any medium, provided that you conspicuously and appropriately publish on each copy an appropriate copyright notice; keep intact all notices stating that this License and any non-permissive terms added in accord with section 7 apply to the code; keep intact all notices of the absence of any warranty; and give all recipients a copy of this License along with the Program. You may charge any price or no price for each copy that you convey, and you may offer support or warranty protection for a fee. 5. Conveying Modified Source Versions. You may convey a work based on the Program, or the modifications to produce it from the Program, in the form of source code under the terms of section 4, provided that you also meet all of these conditions: a) The work must carry prominent notices stating that you modified it, and giving a relevant date. b) The work must carry prominent notices stating that it is released under this License and any conditions added under section 7. This requirement modifies the requirement in section 4 to “keep intact all notices”. c) You must license the entire work, as a whole, under this License to anyone who comes into possession of a copy. This License will therefore apply, along with any applicable section 7 additional terms, to the whole of the work, and all its parts, regardless of how they are packaged. This License gives no permission to license the work in any other way, but it does not invalidate such permission if you have separately received it. d) If the work has interactive user interfaces, each must display Appropriate Legal Notices; however, if the Program has interactive interfaces that do not display Appropriate Legal Notices, your work need not make them do so. A compilation of a covered work with other separate and independent works, which are not by their nature extensions of the covered work, and which are not combined with it such as to form a larger program, in or on a volume of a storage or distribution medium, is called an “aggregate” if the compilation and its resulting copyright are not used to limit the access or legal rights of the compilation's users beyond what the individual works permit. Inclusion of a covered work in an aggregate does not cause this License to apply to the other parts of the aggregate. 6. Conveying Non-Source Forms. You may convey a covered work in object code form under the terms of sections 4 and 5, provided that you also convey the machine-readable Corresponding Source under the terms of this License, in one of these ways: a) Convey the object code in, or embodied in, a physical product (including a physical distribution medium), accompanied by the Corresponding Source fixed on a durable physical medium customarily used for software interchange. b) Convey the object code in, or embodied in, a physical product (including a physical distribution medium), accompanied by a written offer, valid for at least three years and valid for as long as you offer spare parts or customer support for that product model, to give anyone who possesses the object code either (1) a copy of the Corresponding Source for all the software in the product that is covered by this License, on a durable physical medium customarily used for software interchange, for a price no more than your reasonable cost of physically performing this conveying of source, or (2) access to copy the Corresponding Source from a network server at no charge. c) Convey individual copies of the object code with a copy of the written offer to provide the Corresponding Source. This alternative is allowed only occasionally and noncommercially, and only if you received the object code with such an offer, in accord with subsection 6b. d) Convey the object code by offering access from a designated place (gratis or for a charge), and offer equivalent access to the Corresponding Source in the same way through the same place at no further charge. You need not require recipients to copy the Corresponding Source along with the object code. If the place to copy the object code is a network server, the Corresponding Source may be on a different server (operated by you or a third party) that supports equivalent copying facilities, provided you maintain clear directions next to the object code saying where to find the Corresponding Source. Regardless of what server hosts the Corresponding Source, you remain obligated to ensure that it is available for as long as needed to satisfy these requirements. e) Convey the object code using peer-to-peer transmission, provided you inform other peers where the object code and Corresponding Source of the work are being offered to the general public at no charge under subsection 6d. A separable portion of the object code, whose source code is excluded from the Corresponding Source as a System Library, need not be included in conveying the object code work. A “User Product” is either (1) a “consumer product”, which means any tangible personal property which is normally used for personal, family, or household purposes, or (2) anything designed or sold for incorporation into a dwelling. In determining whether a product is a consumer product, doubtful cases shall be resolved in favor of coverage. For a particular product received by a particular user, “normally used” refers to a typical or common use of that class of product, regardless of the status of the particular user or of the way in which the particular user actually uses, or expects or is expected to use, the product. A product is a consumer product regardless of whether the product has substantial commercial, industrial or non-consumer uses, unless such uses represent the only significant mode of use of the product. “Installation Information” for a User Product means any methods, procedures, authorization keys, or other information required to install and execute modified versions of a covered work in that User Product from a modified version of its Corresponding Source. The information must suffice to ensure that the continued functioning of the modified object code is in no case prevented or interfered with solely because modification has been made. If you convey an object code work under this section in, or with, or specifically for use in, a User Product, and the conveying occurs as part of a transaction in which the right of possession and use of the User Product is transferred to the recipient in perpetuity or for a fixed term (regardless of how the transaction is characterized), the Corresponding Source conveyed under this section must be accompanied by the Installation Information. But this requirement does not apply if neither you nor any third party retains the ability to install modified object code on the User Product (for example, the work has been installed in ROM). The requirement to provide Installation Information does not include a requirement to continue to provide support service, warranty, or updates for a work that has been modified or installed by the recipient, or for the User Product in which it has been modified or installed. Access to a network may be denied when the modification itself materially and adversely affects the operation of the network or violates the rules and protocols for communication across the network. Corresponding Source conveyed, and Installation Information provided, in accord with this section must be in a format that is publicly documented (and with an implementation available to the public in source code form), and must require no special password or key for unpacking, reading or copying. 7. Additional Terms. “Additional permissions” are terms that supplement the terms of this License by making exceptions from one or more of its conditions. Additional permissions that are applicable to the entire Program shall be treated as though they were included in this License, to the extent that they are valid under applicable law. If additional permissions apply only to part of the Program, that part may be used separately under those permissions, but the entire Program remains governed by this License without regard to the additional permissions. When you convey a copy of a covered work, you may at your option remove any additional permissions from that copy, or from any part of it. (Additional permissions may be written to require their own removal in certain cases when you modify the work.) You may place additional permissions on material, added by you to a covered work, for which you have or can give appropriate copyright permission. Notwithstanding any other provision of this License, for material you add to a covered work, you may (if authorized by the copyright holders of that material) supplement the terms of this License with terms: a) Disclaiming warranty or limiting liability differently from the terms of sections 15 and 16 of this License; or b) Requiring preservation of specified reasonable legal notices or author attributions in that material or in the Appropriate Legal Notices displayed by works containing it; or c) Prohibiting misrepresentation of the origin of that material, or requiring that modified versions of such material be marked in reasonable ways as different from the original version; or d) Limiting the use for publicity purposes of names of licensors or authors of the material; or e) Declining to grant rights under trademark law for use of some trade names, trademarks, or service marks; or f) Requiring indemnification of licensors and authors of that material by anyone who conveys the material (or modified versions of it) with contractual assumptions of liability to the recipient, for any liability that these contractual assumptions directly impose on those licensors and authors. All other non-permissive additional terms are considered “further restrictions” within the meaning of section 10. If the Program as you received it, or any part of it, contains a notice stating that it is governed by this License along with a term that is a further restriction, you may remove that term. If a license document contains a further restriction but permits relicensing or conveying under this License, you may add to a covered work material governed by the terms of that license document, provided that the further restriction does not survive such relicensing or conveying. If you add terms to a covered work in accord with this section, you must place, in the relevant source files, a statement of the additional terms that apply to those files, or a notice indicating where to find the applicable terms. Additional terms, permissive or non-permissive, may be stated in the form of a separately written license, or stated as exceptions; the above requirements apply either way. 8. Termination. You may not propagate or modify a covered work except as expressly provided under this License. Any attempt otherwise to propagate or modify it is void, and will automatically terminate your rights under this License (including any patent licenses granted under the third paragraph of section 11). However, if you cease all violation of this License, then your license from a particular copyright holder is reinstated (a) provisionally, unless and until the copyright holder explicitly and finally terminates your license, and (b) permanently, if the copyright holder fails to notify you of the violation by some reasonable means prior to 60 days after the cessation. Moreover, your license from a particular copyright holder is reinstated permanently if the copyright holder notifies you of the violation by some reasonable means, this is the first time you have received notice of violation of this License (for any work) from that copyright holder, and you cure the violation prior to 30 days after your receipt of the notice. Termination of your rights under this section does not terminate the licenses of parties who have received copies or rights from you under this License. If your rights have been terminated and not permanently reinstated, you do not qualify to receive new licenses for the same material under section 10. 9. Acceptance Not Required for Having Copies. You are not required to accept this License in order to receive or run a copy of the Program. Ancillary propagation of a covered work occurring solely as a consequence of using peer-to-peer transmission to receive a copy likewise does not require acceptance. However, nothing other than this License grants you permission to propagate or modify any covered work. These actions infringe copyright if you do not accept this License. Therefore, by modifying or propagating a covered work, you indicate your acceptance of this License to do so. 10. Automatic Licensing of Downstream Recipients. Each time you convey a covered work, the recipient automatically receives a license from the original licensors, to run, modify and propagate that work, subject to this License. You are not responsible for enforcing compliance by third parties with this License. An “entity transaction” is a transaction transferring control of an organization, or substantially all assets of one, or subdividing an organization, or merging organizations. If propagation of a covered work results from an entity transaction, each party to that transaction who receives a copy of the work also receives whatever licenses to the work the party's predecessor in interest had or could give under the previous paragraph, plus a right to possession of the Corresponding Source of the work from the predecessor in interest, if the predecessor has it or can get it with reasonable efforts. You may not impose any further restrictions on the exercise of the rights granted or affirmed under this License. For example, you may not impose a license fee, royalty, or other charge for exercise of rights granted under this License, and you may not initiate litigation (including a cross-claim or counterclaim in a lawsuit) alleging that any patent claim is infringed by making, using, selling, offering for sale, or importing the Program or any portion of it. 11. Patents. A “contributor” is a copyright holder who authorizes use under this License of the Program or a work on which the Program is based. The work thus licensed is called the contributor's “contributor version”. A contributor's “essential patent claims” are all patent claims owned or controlled by the contributor, whether already acquired or hereafter acquired, that would be infringed by some manner, permitted by this License, of making, using, or selling its contributor version, but do not include claims that would be infringed only as a consequence of further modification of the contributor version. For purposes of this definition, “control” includes the right to grant patent sublicenses in a manner consistent with the requirements of this License. Each contributor grants you a non-exclusive, worldwide, royalty-free patent license under the contributor's essential patent claims, to make, use, sell, offer for sale, import and otherwise run, modify and propagate the contents of its contributor version. In the following three paragraphs, a “patent license” is any express agreement or commitment, however denominated, not to enforce a patent (such as an express permission to practice a patent or covenant not to sue for patent infringement). To “grant” such a patent license to a party means to make such an agreement or commitment not to enforce a patent against the party. If you convey a covered work, knowingly relying on a patent license, and the Corresponding Source of the work is not available for anyone to copy, free of charge and under the terms of this License, through a publicly available network server or other readily accessible means, then you must either (1) cause the Corresponding Source to be so available, or (2) arrange to deprive yourself of the benefit of the patent license for this particular work, or (3) arrange, in a manner consistent with the requirements of this License, to extend the patent license to downstream recipients. “Knowingly relying” means you have actual knowledge that, but for the patent license, your conveying the covered work in a country, or your recipient's use of the covered work in a country, would infringe one or more identifiable patents in that country that you have reason to believe are valid. If, pursuant to or in connection with a single transaction or arrangement, you convey, or propagate by procuring conveyance of, a covered work, and grant a patent license to some of the parties receiving the covered work authorizing them to use, propagate, modify or convey a specific copy of the covered work, then the patent license you grant is automatically extended to all recipients of the covered work and works based on it. A patent license is “discriminatory” if it does not include within the scope of its coverage, prohibits the exercise of, or is conditioned on the non-exercise of one or more of the rights that are specifically granted under this License. You may not convey a covered work if you are a party to an arrangement with a third party that is in the business of distributing software, under which you make payment to the third party based on the extent of your activity of conveying the work, and under which the third party grants, to any of the parties who would receive the covered work from you, a discriminatory patent license (a) in connection with copies of the covered work conveyed by you (or copies made from those copies), or (b) primarily for and in connection with specific products or compilations that contain the covered work, unless you entered into that arrangement, or that patent license was granted, prior to 28 March 2007. Nothing in this License shall be construed as excluding or limiting any implied license or other defenses to infringement that may otherwise be available to you under applicable patent law. 12. No Surrender of Others' Freedom. If conditions are imposed on you (whether by court order, agreement or otherwise) that contradict the conditions of this License, they do not excuse you from the conditions of this License. If you cannot convey a covered work so as to satisfy simultaneously your obligations under this License and any other pertinent obligations, then as a consequence you may not convey it at all. For example, if you agree to terms that obligate you to collect a royalty for further conveying from those to whom you convey the Program, the only way you could satisfy both those terms and this License would be to refrain entirely from conveying the Program. 13. Use with the GNU Affero General Public License. Notwithstanding any other provision of this License, you have permission to link or combine any covered work with a work licensed under version 3 of the GNU Affero General Public License into a single combined work, and to convey the resulting work. The terms of this License will continue to apply to the part which is the covered work, but the special requirements of the GNU Affero General Public License, section 13, concerning interaction through a network will apply to the combination as such. 14. Revised Versions of this License. The Free Software Foundation may publish revised and/or new versions of the GNU General Public License from time to time. Such new versions will be similar in spirit to the present version, but may differ in detail to address new problems or concerns. Each version is given a distinguishing version number. If the Program specifies that a certain numbered version of the GNU General Public License “or any later version” applies to it, you have the option of following the terms and conditions either of that numbered version or of any later version published by the Free Software Foundation. If the Program does not specify a version number of the GNU General Public License, you may choose any version ever published by the Free Software Foundation. If the Program specifies that a proxy can decide which future versions of the GNU General Public License can be used, that proxy's public statement of acceptance of a version permanently authorizes you to choose that version for the Program. Later license versions may give you additional or different permissions. However, no additional obligations are imposed on any author or copyright holder as a result of your choosing to follow a later version. 15. Disclaimer of Warranty. THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM “AS IS” WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION. 16. Limitation of Liability. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. 17. Interpretation of Sections 15 and 16. If the disclaimer of warranty and limitation of liability provided above cannot be given local legal effect according to their terms, reviewing courts shall apply local law that most closely approximates an absolute waiver of all civil liability in connection with the Program, unless a warranty or assumption of liability accompanies a copy of the Program in return for a fee. END OF TERMS AND CONDITIONS How to Apply These Terms to Your New Programs If you develop a new program, and you want it to be of the greatest possible use to the public, the best way to achieve this is to make it free software which everyone can redistribute and change under these terms. To do so, attach the following notices to the program. It is safest to attach them to the start of each source file to most effectively state the exclusion of warranty; and each file should have at least the “copyright” line and a pointer to where the full notice is found. Copyright (C) This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see . Also add information on how to contact you by electronic and paper mail. If the program does terminal interaction, make it output a short notice like this when it starts in an interactive mode: Copyright (C) This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'. This is free software, and you are welcome to redistribute it under certain conditions; type `show c' for details. The hypothetical commands `show w' and `show c' should show the appropriate parts of the General Public License. Of course, your program's commands might be different; for a GUI interface, you would use an “about box”. You should also get your employer (if you work as a programmer) or school, if any, to sign a “copyright disclaimer” for the program, if necessary. For more information on this, and how to apply and follow the GNU GPL, see . The GNU General Public License does not permit incorporating your program into proprietary programs. If your program is a subroutine library, you may consider it more useful to permit linking proprietary applications with the library. If this is what you want to do, use the GNU Lesser General Public License instead of this License. But first, please read . ================================================ FILE: MANIFEST.in ================================================ include AUTHORS include CONTRIBUTING.md include COPYING include NEWS.rst include README.rst include README-pypi.rst include SECURITY.md include conf/glances.conf include conf/fetch-templates/*.jinja include requirements.txt include all-requirements.txt recursive-include docs * recursive-include glances *.py recursive-include glances/outputs/static * ================================================ FILE: Makefile ================================================ PORT ?= 8008 CONF := conf/glances.conf LASTTAG = $(shell git describe --tags --abbrev=0) IMAGES_TYPES := full minimal DISTROS := alpine ubuntu alpine_images := $(IMAGES_TYPES:%=docker-alpine-%) ubuntu_images := $(IMAGES_TYPES:%=docker-ubuntu-%) DOCKER_IMAGES := $(alpine_images) $(ubuntu_images) DOCKER_RUNTIMES := $(DOCKER_IMAGES:%=run-%) UNIT_TESTS := test-core test-restful test-xmlrpc DOCKER_BUILD := docker buildx build DOCKER_RUN := docker run PODMAN_SOCK ?= /run/user/$(shell id -u)/podman/podman.sock DOCKER_SOCK ?= /var/run/docker.sock DOCKER_SOCKS := -v $(PODMAN_SOCK):$(PODMAN_SOCK):ro -v $(DOCKER_SOCK):$(DOCKER_SOCK):ro DOCKER_OPTS := --rm -e TZ="${TZ}" -e GLANCES_OPT="" --pid host --network host UV_RUN := .venv-uv/bin/uv # if the command is only `make`, the default tasks will be the printing of the help. .DEFAULT_GOAL := help .PHONY: help test docs docs-server venv requirements profiling docker all clean all test help: ## List all make commands available @grep -E '^[\.a-zA-Z_%-]+:.*?## .*$$' $(MAKEFILE_LIST) | \ awk -F ":" '{print $1}' | \ grep -v % | sed 's/\\//g' | sort | \ awk 'BEGIN {FS = ":[^:]*?##"}; {printf "\033[1;34mmake %-50s\033[0m %s\n", $$1, $$2}' # =================================================================== # Virtualenv # =================================================================== # install-uv: ## Instructions to install the UV tool # @echo "Install the UV tool (https://astral.sh/uv/)" # @echo "Please install the UV tool manually" # @echo "For example with: curl -LsSf https://astral.sh/uv/install.sh | sh" # @echo "Or via a package manager of your distribution" # @echo "For example for Snap: snap install astral-uv" install-uv: ## Install UV tool in a specific virtualenv python3 -m venv .venv-uv .venv-uv/bin/pip install uv upgrade-uv: ## Upgrade the UV tool .venv-uv/bin/pip install --upgrade pip .venv-uv/bin/pip install --upgrade uv venv: ## Create the virtualenv with all dependencies $(UV_RUN) sync --all-extras --no-group dev venv-upgrade venv-switch-to-full: ## Upgrade the virtualenv with all dependencies $(UV_RUN) sync --upgrade --all-extras venv-min: ## Create the virtualenv with minimal dependencies $(UV_RUN) sync venv-upgrade-min venv-switch-to-min: ## Upgrade the virtualenv with minimal dependencies $(UV_RUN) sync --upgrade venv-clean: ## Remove the virtualenv rm -rf .venv venv-dev: ## Create the virtualenv with dev dependencies $(UV_RUN) sync --dev --all-extras $(UV_RUN) run pre-commit install --hook-type pre-commit # =================================================================== # Requirements # # Note: the --no-hashes option should be used because pip (in CI) has # issues with hashes. # =================================================================== requirements-min: ## Generate the requirements.txt files (minimal dependencies) $(UV_RUN) export --no-emit-workspace --no-hashes --no-group dev --output-file requirements.txt requirements-all: ## Generate the all-requirements.txt files (all dependencies) $(UV_RUN) export --no-emit-workspace --no-hashes --all-extras --no-group dev --output-file all-requirements.txt requirements-docker: ## Generate the docker-requirements.txt files (Docker specific dependencies) $(UV_RUN) export --no-emit-workspace --no-hashes --no-group dev --extra containers --extra web --extra mcp --output-file docker-requirements.txt requirements-dev: ## Generate the dev-requirements.txt files (dev dependencies) $(UV_RUN) export --no-hashes --only-dev --output-file dev-requirements.txt requirements: requirements-min requirements-all requirements-dev requirements-docker ## Generate all the requirements files requirements-upgrade: venv-upgrade requirements ## Upgrade the virtualenv and regenerate all the requirements files # =================================================================== # Tests # =================================================================== test: ## Run All unit tests $(UV_RUN) run pytest test-core: ## Run Core unit tests $(UV_RUN) run pytest tests/test_core.py test-plugins: ## Run Plugins unit tests $(UV_RUN) run pytest tests/test_plugin_*.py test-api: ## Run API unit tests $(UV_RUN) run pytest tests/test_api.py test-memoryleak: ## Run Memory-leak unit tests $(UV_RUN) run pytest tests/test_memoryleak.py test-perf: ## Run Perf unit tests $(UV_RUN) run pytest tests/test_perf.py test-restful: ## Run Restful API unit tests $(UV_RUN) run pytest tests/test_restful.py test-webui: ## Run WebUI unit tests $(UV_RUN) run pytest tests/test_webui.py test-xmlrpc: ## Run XMLRPC API unit tests $(UV_RUN) run pytest tests/test_xmlrpc.py test-with-upgrade: venv-upgrade test ## Upgrade deps and run unit tests test-export-csv: ## Run interface tests with CSV /bin/bash ./tests/test_export_csv.sh test-export-json: ## Run interface tests with JSON /bin/bash ./tests/test_export_json.sh test-export-influxdb-v1: ## Run interface tests with InfluxDB version 1 (Legacy) /bin/bash ./tests/test_export_influxdb_v1.sh test-export-influxdb-v3: ## Run interface tests with InfluxDB version 3 (Core) /bin/bash ./tests/test_export_influxdb_v3.sh test-export-timescaledb: ## Run interface tests with TimescaleDB /bin/bash ./tests/test_export_timescaledb.sh test-export-nats: ## Run interface tests with NATS /bin/bash ./tests/test_export_nats.sh test-exports: ## Tests all exports @for f in ./tests/test_export_*.sh; do /bin/bash "$$f"; done # =================================================================== # Linters, profilers and cyber security # =================================================================== pre-commit: ## Run pre-commit hooks $(UV_RUN) run pre-commit run --all-files find-duplicate-lines: ## Search for duplicate lines in files /bin/bash tests-data/tools/find-duplicate-lines.sh format: ## Format the code $(UV_RUN) run ruff format . lint: ## Lint the code. $(UV_RUN) run ruff check . --fix lint-readme: ## Lint the main README.rst file $(UV_RUN) run rstcheck README.rst $(UV_RUN) run rstcheck README-pypi.rst codespell: ## Run codespell to fix common misspellings in text files $(UV_RUN) run codespell -S .git,./docs/_build,./Glances.egg-info,./venv*,./glances/outputs,*.svg -L hart,bu,te,statics -w semgrep: ## Run semgrep to find bugs and enforce code standards $(UV_RUN) run semgrep scan --config=auto profiling-%: SLEEP = 3 profiling-%: TIMES = 30 profiling-%: OUT_DIR = docs/_static define DISPLAY-BANNER @echo "Start Glances for $(TIMES) iterations (more or less 1 mins, please do not exit !)" sleep $(SLEEP) endef profiling-gprof: CPROF = glances.cprof profiling-gprof: ## Callgraph profiling (need "apt install graphviz") $(DISPLAY-BANNER) $(UV_RUN) run python -m cProfile -o $(CPROF) run-venv.py -C $(CONF) --stop-after $(TIMES) $(UV_RUN) run gprof2dot -f pstats $(CPROF) | dot -Tsvg -o $(OUT_DIR)/glances-cgraph.svg rm -f $(CPROF) profiling-pyinstrument: ## PyInstrument profiling $(DISPLAY-BANNER) $(UV_RUN) add pyinstrument $(UV_RUN) run pyinstrument -r html -o $(OUT_DIR)/glances-pyinstrument.html -m glances -C $(CONF) --stop-after $(TIMES) profiling-pyspy: ## Flame profiling $(DISPLAY-BANNER) $(UV_RUN) run py-spy record -o $(OUT_DIR)/glances-flame.svg -d 60 -s -- .venv/bin/python -m glances -C $(CONF) --stop-after $(TIMES) profiling: profiling-gprof profiling-pyinstrument profiling-pyspy ## Profiling of the Glances software trace-malloc: ## Trace the malloc() calls @echo "Malloc test is running, please wait ~30 secondes..." $(UV_RUN) run python -m glances -C $(CONF) --trace-malloc --stop-after 15 --quiet memory-leak: ## Profile memory leaks $(UV_RUN) run python -m glances -C $(CONF) --memory-leak memory-profiling: TIMES = 2400 memory-profiling: PROFILE = mprofile_*.dat memory-profiling: OUT_DIR = docs/_static memory-profiling: ## Profile memory usage @echo "It's a very long test (~4 hours)..." rm -f $(PROFILE) @echo "1/2 - Start memory profiling with the history option enable" $(UV_RUN) run mprof run -T 1 -C run-venv.py -C $(CONF) --stop-after $(TIMES) --quiet $(UV_RUN) run mprof plot --output $(OUT_DIR)/glances-memory-profiling-with-history.png rm -f $(PROFILE) @echo "2/2 - Start memory profiling with the history option disable" $(UV_RUN) run mprof run -T 1 -C run-venv.py -C $(CONF) --disable-history --stop-after $(TIMES) --quiet $(UV_RUN) run mprof plot --output $(OUT_DIR)/glances-memory-profiling-without-history.png rm -f $(PROFILE) # Trivy installation: https://aquasecurity.github.io/trivy/latest/getting-started/installation/ trivy: ## Run Trivy to find vulnerabilities $(UV_RUN) run trivy fs ./glances/ bandit: ## Run Bandit to find vulnerabilities $(UV_RUN) run bandit glances -r # =================================================================== # Docs # =================================================================== docs: ## Create the documentation $(UV_RUN) run python -m glances -C $(CONF) --api-doc > ./docs/api/python.rst $(UV_RUN) run python ./generate_openapi.py $(UV_RUN) run python -m glances -C $(CONF) --api-restful-doc > ./docs/api/restful.rst cd docs && ./build.sh && cd .. docs-server: docs ## Start a Web server to serve the documentation (sleep 2 && sensible-browser "http://localhost:$(PORT)") & cd docs/_build/html/ && .venv-uv/bin/uvrun python -m http.server $(PORT) docs-jupyter: ## Start Jupyter Notebook $(UV_RUN) run --with jupyter jupyter lab release-note: ## Generate release note git --no-pager log $(LASTTAG)..HEAD --pretty=format:"* %s" @echo "\n" git --no-pager shortlog -s -n $(LASTTAG)..HEAD install: ## Open a Web Browser to the installation procedure sensible-browser "https://github.com/nicolargo/glances#installation" # =================================================================== # WebUI # Follow ./glances/outputs/static/README.md for more information # =================================================================== webui webui%: DIR = glances/outputs/static/ webui-gen-config: ## Generate the Web UI config file $(UV_RUN) run python ./generate_webui_conf.py > ./glances/outputs/static/js/uiconfig.json webui: webui-gen-config ## Build the Web UI cd $(DIR) && npm ci && npm run build webui-audit: ## Audit the Web UI cd $(DIR) && npm audit webui-audit-fix: webui-gen-config ## Fix audit the Web UI cd $(DIR) && npm ci && npm audit fix && npm run build webui-update: webui-gen-config ## Update JS dependencies cd $(DIR) && npm update --save && npm ci && npm run build # =================================================================== # Packaging # =================================================================== flatpak: venv-upgrade ## Generate FlatPack JSON file git clone https://github.com/flatpak/flatpak-builder-tools.git $(UV_RUN) run python ./flatpak-builder-tools/pip/flatpak-pip-generator glances rm -rf ./flatpak-builder-tools @echo "Now follow: https://github.com/flathub/flathub/wiki/App-Submission" # Snap package is automatically build on the Snapcraft.io platform # https://snapcraft.io/glances # But you can try an offline build with the following command snapcraft: snapcraft # =================================================================== # Docker # Need Docker Buildx package (apt install docker-buildx on Ubuntu) # =================================================================== define MAKE_DOCKER_BUILD_RULES $($(DISTRO)_images): docker-$(DISTRO)-%: docker-files/$(DISTRO).Dockerfile $(DOCKER_BUILD) --target $$* -f $$< -t glances:local-$(DISTRO)-$$* . endef $(foreach DISTRO,$(DISTROS),$(eval $(MAKE_DOCKER_BUILD_RULES))) docker: docker-alpine docker-ubuntu ## Generate local docker images docker-alpine: $(alpine_images) ## Generate local docker images (Alpine) docker-ubuntu: $(ubuntu_images) ## Generate local docker images (Ubuntu) docker-alpine-full: ## Generate local docker image (Alpine full) docker-alpine-minimal: ## Generate local docker image (Alpine minimal) docker-alpine-dev: ## Generate local docker image (Alpine dev) docker-ubuntu-full: ## Generate local docker image (Ubuntu full) docker-ubuntu-minimal: ## Generate local docker image (Ubuntu minimal) docker-ubuntu-dev: ## Generate local docker image (Ubuntu dev) trivy-docker: ## Run Trivy to find vulnerabilities in Docker images $(UV_RUN) run trivy image glances:local-alpine-full $(UV_RUN) run trivy image glances:local-alpine-minimal $(UV_RUN) run trivy image glances:local-ubuntu-full $(UV_RUN) run trivy image glances:local-ubuntu-minimal # =================================================================== # Run # =================================================================== run: ## Start Glances in console mode (also called standalone) $(UV_RUN) run python -m glances -C $(CONF) run-debug: ## Start Glances in debug console mode (also called standalone) $(UV_RUN) run python -m glances -C $(CONF) -d run-local-conf: ## Start Glances in console mode with the system conf file $(UV_RUN) run python -m glances run-local-conf-hide-public: ## Start Glances in console mode with the system conf file and hide public information $(UV_RUN) run python -m glances --hide-public-info run-like-htop: ## Start Glances with the same features than Htop $(UV_RUN) run python -m glances --disable-plugin network,ports,wifi,connections,diskio,fs,irq,folders,raid,smart,sensors,vms,containers,ip,amps --disable-left-sidebar run-fetch: ## Start Glances in fetch mode $(UV_RUN) run python -m glances --fetch $(DOCKER_RUNTIMES): run-docker-%: $(DOCKER_RUN) $(DOCKER_OPTS) $(DOCKER_SOCKS) -it glances:local-$* run-docker-alpine-minimal: ## Start Glances Alpine Docker minimal in console mode run-docker-alpine-full: ## Start Glances Alpine Docker full in console mode run-docker-alpine-dev: ## Start Glances Alpine Docker dev in console mode run-docker-ubuntu-minimal: ## Start Glances Ubuntu Docker minimal in console mode run-docker-ubuntu-full: ## Start Glances Ubuntu Docker full in console mode run-docker-ubuntu-dev: ## Start Glances Ubuntu Docker dev in console mode generate-ssl: ## Generate local and sel signed SSL certificates for dev (need mkcert) mkcert glances.local localhost 120.0.0.1 0.0.0.0 run-webserver: ## Start Glances in Web server mode $(UV_RUN) run python -m glances -C $(CONF) -w run-webserver-mcp: ## Start Glances in Web server mode with MCP $(UV_RUN) run python -m glances -C $(CONF) -w --enable-mcp run-webserver-local-conf: ## Start Glances in Web server mode with the system conf file $(UV_RUN) run python -m glances -w run-webserver-mcp-local-conf: ## Start Glances in Web server mode with MCP and the system conf file $(UV_RUN) run python -m glances -w --enable-mcp run-webserver-local-conf-hide-public: ## Start Glances in Web server mode with the system conf file and hide public info $(UV_RUN) run python -m glances -w --hide-public-info run-webui: run-webserver ## Start Glances in Web server mode run-restapiserver: ## Start Glances in REST API server mode $(UV_RUN) run python -m glances -C $(CONF) -w --disable-webui run-server: ## Start Glances in server mode (RPC) $(UV_RUN) run python -m glances -C $(CONF) -s run-client: ## Start Glances in client mode (RPC) $(UV_RUN) run python -m glances -C $(CONF) -c localhost run-browser: ## Start Glances in browser mode (RPC) $(UV_RUN) run python -m glances -C $(CONF) --browser run-web-browser: ## Start Web Central Browser $(UV_RUN) run python -m glances -C $(CONF) -w --browser run-issue: ## Start Glances in issue mode $(UV_RUN) run python -m glances -C $(CONF) --issue run-multipass: ## Install and start Glances in a VM (only available on Ubuntu with multipass already installed) multipass launch -n glances-on-lts lts multipass exec glances-on-lts -- sudo snap install glances multipass exec glances-on-lts -- glances multipass stop glances-on-lts multipass delete glances-on-lts show-version: ## Show Glances version number $(UV_RUN) run python -m glances -C $(CONF) -V ================================================ FILE: NEWS.rst ================================================ ============================================================================== Glances ChangeLog ============================================================================== ============= Version 4.5.2 ============= Bug corrected: * System display error on "little" terminal #3469 Security patches: * Default CORS Configuration Allows Cross-Origin Credential Theft - Correct CVE-2026-32610 * Incomplete Secrets Redaction: /api/v4/args Endpoint Leaks Password Hash and SNMP Credentials - Correct CVE-2026-32609 * REST/WebUI Lacks Host Validation and Remains Exposed to DNS Rebinding - Correct CVE-2026-32632 * Unauthenticated API Exposure / Add warning message on startup - Correct CVE-2026-32596 * SQL Injection in DuckDB Export via Unparameterized DDL Statements - Correct CVE-2026-32611 * Command Injection via Process Names in Action Command Templates - Correct CVE-2026-32608 * Central Browser Autodiscovery Leaks Reusable Credentials to Zeroconf-Spoofed Servers - Correct CVE-2026-32634 * Browser API Exposes Reusable Downstream Credentials via - Correct CVE-2026-32633 Breaking changes: This release addresses 8 security vulnerabilities (see below). Several of the mitigations change observable behaviour. Users who run Glances in web server or API mode (``-w`` / ``--enable-webserver``) should read the items below before upgrading. * [CVE-2026-32632] Host header validation is now enforced on the built-in web server. Requests whose ``Host`` header does not match ``localhost`` or ``127.0.0.1`` will be rejected with HTTP 400 by default. Users accessing Glances through a reverse proxy, a custom hostname, or a non-loopback IP address must declare the allowed values with the new ``allowed_hosts`` key in the ``[outputs]`` section of ``glances.conf`` (comma-separated list). This was already required for the MCP server since 4.5.1; it now also applies to the main REST/WebUI server. * [CVE-2026-32610] The default CORS policy is now restrictive. Previously, the server replied with ``Access-Control-Allow-Origin: *`` which allowed any web page to issue credentialed cross-origin requests against the API. The wildcard is removed. Users running third-party web dashboards or custom front-ends on a different origin must explicitly list allowed origins with the ``cors_origins`` key in the ``[outputs]`` section of ``glances.conf``. * [CVE-2026-32609] Sensitive fields are now redacted on unauthenticated API responses. The ``/api/4/args`` and ``/api/4/config`` endpoints no longer return password hashes, SSL key paths, or SNMP community strings to callers that have not authenticated. Scripts and integrations that relied on reading these values from the API must now authenticate (token or password) to receive them. * [CVE-2026-32633, CVE-2026-32634] The Browser (multi-server mode) no longer forwards configured credentials to remote Glances servers, whether discovered via Zeroconf or listed in the ``[serverlist]`` section. Credentials are only sent after the user explicitly logs in to an individual server. Automated setups that relied on transparent credential propagation must switch to per-server authentication. * [CVE-2026-32596] A WARNING is now printed to stdout at startup when the REST API is running without authentication (no ``--password`` and no API token configured). This is an informational message; the unauthenticated mode itself is unchanged and remains the default for private-network deployments. Startup scripts or monitoring pipelines that treat any stderr/stdout output as a failure may need to be updated. * [CVE-2026-32611] The DuckDB export module now uses parameterized DDL statements. Table names derived from plugin or metric names are sanitized before use. Existing DuckDB databases whose table names contained characters that were previously interpolated verbatim may need to be recreated. * [CVE-2026-32608] Process names used in ``[action]`` command templates are now shell-escaped before substitution. Templates that relied on unescaped special characters in process names to construct compound shell expressions will no longer behave as before. Thanks to @psyberck for the UI patch and @DhiyaneshGeek / @restriction for CVEs reports. ============= Version 4.5.1 ============= Bug corrected: * DiskIO plugin crashes Glances on OpenBSD (regression from 4.5.0.5) #3452 * DiskIO plugin does not handle empty args in msg_curse() #3429 * Filesystem plugin KeyError on /etc/hostname in get_view() #3470 * Sensors show/hide by alias name not working #3439 * SMART plugin non-uniform key types cause TypeError with InfluxDB2 export #3449 * WebUI displays incorrect temperature values in Fahrenheit mode #3450 * AMD GPU plugin PermissionError on /usr/share/libdrm/amdgpu.ids crashes Glances at startup (Snap) #3456 * NVIDIA GPU not detected under Snap strict confinement #3292 * MCP server rejects external host connections due to DNS rebinding protection #3467 * --enable-history flag silently ignored #3416 Enhancements: * Intel GPU monitoring support added to GPU plugin #994 * Docker container health status and alerts #3402 * Add libvirt client to Docker image for VM monitoring #3436 * Add DeviceName key to SMART plugin device stats #3457 * All plugins now expose min/max/mean statistics since startup #3462 * Improved CPU plugin display on macOS (graceful handling of unavailable fields) #3464 Security patches: * Unauthenticated Configuration Secrets Exposure - Correct CVE-2026-30928 * SQL Injection via Process Names in TimescaleDB Export - Correct CVE-2026-30930 Code quality: * JSON serializer hardened with comprehensive type normalization #3454 * Reduce cyclomatic complexity of split_esc() in globals #3461 * Add plugin tests to Makefile #3446 * Fix code block formatting in documentation #3447 Thanks to all the contributors for this version: @YamiYukiSenpai, @amzon-ex, @axodentally, @fpusan, @janusn, @kleinmatic, @lcheylus, @lubomir-moric, @mark-rahal, @mikemhenry, @Ambika-Patidar, @AbdelhamidKhald, @Julietmgbole, @sdoshi2061, @cjlindem, @theamanrawat =============== Version 4.5.0.5 =============== Bugs corrected: * Regression in the process selection with Glances 4.5.0 #3444 * [Docker image] Basic Auth no longer works in browser after adding Bearer token support #3434 * Error fetching ip with urlopen_auth() - extra function argument #3438 =============== Version 4.5.0.4 =============== Continious integration: * Remove cassandra-driver dependency because it breaks build on Docker Alpine image =============== Version 4.5.0.2 =============== Bugs corrected: * NPU plugin makes Glances 4.5.0.1 crashing on start #3425 * Glances 4.5.0.1 not reporting docker container details #3426 =============== Version 4.5.0.1 =============== Bugs corrected: * Docker image for Glances release 4.5.0 failed to start if no [outputs] section in the glances.conf file #3424 ============= Version 4.5.0 ============= Enhancements: * NPU Monitoring #2694 * Implement API Token for the ResfulAPI server #1995 * ZFS Monitoring #873 * NVME support #3355 * Add export to DuckDB database #3205 * Add CPU core number field to processlist #3411 * Add support for escape ':' in alias name #3345 Bugs corrected: * CPU Speed / Max Speed wrong in WebUI #3134 * TIME+ in Web UI Shows Incorrect Large Values #3401 * ERROR: Exception in ASGI application KeyErro used #3409 * InfluxDB Exports for AMPs can mismatch types for result field #3419 * Fix quicklook in case psutil.cpu_freq().max=0.0 #3379 * Get amdgpu name from amdgpu.id #3376 * Fetch option is not compliant with client/server mode #3352 * Glances won't start when using snmp discovery with parameter -c #3354 * Avoid empty space when Quicklook plugin is displayed #3413 Continious integration and documentation: * Reduce code complexity #2801 * Docker GPU not showing up #3393 * Potential fix for code scanning alert no. 47: Clear-text logging of sensitive information #3418 * Test: Add comprehensive unit tests for core plugins #3422 * README: Syntax fix (missing space) #3420 * fix(security): resolve B701 (Jinja2) and B113 (timeout) vulnerabilities #3383 * Update license specification to SPDX format #3381 * Make a simple Jupyter notebook for the Glances API #3350 * Improve Docker build pipeline #3336 Thanks to all contributors and bug reporters ! Special thanks to: - ffleischer - drake7707 - Ambika-Patidar ============= Version 4.4.1 ============= Bug corrected: * Restful API issue after a while (stats are no more updated) #3333 ============= Version 4.4.0 ============= Breaking changes: * A new Python API is now available to use Glances as a Python lib in your hown development #3237 * In the process list, the long command line is now truncated by default. Use the arrow keys to show the full command line. SHIFT + arrow keys are used to switch between column sorts (TUI). * Prometheus export format is now more user friendly (see detail in #3283) Enhancements: * Make a Glances API in order to use Glances as a Python lib #3237 * Add a new --fetch (neofetch like) option to display a snapshot of the current system status #3281 * Show used port in container section #2054 * Show long command line with arrow key #1553 * Sensors plugin refresh by default every 10 seconds * Do not call update if a call is done to a specific plugin through the API #3033 * [UI] Process virtual memory display can be disable by configuration #3299 * Choose between used or available in the mem plugin #3288 * [Experimental] Add export to DuckDB database #3205 * Add Disk I/O Latency stats #1070 * Filter fields to export #3258 * Remove .keys() from loops over dicts #3253 * Remove iterator helpers #3252 Bug corrected: * [MACOS] Glances not showing Processes on MacOS #3100 * Last dev build broke Homepage API calls ? only 1 widget still working #3322 * Cloud plugin always generate communication with 169.254.169.254, even if the plugin is disabled #3316 * API response delay (3+ minutes) when VMs are running #3317 * [WINDOWS] Glances do not display CPU stat correctly #3155 * Glances hangs if network device (NFS) is no available #3290 * Fix prometheus export format #3283 * Issue #3279 zfs cache and memory math issues #3289 * [MACOS] Glances crashes when I try to filter #3266 * Glances hang when killing process with muliple CTRL-C #3264 * Issues after disabling system and processcount plugins #3248 * Headers missing from predefined fields in TUI browser machine list #3250 * Add another check for the famous Netifaces issue - Related to #3219 * Key error 'type' in server_list_static.py (load_server_list) #3247 Continious integration and documentation: * Glances now use uv for the dev environment #3025 * Glances is compatible with Python 3.14 #3319 * Glances provides requirements files with specific versions for each release * Requirements files are now generated dynamically with the make requirements or requirements-upgrade target * Add duplicate line check in pre-commit (strange behavor with some VScode extension) * Solve issue with multiprocessing exception with Snap package * Add a test script for identify CPU consumption of sensor plugin * Refactor port to take into account netifaces2 * Correct issue with Chrome driver in WebUI unit test * Upgrade export test with InfluxDB 1.12 * Fix typo of --export-process-filter help message #3314 * In the outdated feature, catch error message if Pypi server not reachable * Add unit test for auto_unit * Label error in docs #3286 * Put WebUI conf generator in a dedicated script * Refactor the Makefile to generate WebUI config file for all webui targets * Update sensors documentation #3275 * Update docker compose env quote #3273 * Update docker-compose.yml #3249 * Update API doc generation * Update README with nice icons #3236 * Add documentation for WebUI test Thanks to all contributors and bug reporters ! Special thanks to: - Adi - Bennett Kanuka - Tim Potter - Ariel Otilibili - Boris Okassa - Lawrence - Shohei YOSHIDA - jmwallach - korn3r ============= Version 4.3.3 ============= Bug corrected: * Something in 4.3.2 broke the home assistant add-on for Glances #3238 Thanks to the FastAPI and Home Assistant community for the support. ============= Version 4.3.2 ============= Enhancements: * Add stats about running VMS (qemu/libvirt/kvm support through virsh) #1531 * Add support for InfluxDB 3 Core #3182 * (postgre)SQL export support / TimeScaleDB #2814 * CSV column name now include the plugin name - Related to #2394 * Make all results from amps plugins exportable #2394 * Make --stdout (csv and json) compliant with client/server mode #3235 * API history endpoints shows times without timezone #3218 * FR: Sort Sensors my name in proper number order #3132 * In the FS module, do not display threshold for volume mounted in 'ro' (read-only) #3143 * Add a new field in the process list to identifie Zombie process #3178 * Update plugin containers display and order #3186 * Implement a basic memory cache with TTL for API call (set to ~1 second) #3202 * Add container inactive_file & limit to InfluxDB2 export #3206 Bug corrected: * [GPU] AMD Plugin: Operation not permitted #3125 * Container memory stats not displayed #3142 * [WEBUI] Irix mode (per core instead of per CPU percentage) not togglable #3158 * Related to iteritems, itervalues, and iterkeys are not more needed in Python 3 #3181 * Glances Central Browser should use name instead of IP adress for redirection #3103 * Glances breaks if Podman container is started while it is running #3199 Continious integration and documentation: * Add a new option --print-completion to generate shell tab completion - #3111 * Improve Restful API documentation embeded in FastAPI #2632 * Upgrade JS libs #3147 * Improve unittest for CSV export #3150 * Improve unittest for InfluxDB plugin #3149 * Code refactoring - Rename plugin class to Plugin instead of PluginModel #3169 * Refactor code to limit the complexity of update_views method in plugins #3171 Thanks to all contributors and bug reporters ! Special thanks to: - Ariel Otilibili - kenrmayfield ============= Version 4.3.1 ============= Enhancements: * [WebUI] Top processes extended stats and processes filter in Web server mode #410 * I'd like a feature to make the forground color for colored background white #3119 * -disable-bg in ~/.config/glances.conf #3113 * Entry point in the API to get extended process stats #3095 * Replace netifaces by netifaces-plus dependencies #3053 * Replace docker by containers in glances-grafana-flux.json #3118 Bug corrected: * default_config_dir: Fix config path to include glances/ directory #3106 * Cannot set warning/critical temperature for a specific sensor needs test #3102 * Try to reduce latency between stat's update and view - #3086 * Error on Cloud plugin initialisation make TUI crash #3085 Continious integration: * Add Selenium to test WebUI #3044 Thanks to all contributors and bug reporters ! Special thanks to: - Alexander Kuznetsov - Jonathan Chemla - mizulike =============== Version 4.3.0.8 =============== Bug corrected: * IP plugin broken with Netifaces2 #3076 * WebUI if is notresponsive on mobile #3059 (second run) =============== Version 4.3.0.7 =============== Bug corrected: * WebUI if is notresponsive on mobile #3059 =============== Version 4.3.0.6 =============== Bug corrected: * Browser mode do not working with the sensors plugin #3069 * netifaces is deprecated, use netifaces-plus or netifaces2 #3055 Continuous integration and documentation: * Update alpine Docker tag to v3.21 #3061 =============== Version 4.3.0.5 =============== Bug corrected: * WebUI errors in 4.3.0.4 on iPad Air (and Browser with low resolution) #3057 =============== Version 4.3.0.4 =============== Continuous integration and documentation: * Pin Python version in Ubuntu image to 3.12 =============== Version 4.3.0.3 =============== Continuous integration and documentation: * Pin Alpine image to 3.20 (3.21 is not compliant with Netifaces) Related to #3053 =============== Version 4.3.0.2 =============== Enhancements: * Revert "Replace netifaces by netifaces-plus" #3053 because it break build on Alpine Image =============== Version 4.3.0.1 =============== Enhancements: * Replace netifaces by netifaces-plus #3053 Bug corrected: * CONTAINERS section missing in 4.3.0 WebUI #3052 =============== Version 4.3.0 =============== Enhancements: * Web Based Glances Central Browser #1121 * Ability to specify hide or show for smart plugin #2996 * Thread mode ('j' hotkey) is not taken into accound in the WebUI #3019 * [WEBUI] Clear old alert messages in the WebUI #3042 * Raise an (Alert) Event for a group of sensors #3049 * Allow processlist columns to be selected in config file #1524 * Allow containers columns to be selected in config file #2722 * [WebUI] Unecessary space between Processcount and processlist #3032 * Add comparable NVML_LIB check for Windows #3000 * Change the default path for graph export to /tmp/glances * Improve CCS of WebUI #3024 Bug corrected: * Thresholds not displayed in the WebUI for the DiskIO plugin #1498 * FS module alias configuration do not taken into account everytime #3010 * Unexpected behaviour while running glances in docker with --export influxdb2 #2904 * Correct issue when key name contains space - Related to #2983 * Issue with ports plugin (for URL request) #3008 * Network problem when no bitrate available #3014 * SyntaxError: f-string: unmatched '[' in server list (on the DEVELOP branch only) #3018 * Uptime for Docker containers not working #3021 * WebUI doesn't display valid time for process list #2902 * Bug In the Web-UI, Timestamps for 'Warning or critical alerts' are showing incorrect month #3023 * Correct display issue on Containers plugin in WebUI #3028 Continuous integration and documentation: * Bumped minimal Python version to 3.9 #3005 * Make the glances/outputs/static/js/uiconfig.json generated automaticaly from the make webui task * Update unit-test for Glances Central Browser * Add unit-test for new entry point in the API (plugin/item/key) * Add a target to start Glances with Htop features * Try new build and publish to Pypi CI actions Thanks to all contributors and bug reporters ! Special thanks to: * Ariel Otilibili for code quality improvements #2801 =============== Version 4.2.1 =============== Enhancements: * [WEBUI] Came back to default Black Theme / Reduce font size #2993 * Improve hide_zero option #2958 Bug corrected: * Possible memory leak #2976 * Docker/Podman shoud not flood log file with ERROR if containers list can not be retreived #2994 * Using "-w" option gives error: NameError: name 'Any' is not defined #2992 * Non blocking error message when Glances starts from a container (alpine-dev image) #2991 Continuous integration and documentation: * Migrate from setup.py to pyproject.yml #2956 * Make pyproject.toml's version dynamic #2990 Thanks to all contributors and bug reporters ! Special thanks to: * @branchvincent for pyproject migration =============== Version 4.2.0 =============== Enhancements: * [WEBUI] Migration to bootstrap 5 #2914 * New Ubuntu Multipass VM orchestartor plugin #2252 * Show only active Disk I/O (and network interface) #2929 * Make the central client UI configurable (example: GPU status) #1289 * Please make py-orjson optional: it pulls in dependency on Rust #2930 * Use defusedxml lib #2979 * Do not display Unknown information in the cloud plugin #2485 * Filter Docker containers - #2962 * Add retain to availability topic in MQTT plugin #2974 * Make fields labelled in Green easier to see #2882 Bug corrected: * In TUI, when processes are filtered, column are not aligned #2980 * Can't kill process. Standalone, Ubuntu 24.04 #2942 * Internal Server Error #2943 * Timezone for warning/errors is incorrect #2901 * Error while initializing the containers plugin ('type' object is not subscriptable) #2922 * url_prefix do not work in Glances < 4.2.0 - Correct issue with mount #2912 * Raid plugin breaks with inactive raid0 arrays #2908 * Crash when terminal is resized #2872 * Check if server name is not null in the Glances browser - Related to #2861 * Only display VMs with a running status (in the Vms plugin) Continuous integration and documentation: * Incomplete pipx install to allow webui + containers #2955 * Stick FastAPI version to 0.82.0 or higher (latest is better) - Related to #2926 * api/4/vms returns a dict, thus breaking make test-restful #2918 * Migration to Alpine 3.20 and Python 3.12 for Alpine Docker Improve code quality (thanks to Ariel Otilibili !): * Merge pull request #2959 from ariel-anieli/plugins-port-alerts * Merge pull request #2957 from ariel-anieli/plugin-port-msg * Merge pull request #2954 from ariel-anieli/makefile * Merge pull request #2941 from ariel-anieli/refactor-alert * Merge pull request #2950 from ariel-anieli/revert-commit-01823df9 * Merge pull request #2932 from ariel-anieli/refactorize-display-plugin * Merge pull request #2924 from ariel-anieli/makefile * Merge pull request #2919 from ariel-anieli/refactor-plugin-model-msg-curse * Merge pull request #2917 from ariel-anieli/makefile * Merge pull request #2915 from ariel-anieli/refactor-process-thread * Merge pull request #2913 from ariel-anieli/makefile * Merge pull request #2910 from ariel-anieli/makefile * Merge pull request #2900 from ariel-anieli/issue-2801-catch-key * Merge pull request #2907 from ariel-anieli/refactorize-makefile * Merge pull request #2891 from ariel-anieli/issue-2801-plugin-msg-curse * Merge pull request #2884 from ariel-anieli/issue-2801-plugin-update Thanks to all contributors and bug reporters ! Special thanks to: * Ariel Otilibili, he has made an incredible work to improve Glances code quality ! * RazCrimson, thanks for all your contributions ! * Bharath Vignesh J K * Neveda * ey-jo =============== Version 4.1.2 =============== Bug corrected: * AttributeError: 'CpuPercent' object has no attribute 'cpu_percent' #2859 =============== Version 4.1.1 =============== Bug corrected: * Sensors data is not exported using InfluxDB2 exporter #2856 =============== Version 4.1.0 =============== Enhancements: * Call process_iter.clear_cache() (PsUtil 6+) when Glances user force a refresh (F5 or CTRL-R) #2753 * PsUtil 6+ no longer check PID reused #2755 * Add support for automatically hiding network interfaces that are down or that don't have any IP addresses #2799 Bug corrected: * API: Network module is disabled but appears in endpoint "all" #2815 * API is not compatible with requests containing special/encoding char #2820 * 'j' hot key crashes Glances #2831 * Raspberry PI - CPU info is not correct #2616 * Graph export is broken if there is no graph section in Glances configuration file #2839 * Glances API status check returns Error 405 - Method Not Allowed #2841 * Rootless podman containers cause glances to fail with KeyError #2827 * --export-process-filter Filter using complete command #2824 * Exception when Glances is ran with limited plugin list #2822 * Disable separator option do not work #2823 Continuous integration and documentation: * test test_107_fs_plugin_method fails on aarch64-linux #2819 Thanks to all contributors and bug reporters ! Special thanks to: * Bharath Vignesh J K * RazCrimson * Vadim Small =============== Version 4.0.8 =============== * Make CORS option configurable security webui #2812 * When Glances is installed via venv, default configuration file is not used documentation packaging #2803 * GET /1272f6e9e8f9d6bfd6de.png results in 404 bug webui #2781 by Emporea was closed May 25, 2024 * Screen frequently flickers when outputting to local display bug needs test #2490 * Retire ujson for being in maintenance mode dependencies enhancement #2791 =============== Version 4.0.7 =============== * cpu_hz_current not available on NetBSD #2792 * SensorType change in REST API breaks compatibility in 4.0.4 #2788 =============== Version 4.0.6 =============== * No GPU info on Web View #2796 =============== Version 4.0.5 =============== * SensorType change in REST API breaks compatibility in 4.0.4 #2788 * Please make pydantic optional dependency, not required one #2777 * Update the Grafana dashboard #2780 * 4.0.4 - On Glances startup "ERROR -- Can not init battery class #2776 * In codeSpace (with Python 3.8), an error occurs in ./unittest-restful.py #2773 Use Ruff as default Linter. =============== Version 4.0.4 =============== Hostfix release for support sensors plugin on python 3.8 =============== Version 4.0.3 =============== Additional fixes for Sensor plugin =============== Version 4.0.2 =============== * hotfix: plugin(sensors) - race conditions btw fan_speed & temperature… #2766 * fix: include requirements.txt and SECURITY.md for pypi dist #2761 Thanks to RazCrimson for the sensors patch ! =============== Version 4.0.1 =============== Correct issue with CI (miss pydantic dep). =============== Version 4.0.0 =============== See release note in Wiki format: https://github.com/nicolargo/glances/wiki/Glances-4.0-Release-Note **BREAKING CHANGES:** * The minimal Python version is 3.8 * The Glances API version 3 is replaced by the version 4. So Restful API URL is now /api/4/ #2610 * Alias definition change in the configuration file #1735 Glances version 3.x and lower: sda1_alias=InternalDisk sdb1_alias=ExternalDisk Glances version 4.x and higher: alias=sda1:InternalDisk,sdb1:ExternalDisk * Alert data model change from a list of list to a list of dict #2633 * Docker memory usage uses the same algorithm than docker stats #2637 Special notes for package maintainers: Minimal requirements for Glances version 4 are: * psutil * defusedxml * packaging * ujson * pydantic * fastapi (for WebUI / RestFul API) * uvicorn (for WebUI / RestFul API) * jinja2 (for WebUI / RestFul API) Majors changes between Glances version 3 and version 4: * Bottle has been replaced by FastAPI and Uvicorn * CouchDB has been replaced by PyCouchDB * nvidia-ml-py has been replaced by py3nvml * pysnmp has been replaced by pysnmp-lextudio Enhancements: * Export individual processes stats #794 * [WebUI] Feature Request: Ability to hide Engine and Pod columns in Containers #2423 * [IP plugin] Make the public ip information more configurable (not only from the Censys service) #2732 * Getting field information (description, unit) from the API #2630 * Refactor alias configuration and allow alias for fs devices #1735 * Improve alert with mininimal interval/duration configuration keys #2558 * --stdout plugin.attr is not compliant with plugins returning list of dicts #2446 * Lot's of log messages when a proxy is used with the Podman plugin #2714 * [WEBUI & CURSES] Make the left menu configurable #2648 * [WEBUI] Custom system header information #2695 * [CURSES] Use normal color for normal text instead of an arbitrary color #2687 * [WEBUI] Showing the full arguments on the command column of the TASKS #2634 * Add graph export for GPU plugin (related to #2542) * Refactor Alert data model from list of list to list of dict #2633 * Use enum instead of int for callback API version. #2712 * Make the alerts number configurable (related to #2558) * [WebUI] Added smart plugin support #2435 * No more threshold display in the WebUI cpu/mem and memswap plugins #2420 * Refactor Glances curses code #2580 * Hide password in the Glances browser form #503 * Replace Bottle by FastAPI #2181 * Replace py3nvml with nvidia-ml-py #2688 Bug corrected: * Crash when reading timezone for generating alert #2659 * Newline in container command corrupts display / hides container #2733 * RAID plugin not showing up in Glances web UI (Docker install) #2716 * Alerts showing different time than time plugin #2214 * OpenBSD crash on start without a swap file/partition #2719 * Folders plugin always fails on special directories #2518 * Update dependency urllib3 to v2 #2397 * Crach when ENTER key is pressed in the Alpine minimal image #2658 * Crash when a process is pinned in the develop branch of Glances #2639 * TERM setting causes glances to crash #2598 * macOS: Read user config from ~/.config/glances #2641 * Docker Prometheus issue with IRQ plugin #2564 * Remove systemd from Curses (related to #2595) * Screen frequently flickers when outputting to local display #2490 * Incorrect linux_distro in docker version glances #2439 * Influxdb2 export not working #2407 * Ignore/detect symlink loops in folders plugin #2494 * Remove Clear-text logging of sensitive information - Code Scanning #36 * Cannot start Glances 3.4.0.1 on Windows 10: SIGHUP not defined #2408 * 3.4.0 crash on startupwith minimal deps #2401 CI and documentation: * New logo for Glances version 4.0 #2713 * Update api-restful.rst documentation #2496 * Change Renovate config #2729 * Docker compose password unrecognized arguments when applying docs #2698 * Docker includes OS Release Volume mount info #2473 * Update prometheus.rst, fix minor typos #2640 * Fix typos and make grammatical and stylistic edits in project documentation #2625 * MongoDB and CouchDB documentation flipped #2565 * No module named 'influxdb' on the snap version of glances #1738 Many thinks to the contributors: * Bharath Vignesh J K * Christoph Zimmermann * RazCrimson * Robin Candau * Github GPG access * Continuous Integration * Georgiy Timchenko * turbocrime * Kiskae * snyk-bot * Alexander Grigoryev * Claes Hallström * Francois Pires * Maarten Kossen (mpkossen) * Osama Albahrani * csteiner * k26pl * kdkd * monochromec * and all the beta testers ! =============== Version 3.4.0.5 =============== Correct issue with GPU plugin in Docker images #2705 =============== Version 3.4.0.4 =============== Cyber security patch (update some deps in the WebUI and Docker image) =============== Version 3.4.0.3 =============== Bugs corrected: * Add glances binary to '/usr/local/bin' + Update ENV PATH to include '/venv/bin' in Dockerfiles #2419 * No more threshold display in the WebUI cpu/mem and memswap plugins #2420 =============== Version 3.4.0.2 =============== Bugs corrected: * Cannot start Glances 3.4.0.1 on Windows 10: SIGHUP not defined #2408 * Influxdb2 export not working #2407 =============== Version 3.4.0.1 =============== Bug corrected: * 3.4.0 crash on startupwith minimal deps #2401 =============== Version 3.4.0 =============== Enhancements: * Enhance process "extended stats" display (in Curses interface) #2225 _You can now *pin* a specific process to the top of the process list_ * Improve Glances start time by disabling Docker and Podman version getter - Related to #1985 * Customizable InfluxDB2 export interval #2348 * Improve kill signal management #2194 * Display a critical error message if Glances is ran with both webserver and rpcserver mode * Refactor the Cloud plugin, disable it by default in the default configuration file - Related to #2279 * Correct clear-text logging of sensitive information (security alert #29) * Use of a broken or weak cryptographic hashing algorithm (SHA256) on password storage #2175 Bug corrected: * Correct issue (error message) concerning the Cloud plugin - Related to #2392 * InfluxDB2 export doesn't process folders correctly - missing key #2327 * Index error when displaying programs on MacOS #2360 * Dissociate 2 sensors with exactly the same names #2280 * All times displayed in UTC - Container not using TZ/localtime (Docker) #2278 * It is not possible to return API data for a particular mount point (FS plugin) #1162 Documentation and CI: * chg: Dockerfile - structured & cleaner build process #2386 * Ubuntu is back as additional Docker images. Alpine stays the default one. Related to #2185 * Improve Makefile amd docker-compose to support Podman and GPU * Workaround to pin urlib3<2.0 - Related to #2392 * Error while generating the documentation (ModuleNotFoundError: No module named 'glances') #2391 * Update Flamegraph (memory profiling) * Improve template for issue report and feature request * Parameters in the VIRT column #2343 * Graph generation documentation is not clear #2336 * docs: Docker - include tag details * Add global architecture diagram (Excalidraw) * Links to documents in sample glances.conf are not valid. #2271 * Add semgrep support * Smartmontools missing from full docker image #2262 * Improve documentation regarding regexp in configuration file * Improve documentation about the [ip] plugin #2251 Cyber security update: * All libs have been updated to the latest version Full roadmap here: https://github.com/nicolargo/glances/milestone/62?closed=1 Refactor the Docker images factory, from now, Alpine and Ubuntu images will be provided (nicolargo/glances): - *latest-full* for a full Alpine Glances image (latest release) with all dependencies - *latest* for a basic Alpine Glances (latest release) version with minimal dependencies (Bottle and Docker) - *dev* for a basic Alpine Glances image (based on development branch) with all dependencies (Warning: may be instable) - *ubuntu-latest-full* for a full Ubuntu Glances image (latest release) with all dependencies - *ubuntu-latest* for a basic Ubuntu Glances (latest release) version with minimal dependencies (Bottle and Docker) - *ubuntu-dev* for a basic Ubuntu Glances image (based on development branch) with all dependencies (Warning: may be instable) Contributors for this version: * Nicolargo * RazCrimson: a very special thanks to @RazCrimson for his huge work on this version ! * Bharath Vignesh J K * Raz Crimson * fr4nc0is * Florian Calvet * Ali Erdinç Köroğlu * Jose Vicente Nunez * Rui Chen * Ryan Horiguchi * mfridge * snyk-bot =============== Version 3.3.1.1 =============== Hard patch on the master branch. Bug corrected: * "ModuleNotFoundError: No module named 'ujson'" #2246 * Remove surrounding quotes for quoted command arguments #2247 (related to #2239) =============== Version 3.3.1 =============== Enhancements: * Minor change on the help screen * Refactor some loop in the processes function * Replace json by ujson #2201 Bug corrected: * Unable to see docker related information #2180 * CSV export dependent on sort order for docker container cpu #2156 * Error when process list is displayed in Programs mode #2209 * Console formatting permanently messed up when other text printed #2211 * API GET uptime returns formatted string, not seconds as the doc says #2158 * Glances UI is breaking for multiline commands #2189 Documentation and CI: * Add unitary test for memory profiling * Update memory profile chart * Add run-docker-ubuntu-* in Makefile * The open-web-browser option was missing dashes #2219 * Correct regexp in glances.conf file example * What is CW from network #2222 (related to discussion #2221) * Change Glances repology URL * Add example for the date format * Correct Flake8 configuration file * Drop UT for Python 3.5 and 3.6 (no more available in Ubuntu 22.04) * Correct unitary test with Python 3.5 * Update Makefile with comments * Update Python minimal requirement for py3nvlm * Update security policy (user can open private issue directly in Github) * Add a simple run script. Entry point for IDE debugger Cyber security update: * Security alert on ujson < 5.4 * Merge pull request #2243 from nicolargo/renovate/nvidia-cuda-12.x * Merge pull request #2244 from nicolargo/renovate/crazy-max-ghaction-docker-meta-4.x * Merge pull request #2228 from nicolargo/renovate/zeroconf-0.x * Merge pull request #2242 from nicolargo/renovate/crazy-max-ghaction-docker-meta-4.x * Merge pull request #2239 from mfridge/action-command-split * Merge pull request #2165 from nicolargo/renovate/zeroconf-0.x * Merge pull request #2199 from nicolargo/renovate/alpine-3.x * Merge pull request #2202 from chncaption/oscs_fix_cdr0ts8au51t49so8c6g * Bump loader-utils from 2.0.0 to 2.0.3 in /glances/outputs/static #2187 - Update Web lib Contributors for this version: * Nicolargo * renovate[bot] * chncaption * fkwong * *mfridge And also a big thanks to @RazCrimson (https://github.com/RazCrimson) for the support to the Glances community ! =============== Version 3.3.0.4 =============== Refactor the Docker images factory, from now, only Alpine image will be provided. The following Docker images (nicolargo/glances) are availables: - *latest-full* for a full Alpine Glances image (latest release) with all dependencies - *latest* for a basic Alpine Glances (latest release) version with minimal dependencies (Bottle and Docker) - *dev* for a basic Alpine Glances image (based on development branch) with all dependencies (Warning: may be instable) =============== Version 3.3.0.2 =============== Bug corrected: * Password files in same configuration dir in effect #2143 * Fail to load config file on Python 3.10 #2176 =============== Version 3.3.0.1 =============== Just a version to rebuild the Docker images. =============== Version 3.3.0 =============== Enhancements: * Migration from AngularJS to Angular/React/Vue #2100 (many thanks to @fr4nc0is) * Improve the IP module with a link to Censys #2105 * Add the public IP information to the WebUI #2105 * Add an option to show a configurable clock/time module to display #2150 * Add sort information on Docker plugin (console mode). Related to #2138 * Password files in same configuration dir in effect #2143 * If the container name is long, then display the start, not the end - Related to #1732 * Make the Web UI same than Console for CPU plugin * [WINDOWS] Reorganise CPU stats display #2131 * Remove the static exportable_plugins list from glances_export.py #1556 * Limiting data exported for economic storage #1443 Bug corrected: * glances.conf FS hide not applying #1666 * AMP: regex with special chars #2152 * fix(help-screen): add missing shortcuts and columnize algorithmically #2135 * Correct issue with the regexp filter (use fullmatch instead of match) * Errors when running Glances as web service #1702 * Apply alias to Duplicate sensor name #1686 * Make the hide function in sensors section compliant with lower/uppercase #1590 * Web UI truncates the days part of CPU time counter of the process list #2108 * Correct alignment issue with the diskio plugin (Console UI) Documentation and CI: * Refactor Docker file CI * Add Codespell to the CI pipeline #2148 * Please add docker-compose example and document example. #2151 * [DOC] Glances failed to start and some other issues - BSD #2106 * [REQUEST Docker image] Output log to stdout #2128 (for debian) * Fix code scanning alert - Clear-text logging of sensitive information #2124 * Improve makefile (with online documentation) * buildx failed with: ERROR: failed to solve: python:3.10-slim-buster: no match for platform in manifest #2120 * [Update docs] Can I export only the fields I need in csv report？ #2113 * Windows Python 3 installation fails on dependency package "future" #2109 Contributors for this version: * fr4nc0is : a very special thanks to @fr4nc0is for his huge work on the Glances v3.3.0 WebUI !!! * Kostis Anagnostopoulos * Kian-Meng Ang * dependabot[bot] * matthewaaronthacker * and your servant Nicolargo =============== Version 3.2.7 =============== Enhancements: * Config to disable all plugins by default (or enable an exclusive list) #2089 * Keybind(s) for modifying nice level #2081 * [WEBUI] Reorganize help screen #2037 * Add a Json stdout option #2060 * Improve error message when export error occurs * Improve error message when MQTT error occurs * Change the way core are displayed * Remove unused key in the process list * Refactor top menu of the curse interface * Improve Irix display for the load plugin Bug corrected: * In the sensor plugin thresholds in the configuration file should overwrite system ones #2058 * Drive names truncated in Web UI #2055 * Correct issue with CPU label Documentation and CI: * Improve makefile help #2078 * Add quote to the update command line (already ok for the installation). Related to #2073 * Make Glances (almost) compliant with REUSE #2042 * Update README for Debian package users * Update documentation for Docker * Update docs for new shortcut * Disable Pyright on the Git actions pipeline * Refactor comments * Except datutil import error * Another dep issue solved in the Alpine Docker + issue in the outdated method Contributors for this version: * Nicolargo * Sylvain MOUQUET * FastThenLeft * Jiajie Chen * dbrennand * ewuerger =============== Version 3.2.6 =============== Enhancement requests: * Create a Show option in the configuration file to only show some stats #2052 * Use glances.conf file inside docker-compose folder for Docker images * Optionally disable public ip #2030 * Update public ip at intervals #2029 Bug corrected: * Unitary tests should run loopback interface #2051 * Add python-datutil dep for Focker plugin #2045 * Add venv to list of .PHONY in Makefile #2043 * Glances API Documentation displays non valid json #2036 A big thanks to @RazCrimson for his contribution ! Thanks for others contributors: * Steven Conaway * aekoroglu =============== Version 3.2.5 =============== Enhancement requests: * Add a Accumulated per program function to the Glances process list needs test new feature plugin/ps #2015 * Including battery and AC adapter health in Glances enhancement new feature #1049 * Display uptime of a docker container enhancement plugin/docker #2004 * Add a code formatter enhancement #1964 Bugs corrected: * Threading.Event.isSet is deprecated in Python 3.10 #2017 * Fix code scanning alert - Clear-text logging of sensitive information security #2006 * The gpu temperature unit are displayed incorrectly in web ui bug #2002 * Doc for 'alert' Restful/JSON API response documentation #1994 * Show the spinning state of a disk documentation #1993 * Web server status check endpoint enhancement #1988 * --time parameter being ignored for client/server mode bug #1978 * Amp with pipe do not work documentation #1976 * glances_ip.py plugin relies on low rating / malicious site domain bug security #1975 * "N" command freezes/unfreezes the current time instead of show/hide bug #1974 * Missing commands in help "h" screen enhancement needs contributor #1973 * Grafana dashboards not displayed with influxdb2 enhancement needs contributor #1960 * Glances reports different amounts of used memory than free -m or top documentation #1924 * Missing: Help command doesn't have info on TCP Connections bug documentation enhancement needs contributor #1675 * Docstring convention documentation enhancement #940 Thanks for the bug report and the patch: @RazCrimson, @Karthikeyan Singaravelan, @Moldavite, @ledwards =============== Version 3.2.4.1 =============== Bugs corrected: * Missing packaging dependency when using pip install #1955 =============== Version 3.2.4 =============== Bugs corrected: * Failure to start on Apple M1 Max #1939 * Influxdb2 via SSL #1934 * Update WebUI (security patch). Thanks to @notFloran. * Switch from black <> white theme with the '9' hotkey - Related to issue #976 * Fix: Docker plugin - Invalid IO stats with Arch Linux #1945 * Bug Fix: Docker plugin - Network stats not being displayed #1944 * Fix Grafana CPU temperature panel #1954 * is_disabled name fix #1949 * Fix tipo in documentation #1932 * distutils is deprecated in Python 3.10 #1923 * Separate battery percentages #1920 * Update docs and correct make docs-server target in Makefile Enhancement requests: * Improve --issue by displaying the second update iteration and not the first one. More relevant * Improve --issue option with Python version and paths * Correct an issue on idle display * Refactor Mem + MemSwap Curse * Refactor CPU Curses code Contributors for this version: * Nicolargo * RazCrimson * Floran Brutel * H4ckerxx44 * Mohamad Mansour * Néfix Estrada * Zameer Manji =============== Version 3.2.3.1 =============== Patch to correct issue (regression) #1922: * Incorrect processes disk IO stats #1922 * DSM 6 docker error crash /sys/class/power_supply #1921 =============== Version 3.2.3 =============== Bugs corrected: * Docker container monitoring only show half command? #1912 * Processor name getting cut off #1917 * batinfo not in docker image (and in requirements files...) ? #1915 * Glances don't send hostname (tag) to influxdb2 #1913 * Public IP address doesn't display anymore #1910 * Debian Docker images broken with version 3.2.2 #1905 Enhancement requests: * Make the process sort list configurable through the command line #1903 * [WebUI] truncates network name #1699 =============== Version 3.2.2 =============== Bugs corrected: * [3.2.0/3.2.1] keybinding not working anymore #1904 * InfluxDB/InfluxDB2 Export object has no attribute hostname #1899 Documentation: The "make docs" generate RestFul/API documentation file. =============== Version 3.2.1 =============== Bugs corrected: * Glances 3.2.0 and influxdb export - Missing network data bug #1893 Enhancement requests: * Security audit - B411 enhancement (Monkey patch XML RPC Lib) #1025 * Also search glances.conf file in /usr/share/doc/glances/glances.conf #1862 =============== Version 3.2.0 =============== This release is a major version (but minor number because the API did not change). It focus on *CPU consumption*. I use `Flame profiling https://github.com/nicolargo/glances/wiki/Glances-FlameGraph`_ and code optimization to *reduce CPU consumption from 20% to 50%* depending on your system. Enhancement and development requests: * Improve CPU consumption - Make the refresh rate configurable per plugin #1870 - Add caching for processing username and cmdline - Correct and improve refresh time method - Set refresh rate for global CPU percent - Set the default refresh rate of system stats to 60 seconds - Default refresh time for sensors is refresh rate * 2 - Improve history perf - Change main curses loop - Improve Docker client connection - Update Flame profiling * Get system sensors temperatures thresholds #1864 * Filter data exported from Docker plugin * Make the Docker API connection timeout configurable * Add --issue to Github issue template * Add release-note in the Makefile * Add some comments in cpu_percent * Add some comments to the processlist.py * Set minimal version for PSUtil to 5.3.0 * Add comment to default glances.conf file * Improve code quality #820 * Update WebUI for security vuln Bugs corrected: * Quit from help should return to main screen, not exit #1874 * AttributeError: 'NoneType' object has no attribute 'current' #1875 * Merge pull request #1873 from metayan/fix-history-add * Correct filter * Correct Flake8 issue in plugins * Pressing Q to get rid of irq not working #1792 * Spelling correction in docs #1886 * Starting an alias with a number causes a crash #1885 * Network interfaces not applying in web UI #1884 * Docker containers information missing with Docker 20.10.x #1878 * Get system sensors temperatures thresholds #1864 Contributors for this version: * Nicolargo * Markus Pöschl * Clifford W. Hansen * Blake * Yan =============== Version 3.1.7 =============== Enhancements and bug corrected: * Security audit - B411 #1025 (by nicolargo) * GPU temperature not shown in webview #1849 (by nicolargo) * Remove shell=True for actions (following Bandit issue report) #1851 (by nicolargo) * Replace Travis by Github action #1850 (by nicolargo) * '/api/3/processlist/pid/3936'use this api can't get right info,all messy code #1828 (by nicolargo) * Refactor the way importants stats are displayed #1826 (by nicolargo) * Re-apply the Add hide option to sensors plugin #1596 PR (by nicolargo) * Smart plugin error while start glances as root #1806 (by nicolargo) * Plugin quicklook takes more than one seconds to update #1820 (by nicolargo) * Replace Pystache by Chevron 2/2 See #1817 (by nicolargo) * Doc. No SMART screenshot. #1799 (by nicolargo) * Update docs following PR #1798 (by nicolargo) Contributors for this version: - Nicolargo - Deosrc - dependabot[bot] - Michael J. Cohen - Rui Chen - Stefan Eßer - Tuux =============== Version 3.1.6.2 =============== Bugs corrected: * Remove bad merge for a non tested feature (see https://github.com/nicolargo/glances/issues/1787#issuecomment-774682954) Version 3.1.6.1 =============== Bugs corrected: * Glances crash after installing module for shown GPU information on Windows 10 #1800 Version 3.1.6 ============= Enhancements and new features: * Kill a process from the Curses interface #1444 * Manual refresh on F5 in the Curses interface #1753 * Hide function in sensors section #1590 * Enhancement Request: .conf parameter for AMP #1690 * Password for Web/Browser mode #1674 * Unable to connect to Influxdb 2.0 #1776 * ci: fix release process and improve build speeds #1782 * Cache cpuinfo output #1700 * sort by clicking improvements and bug #1578 * Allow embedded AMP python script to be placed in a configurable location #1734 * Add attributes to stdout/stdout-csv plugins #1733 * Do not shorten container names #1723 Bugs corrected: * Version tag for docker image packaging #1754 * Unusual characters in cmdline cause lines to disappear and corrupt the display #1692 * UnicodeDecodeError on any command with a utf8 character in its name #1676 * Docker image is not up to date install #1662 * Add option to set the strftime format #1785 * fix: docker dev build contains all optional requirements #1779 * GPU information is incomplete via web #1697 * [WebUI] Fix display of null values for GPU plugin #1773 * crash on startup on Illumos when no swap is configured #1767 * Glances crashes with 2 GPUS bug #1683 * [Feature Request] Filter Docker containers#1748 * Error with IP Plugin : object has no attribute #1528 * docker-compose #1760 * [WebUI] Fix sort by disk io #1759 * Connection to MQTT server failst #1705 * Misleading image tag latest-arm needs contributor packaging #1419 * Docker nicolargo/glances:latest missing arm builds? #1746 * Alpine image is broken packaging #1744 * RIP Alpine? needs contributor packaging #1741 * Manpage improvement documentation #1743 * Make build reproducible packaging #1740 * Automated multiarch builds for docker #1716 * web ui of glances is not coming #1721 * fixing command in json.rst #1724 * Fix container rss value #1722 * Alpine Image is broken needs test packaging #1720 * Fix gpu plugin to handle multiple gpus with different reporting capabilities bug #1634 Version 3.1.5 ============= Enhancements and new features: * Enhancement: RSS for containers enhancement #1694 * exports: support rabbitmq amqps enhancement #1687 * Quick Look missing CPU Infos enhancement #1685 * Add amqps protocol support for rabbitmq export #1688 * Select host in Grafana json #1684 * Value for free disk space is counterintuative on ext file systems enhancement #644 Bugs corrected: * Can't start server: unexpected keyword argument 'address' bug enhancement #1693 * class AmpsList method _build_amps_list() Windows fail (glances/amps_list.py) bug #1689 * Fix grammar in sensors documentation #1681 * Reflect "used percent" user disk space for [fs] alert #1680 * Bug: [fs] plugin needs to reflect user disk space usage needs test #1658 * Fixed formatting on FS example #1673 * Missing temperature documentation #1664 * Wiki page for starting as a service documentation #1661 * How to start glances with --username option on syetemd? documentation #1657 * tests using /etc/glances/glances.conf from already installed version bug #1654 * Unittests: Use sys.executable instead of hardcoding the python interpreter #1655 * Glances should not phone home install #1646 * Add lighttpd reverse proxy config to the wiki documentation #1643 * Undefined name 'i' in plugins/glances_gpu.py bug #1635 Version 3.1.4 ============= Enhancements and new features: * FS filtering can be done on device name documentation enhancement #1606 * Feature request: Include hostname in all (e.g. kafka) exports #1594 * Threading.isAlive was removed in Python 3.9. Use is_alive. #1585 * log file under public/shared tmp/ folders must not have deterministic name #1575 * Install / Systemd Debian documentation #1560 * Display load as percentage when Irix mode is disable #1554 * [WebUI] Add a new TCP connections status plugin new feature #1547 * Make processes.sort_key configurable enhancement #1536 * NVIDIA GPU temperature #1523 * Feature request: HDD S.M.A.R.T. #1288 Bugs corrected: * Glances 3.1.3: when no network interface with Public address #1615 * NameError: name 'logger' is not defined #1602 * Disk IO stats missing after upgrade to 5.5.x kernel #1601 * Glances don't want to run on Crostini (LXC Container, Debian 10, python 3.7.3) #1600 * Kafka key name needs to be bytes #1593 * Can't start glances with glances --export mqtt #1581 * [WEBUI] AMP plugins is not displayed correctly in the Web Interface #1574 * Unhandled AttributeError when no config files found #1569 * Glances writing lots of Docker Error message in logs file enhancement #1561 * GPU stats not showing on mobile web view bug needs test #1555 * KeyError: b'Rss:' in memory_maps #1551 * CPU usage is always 100% #1550 * IP plugin still exporting data when disabled #1544 * Quicklook plugin not working on Systemd #1537 Version 3.1.3 ============= Enhancements and new features: * Add a new TCP connections status plugin enhancement #1526 * Add --enable-plugin option from the command line Bugs corrected: * Fix custom refresh time in the web UI #1548 by notFloran * Fix issue in WebUI with empty docker stats #1546 by notFloran * Glances fails without network interface bug #1535 * Disable option in the configuration file is now take into account Others: * Sensors plugin is disable by default (high CPU consumption on some Liux distribution). Version 3.1.2 ============= Enhancements and new features: * Make CSV export append instead of replace #1525 * HDDTEMP config IP and Port #1508 * [Feature Request] Option in config to change character used to display percentage in Quicklook #1508 Bugs corrected: * Cannot restart glances with --export influxdb after update to 3.1.1 bug #1530 * ip plugin empty interface bug #1509 * Glances Snap doesn't run on Orange Pi Zero running Ubuntu Core 16 bug #1517 * Error with IP Plugin : object has no attribute bug #1528 * repair the problem that when running 'glances --stdout-csv amps' #1520 * Possible typo in glances_influxdb.py #1514 Others: * In debug mode (-d) all duration (init, update are now logged). Grep duration in log file. Version 3.1.1 ============= Enhancements and new features: * Please add some sparklines! #1446 * Add Load Average (similar to Linux) on Windows #344 * Add authprovider for cassandra export (thanks to @EmilienMottet) #1395 * Curses's browser server list sorting added (thanks to @limfreee) #1396 * ElasticSearch: add date to index, unbreak object push (thanks to @genevera) #1438 * Performance issue with large folder #1491 * Can't connect to influxdb with https enabled #1497 Bugs corrected: * Fix Cassandra table name export #1402 * 500 Internal Server Error /api/3/network/interface_name #1401 * Connection to MQTT server failed : getaddrinfo() argument 2 must be integer or string #1450 * `l` keypress (hide alert log) not working after some time #1449 * Too less data using prometheus exporter #1462 * Getting an error when running with prometheus exporter #1469 * Stack trace when starts Glances on CentOS #1470 * UnicodeEncodeError: 'ascii' codec can't encode character u'\u25cf' - Raspbian stretch #1483 * Prometheus integration broken with latest prometheus_client #1397 * "sorted by ?" is displayed when setting the sort criterion to "USER" #1407 * IP plugin displays incorrect subnet mask #1417 * Glances PsUtil ValueError on IoCounter with TASK kernel options #1440 * Per CPU in Web UI have some display issues. #1494 * Fan speed and voltages section? #1398 Others: * Documentation is unclear how to get Docker information #1386 * Add 'all' target to the Pip install (install all dependencies) * Allow comma separated commands in AMP Version 3.1 =========== Enhancements and new features: * Add a CSV output format to the STDOUT output mode #1363 * Feature request: HDD S.M.A.R.T. reports (thanks to @tnibert) #1288 * Sort docker stats #1276 * Prohibit some plug-in data from being exported to influxdb #1368 * Disable plugin from Glances configuration file #1378 * Curses-browser's server list paging added (thanks to @limfreee) #1385 * Client Browser's thread management added (thanks to @limfreee) #1391 Bugs corrected: * TypeError: '<' not supported between instances of 'float' and 'str' #1315 * GPU plugin not exported to influxdb #1333 * Crash after running fine for several hours #1335 * Timezone listed doesn’t match system timezone, outputs wrong time #1337 * Compare issue with Process.cpu_times() #1339 * ERROR -- Can not grab extended stats (invalid attr name 'num_fds') #1351 * Action on port/web plugins is not working #1358 * Support for monochrome (serial) terminals e.g. vt220 #1362 * TypeError on opening (Wifi plugin) #1373 * Some field name are incorrect in CSV export #1372 * Standard output misbehaviour (need to flush) #1376 * Create an option to set the username to use in Web or RPC Server mode #1381 * Missing kernel task names when the webui is switched to long process names #1371 * Drive name with special characters causes crash #1383 * Cannot get stats in Cloud plugin (404) #1384 Others: * Add Docker documentation (thanks to @rgarrigue) * Refactor Glances logs (now called Glances events) * "chart" extra dep replace by "graph" #1389 Version 3.0.2 ============= Bug corrected: * Glances IO Errorno 22 - Invalid argument #1326 Version 3.0.1 ============= Bug corrected: * AMPs error if no output are provided by the system call #1314 Version 3.0 =========== See the release note here: https://github.com/nicolargo/glances/wiki/Glances-3.0-Release-Note Enhancements and new features: * Make the left side bar width dynamic in the Curse UI #1177 * Add threads number in the process list #1259 * A way to have only REST API available and disable WEB GUI access #1149 * Refactor graph export plugin (& replace Matplolib by Pygal) #697 * Docker module doesn't export details about stopped containers #1152 * Add dynamic fields in all sections of the configuration file #1204 * Make plugins and export CLI option dynamical #1173 * Add a light mode for the console UI #1165 * Refactor InfluxDB (API is now stable) #1166 * Add deflate compression support to the RestAPI #1182 * Add a code of conduct for Glances project's participants #1211 * Context switches bottleneck identification #1212 * Take advantage of the psutil issue #1025 (Add process_iter(attrs, ad_value)) #1105 * Nice Process Priority Configuration #1218 * Display debug message if dep lib is not found #1224 * Add a new output mode to stdout #1168 * Huge refactor of the WebUI packaging thanks to @spike008t #1239 * Add time zone to the current time #1249 * Use HTTPs URLs to check public IP address #1253 * Add labels support to Promotheus exporter #1255 * Overlap in Web UI when monitoring a machine with 16 cpu threads #1265 * Support for exporting data to a MQTT server #1305 One more thing ! A new Grafana Dash is available with: * Network interface variable * Disk variable * Container CPU Bugs corrected: * Crash in the Wifi plugin on my Laptop #1151 * Failed to connect to bus: No such file or directory #1156 * glances_plugin.py has a problem with specific docker output #1160 * Key error 'address' in the IP plugin #1176 * NameError: name 'mode' is not defined in case of interrupt shortly after starting the server mode #1175 * Crash on startup: KeyError: 'hz_actual_raw' on Raspbian 9.1 #1170 * Add missing mount-observe and system-observe interfaces #1179 * OS specific arguments should be documented and reported #1180 * 'ascii' codec can't encode character u'\U0001f4a9' in position 4: ordinal not in range(128) #1185 * KeyError: 'memory_info' on stats sum #1188 * Electron/Atom processes displayed wrong in process list #1192 * Another encoding issue... With both Python 2 and Python 3 #1197 * Glances do not exit when eating 'q' #1207 * FreeBSD blackhole bug #1202 * Glances crashes when mountpoint with non ASCII characters exists #1201 * [WEB UI] Minor issue on the Web UI #1240 * [Glances 3.0 RC1] Client/Server is broken #1244 * Fixing horizontal scrolling #1248 * Stats updated during export (thread issue) #1250 * Glances --browser crashed when more than 40 glances servers on screen 78x45 #1256 * OSX - Python 3 and empty percent and res #1251 * Crashes when influxdb option set #1260 * AMP for kernel process is not working #1261 * Arch linux package (2.11.1-2) psutil (v5.4.1): RuntimeWarning: ignoring OSError #1203 * Glances crash with extended process stats #1283 * Terminal window stuck at the last accessed *protected* server #1275 * Glances shows mdadm RAID0 as degraded when chunksize=128k and the array isn't degraded. #1299 * Never starts in a server on Google Cloud and FreeBSD #1292 Backward-incompatible changes: * Support for Python 3.3 has been dropped (EOL 2017-09-29) * Support for psutil < 5.3.0 has been dropped * Minimum supported Docker API version is now 1.21 (Docker plugins) * Support for InfluxDB < 0.9 is deprecated (InfluxDB exporter) * Zeroconf lib should be pinned to 0.19.1 for Python 2.x * --disable- no longer available (use --disable-plugin ) * --export- no longer available (use --export ) News command line options: --disable-webui Disable the WebUI (only RESTful API will respond) --enable-light Enable the light mode for the UI interface --modules-list Display plugins and exporters list --disable-plugin plugin1,plugin2 Disable a list of comma separated plugins --export exporter1,exporter2 Export stats to a comma separated exporters --stdout plugin1,plugin2.attribute Display stats to stdout News configuration keys in the glances.conf file: Graph: [graph] # Configuration for the --export graph option # Set the path where the graph (.svg files) will be created # Can be overwrite by the --graph-path command line option path=/tmp # It is possible to generate the graphs automatically by setting the # generate_every to a non zero value corresponding to the seconds between # two generation. Set it to 0 to disable graph auto generation. generate_every=60 # See following configuration keys definitions in the Pygal lib documentation # http://pygal.org/en/stable/documentation/index.html width=800 height=600 style=DarkStyle Processes list Nice value: [processlist] # Nice priorities range from -20 to 19. # Configure nice levels using a comma-separated list. # # Nice: Example 1, non-zero is warning (default behavior) nice_warning=-20,-19,-18,-17,-16,-15,-14,-13,-12,-11,-10,-9,-8,-7,-6,-5,-4,-3,-2,-1,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19 # # Nice: Example 2, low priority processes escalate from careful to critical #nice_careful=1,2,3,4,5,6,7,8,9 #nice_warning=10,11,12,13,14 #nice_critical=15,16,17,18,19 Docker plugin (related to #1152) [docker] # By default, Glances only display running containers # Set the following key to True to display all containers all=False All configuration file values (related to #1204) [influxdb] # It is possible to use dynamic system command prefix=`hostname` tags=foo:bar,spam:eggs,system:`uname -a` ============================================================================== Glances Version 2 ============================================================================== Version 2.11.1 ============== * [WebUI] Sensors not showing on Web (issue #1142) * Client and Quiet mode don't work together (issue #1139) Version 2.11 ============ Enhancements and new features: * New export plugin: standard and configurable RESTful exporter (issue #1129) * Add a JSON export module (issue #1130) * [WIP] Refactoring of the WebUI Bugs corrected: * Installing GPU plugin crashes entire Glances (issue #1102) * Potential memory leak in Windows WebUI (issue #1056) * glances_network `OSError: [Errno 19] No such device` (issue #1106) * GPU plugin. : ... not JSON serializable"> (issue #1112) * PermissionError on macOS (issue #1120) * Can't move up or down in glances --browser (issue #1113) * Unable to give aliases to or hide network interfaces and disks (issue #1126) * `UnicodeDecodeError` on mountpoints with non-breaking spaces (issue #1128) Installation: * Create a Snap of Glances (issue #1101) Version 2.10 ============ Enhancements and new features: * New plugin to scan remote Web sites (URL) (issue #981) * Add trends in the Curses interface (issue #1077) * Add new repeat function to the action (issue #952) * Use -> and <- arrows keys to switch between processing sort (issue #1075) * Refactor __init__ and main scripts (issue #1050) * [WebUI] Improve WebUI for Windows 10 (issue #1052) Bugs corrected: * StatsD export prefix option is ignored (issue #1074) * Some FS and LAN metrics fail to export correctly to StatsD (issue #1068) * Problem with non breaking space in file system name (issue #1065) * TypeError: string indices must be integers (Network plugin) (issue #1054) * No Offline status for timeouted ports? (issue #1084) * When exporting, uptime values loop after 1 day (issue #1092) Installation: * Create a package.sh script to generate .DEB, .RPM and others... (issue #722) ==> https://github.com/nicolargo/glancesautopkg * OSX: can't python setup.py install due to python 3.5 constraint (issue #1064) Version 2.9.1 ============= Bugs corrected: * Glances PerCPU issues with Curses UI on Android (issue #1071) * Remove extra } in format string (issue #1073) Version 2.9.0 ============= Enhancements and new features: * Add a Prometheus export module (issue #930) * Add a Kafka export module (issue #858) * Port in the -c URI (-c hostname:port) (issue #996) Bugs corrected: * On Windows --export-statsd terminates immediately and does not export (issue #1067) * Glances v2.8.7 issues with Curses UI on Android (issue #1053) * Fails to start, OSError in sensors_temperatures (issue #1057) * Crashes after long time running the glances --browser (issue #1059) * Sensor values don't refresh since psutil backend (issue #1061) * glances-version.db Permission denied (issue #1066) Version 2.8.8 ============= Bugs corrected: * Drop requests to check for outdated Glances version * Glances cannot load "Powersupply" (issue #1051) Version 2.8.7 ============= Bugs corrected: * Windows OS - Global name standalone not defined again (issue #1030) Version 2.8.6 ============= Bugs corrected: * Windows OS - Global name standalone not defined (issue #1030) Version 2.8.5 ============= Bugs corrected: * Cloud plugin error: Name 'requests' is not defined (issue #1047) Version 2.8.4 ============= Bugs corrected: * Correct issue on Travis CI test Version 2.8.3 ============= Enhancements and new features: * Use new sensors-related APIs of psutil 5.1.0 (issue #1018) * Add a "Cloud" plugin to grab stats inside the AWS EC2 API (issue #1029) Bugs corrected: * Unable to launch Glances on Windows (issue #1021) * Glances --export-influxdb starts Webserver (issue #1038) * Cut mount point name if it is too long (issue #1045) * TypeError: string indices must be integers in per cpu (issue #1027) * Glances crash on RPi 1 running ArchLinuxARM (issue #1046) Version 2.8.2 ============= Bugs corrected: * InfluxDB export in 2.8.1 is broken (issue #1026) Version 2.8.1 ============= Enhancements and new features: * Enable docker plugin on Windows (issue #1009) - Thanks to @fraoustin Bugs corrected: * Glances export issue with CPU and SENSORS (issue #1024) * Can't export data to a CSV file in Client/Server mode (issue #1023) * Autodiscover error while binding on IPv6 addresses (issue #1002) * GPU plugin is display when hitting '4' or '5' shortkeys (issue #1012) * Interrupts and usb_fiq (issue #1007) * Docker image does not work in web server mode! (issue #1017) * IRQ plugin is not display anymore (issue #1013) * Autodiscover error while binding on IPv6 addresses (issue #1002) Version 2.8 =========== Changes: * The curses interface on Windows is no more. The web-based interface is now the default. (issue #946) * The name of the log file now contains the name of the current user logged in, i.e., 'glances-USERNAME.log'. * IRQ plugin off by default. '--disable-irq' option replaced by '--enable-irq'. Enhancements and new features: * GPU monitoring (limited to NVidia) (issue #170) * WebUI CPU consumption optimization (issue #836) * Not compatible with the new Docker API 2.0 (Docker 1.13) (issue #1000) * Add ZeroMQ exporter (issue #939) * Add CouchDB exporter (issue #928) * Add hotspot Wifi information (issue #937) * Add default interface speed and automatic rate thresholds (issue #718) * Highlight max stats in the processes list (issue #878) * Docker alerts and actions (issue #875) * Glances API returns the processes PPID (issue #926) * Configure server cached time from the command line --cached-time (issue #901) * Make the log logger configurable (issue #900) * System uptime in export (issue #890) * Refactor the --disable-* options (issue #948) * PID column too small if kernel.pid_max is > 99999 (issue #959) Bugs corrected: * Glances RAID plugin Traceback (issue #927) * Default AMP crashes when 'command' given (issue #933) * Default AMP ignores `enable` setting (issue #932) * /proc/interrupts not found in an OpenVZ container (issue #947) Version 2.7.1 ============= Bugs corrected: * AMP plugin crashes on start with Python 3 (issue #917) * Ports plugin crashes on start with Python 3 (issue #918) Version 2.7 =========== Backward-incompatible changes: * Drop support for Python 2.6 (issue #300) Deprecated: * Monitoring process list module is replaced by AMP (see issue #780) * Use --export-graph instead of --enable-history (issue #696) * Use --path-graph instead of --path-history (issue #696) Enhancements and new features: * Add Application Monitoring Process plugin (issue #780) * Add a new "Ports scanner" plugin (issue #734) * Add a new IRQ monitoring plugin (issue #911) * Improve IP plugin to display public IP address (issue #646) * CPU additional stats monitoring: Context switch, Interrupts... (issue #810) * Filter processes by others stats (username) (issue #748) * [Folders] Differentiate permission issue and non-existence of a directory (issue #828) * [Web UI] Add cpu name in quicklook plugin (issue #825) * Allow theme to be set in configuration file (issue #862) * Display a warning message when Glances is outdated (issue #865) * Refactor stats history and export to graph. History available through API (issue #696) * Add Cassandra/Scylla export plugin (issue #857) * Huge pull request by Nicolas Hart to optimize the WebUI (issue #906) * Improve documentation: http://glances.readthedocs.io (issue #872) Bugs corrected: * Crash on launch when viewing temperature of laptop HDD in sleep mode (issue #824) * [Web UI] Fix folders plugin never displayed (issue #829) * Correct issue IP plugin: VPN with no internet access (issue #842) * Idle process is back on FreeBSD and Windows (issue #844) * On Windows, Glances try to display unexisting Load stats (issue #871) * Check CPU info (issue #881) * Unicode error on processlist on Windows server 2008 (french) (issue #886) * PermissionError/OSError when starting glances (issue #885) * Zeroconf problem with zeroconf_type = "_%s._tcp." % __appname__ (issue #888) * Zeroconf problem with zeroconf service name (issue #889) * [WebUI] Glances will not get past loading screen - Windows OS (issue #815) * Improper bytes/unicode in glances_hddtemp.py (issue #887) * Top 3 processes are back in the alert summary Code quality follow up: from 5.93 to 6.24 (source: https://scrutinizer-ci.com/g/nicolargo/glances) Version 2.6.2 ============= Bugs corrected: * Crash with Docker 1.11 (issue #848) Version 2.6.1 ============= Enhancements and new features: * Add a connector to Riemann (issue #822 by Greogo Nagy) Bugs corrected: * Browsing for servers which are in the [serverlist] is broken (issue #819) * [WebUI] Glances will not get past loading screen (issue #815) opened 9 days ago * Python error after upgrading from 2.5.1 to 2.6 bug (issue #813) Version 2.6 =========== Deprecations: * Add deprecation warning for Python 2.6. Python 2.6 support will be dropped in future releases. Please switch to at least Python 2.7 or 3.3+ as soon as possible. See http://www.snarky.ca/stop-using-python-2-6 for more information. Enhancements and new features: * Add a connector to ElasticSearch (welcome to Kibana dashboard) (issue #311) * New folders' monitoring plugins (issue #721) * Use wildcard (regexp) to the hide configuration option for network, diskio and fs sections (issue #799 ) * Command line arguments are now take into account in the WebUI (#789 by @notFloran) * Change username for server and web server authentication (issue #693) * Add an option to disable top menu (issue #766) * Add IOps in the DiskIO plugin (issue #763) * Add hide configuration key for FS Plugin (issue #736) * Add process summary min/max stats (issue #703) * Add timestamp to the CSV export module (issue #708) * Add a shortcut 'E' to delete process filter (issue #699) * By default, hide disk I/O ram1-** (issue #714) * When Glances is starting the notifications should be delayed (issue #732) * Add option (--disable-bg) to disable ANSI background colours (issue #738 by okdana) * [WebUI] add "pointer" cursor for sortable columns (issue #704 by @notFloran) * [WebUI] Make web page title configurable (issue #724) * Do not show interface in down state (issue #765) * InfluxDB > 0.9.3 needs float and not int for numerical value (issue#749 and issue#750 by nicolargo) Bugs corrected: * Can't read sensors on a Thinkpad (issue #711) * InfluxDB/OpenTSDB: tag parsing broken (issue #713) * Grafana Dashboard outdated for InfluxDB 0.9.x (issue #648) * '--tree' breaks process filter on Debian 8 (issue #768) * Fix highlighting of process when it contains whitespaces (issue #546 by Alessio Sergi) * Fix RAID support in Python 3 (issue #793 by Alessio Sergi) * Use dict view objects to avoid issue (issue #758 by Alessio Sergi) * System exit if Cpu not supported by the Cpuinfo lib (issue #754 by nicolargo) * KeyError: 'cpucore' when exporting data to InfluxDB (issue #729 by nicolargo) Others: * A new Glances docker container to monitor your Docker infrastructure is available here (issue #728): https://hub.docker.com/r/nicolargo/glances/ * Documentation is now generated automatically thanks to Sphinx and the Alessio Sergi patch (https://glances.readthedocs.io/en/latest/) Contributors summary: * Nicolas Hennion: 112 commits * Alessio Sergi: 55 commits * Floran Brutel: 19 commits * Nicolas Hart: 8 commits * @desbma: 4 commits * @dana: 2 commits * Damien Martin, Raju Kadam, @georgewhewell: 1 commit Version 2.5.1 ============= Bugs corrected: * Unable to unlock password protected servers in browser mode bug (issue #694) * Correct issue when Glances is started in console on Windows OS * [WebUI] when alert is ongoing hide level enhancement (issue #692) Version 2.5 =========== Enhancements and new features: * Allow export of Docker and sensors plugins stats to InfluxDB, StatsD... (issue #600) * Docker plugin shows IO and network bitrate (issue #520) * Server password configuration for the browser mode (issue #500) * Add support for OpenTSDB export (issue #638) * Add additional stats (iowait, steal) to the perCPU plugin (issue #672) * Support Fahrenheit unit in the sensor plugin using the --fahrenheit command line option (issue #620) * When a process filter is set, display sum of CPU, MEM... (issue #681) * Improve the QuickLookplugin by adding hardware CPU info (issue #673) * WebUI display a message if server is not available (issue #564) * Display an error if export is not used in the standalone/client mode (issue #614) * New --disable-quicklook, --disable-cpu, --disable-mem, --disable-swap, --disable-load tags (issue #631) * Complete refactoring of the WebUI thanks to the (awesome) Floran pull (issue #656) * Network cumulative /combination feature available in the WebUI (issue #552) * IRIX mode off implementation (issue#628) * Short process name displays arguments (issue #609) * Server password configuration for the browser mode (issue #500) * Display an error if export is not used in the standalone/client mode (issue #614) Bugs corrected: * The WebUI displays bad sensors stats (issue #632) * Filter processes crashes with a bad regular expression pattern (issue #665) * Error with IP plugin (issue #651) * Crach with Docker plugin (issue #649) * Docker plugin crashes with webserver mode (issue #654) * Infrequently crashing due to assert (issue #623) * Value for free disk space is counterintuative on ext file systems (issue #644) * Try/catch for unexpected psutil.NoSuchProcess: process no longer exists (issue #432) * Fatal error using Python 3.4 and Docker plugin bug (issue #602) * Add missing new line before g man option (issue #595) * Remove unnecessary type="text/css" for link (HTML5) (issue #595) * Correct server mode issue when no network interface is available (issue #528) * Avoid crach on olds kernels (issue #554) * Avoid crashing if LC_ALL is not defined by user (issue #517) * Add a disable HDD temperature option on the command line (issue #515) Version 2.4.2 ============= Bugs corrected: * Process no longer exists (again) (issue #613) * Crash when "top extended stats" is enabled on OS X (issue #612) * Graphical percentage bar displays "?" (issue #608) * Quick look doesn't work (issue #605) * [Web UI] Display empty Battery sensors enhancement (issue #601) * [Web UI] Per CPU plugin has to be improved (issue #566) Version 2.4.1 ============= Bugs corrected: * Fatal error using Python 3.4 and Docker plugin bug (issue #602) Version 2.4 =========== Changes: * Glances doesn't provide a system-wide configuration file by default anymore. Just copy it in any of the supported locations. See glances-doc.html for more information. (issue #541) * The default key bindings have been changed to: - 'u': sort processes by USER - 'U': show cumulative network I/O * No more translations Enhancements and new features: * The Web user interface is now based on AngularJS (issue #473, #508, #468) * Implement a 'quick look' plugin (issue #505) * Add sort processes by USER (issue #531) * Add a new IP information plugin (issue #509) * Add RabbitMQ export module (issue #540 Thk to @Katyucha) * Add a quiet mode (-q), can be useful using with export module * Grab FAN speed in the Glances sensors plugin (issue #501) * Allow logical mounts points in the FS plugin (issue #448) * Add a --disable-hddtemp to disable HDD temperature module at startup (issue #515) * Increase alert minimal delay to 6 seconds (issue #522) * If the Curses application raises an exception, restore the terminal correctly (issue #537) Bugs corrected: * Monitor list, all processes are take into account (issue #507) * Duplicated --enable-history in the doc (issue #511) * Sensors title is displayed if no sensors are detected (issue #510) * Server mode issue when no network interface is available (issue #528) * DEBUG mode activated by default with Python 2.6 (issue #512) * Glances display of time trims the hours showing only minutes and seconds (issue #543) * Process list header not decorating when sorting by command (issue #551) Version 2.3 =========== Enhancements and new features: * Add the Docker plugin (issue #440) with per container CPU and memory monitoring (issue #490) * Add the RAID plugin (issue #447) * Add actions on alerts (issue #132). It is now possible to run action (command line) by triggers. Action could contain {{tag}} (Mustache) with stat value. * Add InfluxDB export module (--export-influxdb) (issue #455) * Add StatsD export module (--export-statsd) (issue #465) * Refactor export module (CSV export option is now --export-csv). It is now possible to export stats from the Glances client mode (issue #463) * The Web interface is now based on Bootstrap / RWD grid (issue #417, #366 and #461) Thanks to Nicolas Hart @nclsHart * It is now possible, through the configuration file, to define if an alarm should be logged or not (using the _log option) (issue #437) * You can now set alarm for Disk IO * API: add getAllLimits and getAllViews methods (issue #481) and allow CORS request (issue #479) * SNMP client support NetApp appliance (issue #394) Bugs corrected: * R/W error with the glances.log file (issue #474) Other enhancement: * Alert < 3 seconds are no longer displayed Version 2.2.1 ============= * Fix incorrect kernel thread detection with --hide-kernel-threads (issue #457) * Handle IOError exception if no /etc/os-release to use Glances on Synology DSM (issue #458) * Check issue error in client/server mode (issue #459) Version 2.2 =========== Enhancements and new features: * Add centralized curse interface with a Glances servers list to monitor (issue #418) * Add processes tree view (--tree) (issue #444) * Improve graph history feature (issue #69) * Extended stats is disable by default (use --enable-process-extended to enable it - issue #430) * Add a short key ('F') and a command line option (--fs-free-space) to display FS free space instead of used space (issue #411) * Add a short key ('2') and a command line option (--disable-left-sidebar) to disable/enable the side bar (issue #429) * Add CPU times sort short key ('t') in the curse interface (issue #449) * Refactor operating system detection for GNU/Linux operating system * Code optimization Bugs corrected: * Correct a bug with Glances pip install --user (issue #383) * Correct issue on battery stat update (issue #433) * Correct issue on process no longer exist (issues #414 and #432) Version 2.1.2 ============= Maintenance version (only needed for Mac OS X). Bugs corrected: * Mac OS X: Error if Glances is not ran with sudo (issue #426) Version 2.1.1 ============= Enhancement: * Automatically compute top processes number for the current screen (issue #408) * CPU and Memory footprint optimization (issue #401) Bugs corrected: * Mac OS X 10.9: Exception at start (issue #423) * Process no longer exists (issue #421) * Error with Glances Client with Python 3.4.1 (issue #419) * TypeError: memory_maps() takes exactly 2 arguments (issue #413) * No filesystem information since Glances 2.0 bug enhancement (issue #381) Version 2.1 =========== * Add user process filter feature User can define a process filter pattern (as a regular expression). The pattern could be defined from the command line (-f ) or by pressing the ENTER key in the curse interface. For the moment, process filter feature is only available in standalone mode. * Add extended processes information for top process Top process stats availables: CPU affinity, extended memory information (shared, text, lib, datat, dirty, swap), open threads/files and TCP/UDP network sessions, IO nice level For the moment, extended processes stats are only available in standalone mode. * Add --process-short-name tag and '/' key to switch between short/command line * Create a max_processes key in the configuration file The goal is to reduce the number of displayed processes in the curses UI and so limit the CPU footprint of the Glances standalone mode. The API always return all the processes, the key is only active in the curses UI. If the key is not define, all the processes will be displayed. The default value is 20 (processes displayed). For the moment, this feature is only available in standalone mode. * Alias for network interfaces, disks and sensors Users can configure alias from the Glances configuration file. * Add Glances log message (in the /tmp/glances.log file) The default log level is INFO, you can switch to the DEBUG mode using the -d option on the command line. * Add RESTful API to the Web server mode RESTful API doc: https://github.com/nicolargo/glances/wiki/The-Glances-RESTFUL-JSON-API * Improve SNMP fallback mode for Cisco IOS, VMware ESXi * Add --theme-white feature to optimize display for white background * Experimental history feature (--enable-history option on the command line) This feature allows users to generate graphs within the curse interface. Graphs are available for CPU, LOAD and MEM. To generate graph, click on the 'g' key. To reset the history, press the 'r' key. Note: This feature uses the matplotlib library. * CI: Improve Travis coverage Bugs corrected: * Quitting glances leaves a column layout to the current terminal (issue #392) * Glances crashes with malformed UTF-8 sequences in process command lines (issue #391) * SNMP fallback mode is not Python 3 compliant (issue #386) * Trouble using batinfo, hddtemp, pysensors w/ Python (issue #324) Version 2.0.1 ============= Maintenance version. Bugs corrected: * Error when displaying numeric process user names (#380) * Display users without username correctly (#379) * Bug when parsing configuration file (#378) * The sda2 partition is not seen by glances (#376) * Client crash if server is ended during XML request (#375) * Error with the Sensors module on Debian/Ubuntu (#373) * Windows don't view all processes (#319) Version 2.0 =========== Glances v2.0 is not a simple upgrade of the version 1.x but a complete code refactoring. Based on a plugins system, it aims at providing an easy way to add new features. - Core defines the basics and commons functions. - all stats are grabbed through plugins (see the glances/plugins source folder). - also outputs methods (Curse, Web mode, CSV) are managed as plugins. The Curse interface is almost the same than the version 1.7. Some improvements have been made: - space optimisation for the CPU, LOAD and MEM stats (justified alignment) - CPU: . CPU stats are displayed as soon as Glances is started . steal CPU alerts are no more logged - LOAD: . 5 min LOAD alerts are no more logged - File System: . Display the device name (if space is available) - Sensors: . Sensors and HDD temperature are displayed in the same block - Process list: . Refactor columns: CPU%, MEM%, VIRT, RES, PID, USER, NICE, STATUS, TIME, IO, Command/name . The running processes status is highlighted . The process name is highlighted in the command line Glances 2.0 brings a brand new Web Interface. You can run Glances in Web server mode and consult the stats directly from a standard Web Browser. The client mode can now fallback to a simple SNMP mode if Glances server is not found on the remote machine. Complete release notes: * Cut ifName and DiskName if they are too long in the curses interface (by Nicolargo) * Windows CLI is OK but early experimental (by Nicolargo) * Add bitrate limits to the networks interfaces (by Nicolargo) * Batteries % stats are now in the sensors list (by Nicolargo) * Refactor the client/server password security: using SHA256 (by Nicolargo, based on Alessio Sergi's example script) * Refactor the CSV output (by Nicolargo) * Glances client fallback to SNMP server if Glances one not found (by Nicolargo) * Process list: Highlight running/basename processes (by Alessio Sergi) * New Web server mode thk to the Bottle library (by Nicolargo) * Responsive design for Bottle interface (by Nicolargo) * Remove HTML output (by Nicolargo) * Enable/disable for optional plugins through the command line (by Nicolargo) * Refactor the API (by Nicolargo) * Load-5 alert are no longer logged (by Nicolargo) * Rename In/Out by Read/Write for DiskIO according to #339 (by Nicolargo) * Migrate from pysensors to py3sensors (by Alessio Sergi) * Migration to psutil 2.x (by Nicolargo) * New plugins system (by Nicolargo) * Python 2.x and 3.x compatibility (by Alessio Sergi) * Code quality improvements (by Alessio Sergi) * Refactor unitaries tests (by Nicolargo) * Development now follow the git flow workflow (by Nicolargo) ============================================================================== Glances Version 1 ============================================================================== Version 1.7.7 ============= * Fix CVS export [issue #348] * Adapt to psutil 2.1.1 * Compatibility with Python 3.4 * Improve German update Version 1.7.6 ============= * Adapt to psutil 2.0.0 API * Fixed psutil 0.5.x support on Windows * Fix help screen in 80x24 terminal size * Implement toggle of process list display ('z' key) Version 1.7.5 ============= * Force the PyPI installer to use the psutil branch 1.x (#333) Version 1.7.4 ============= * Add threads number in the task summary line (#308) * Add system uptime (#276) * Add CPU steal % to cpu extended stats (#309) * You can hide disk from the IOdisk view using the conf file (#304) * You can hide network interface from the Network view using the conf file * Optimisation of CPU consumption (around ~10%) * Correct issue #314: Client/server mode always asks for password * Correct issue #315: Defining password in client/server mode doesn't work as intended * Correct issue #316: Crash in client server mode * Correct issue #318: Argument parser, try-except blocks never get triggered Version 1.7.3 ============= * Add --password argument to enter the client/server password from the prompt * Fix an issue with the configuration file path (#296) * Fix an issue with the HTML template (#301) Version 1.7.2 ============= * Console interface is now Microsoft Windows compatible (thk to @fraoustin) * Update documentation and Wiki regarding the API * Added package name for python sources/headers in openSUSE/SLES/SLED * Add FreeBSD packager * Bugs corrected Version 1.7.1 ============= * Fix IoWait error on FreeBSD / Mac OS * HDDTemp module is now Python v3 compatible * Don't warn a process is not running if countmin=0 * Add PyPI badge on the README.rst * Update documentation * Add document structure for http://readthedocs.org Version 1.7 =========== * Add monitored processes list * Add hard disk temperature monitoring (thanks to the HDDtemp daemon) * Add batteries capacities information (thanks to the Batinfo lib) * Add command line argument -r toggles processes (reduce CPU usage) * Add command line argument -1 to run Glances in per CPU mode * Platform/architecture is more specific now * XML-RPC server: Add IPv6 support for the client/server mode * Add support for local conf file * Add a uninstall script * Add getNetTimeSinceLastUpdate() getDiskTimeSinceLastUpdate() and getProcessDiskTimeSinceLastUpdate() in the API * Add more translation: Italien, Chinese * and last but not least... up to 100 hundred bugs corrected / software and * docs improvements Version 1.6.1 ============= * Add per-user settings (configuration file) support * Add -z/--nobold option for better appearance under Solarized terminal * Key 'u' shows cumulative net traffic * Work in improving autoUnit * Take into account the number of core in the CPU process limit * API improvement add time_since_update for disk, process_disk and network * Improve help display * Add more dummy FS to the ignore list * Code refactory: psutil < 0.4.1 is deprecated (Thk to Alessio) * Correct a bug on the CPU process limit * Fix crash bug when specifying custom server port * Add Debian style init script for the Glances server Version 1.6 =========== * Configuration file: user can defines limits * In client/server mode, limits are set by the server side * Display limits in the help screen * Add per process IO (read and write) rate in B per second IO rate only available on Linux from a root account * If CPU iowait alert then sort by processes by IO rate * Per CPU display IOwait (if data is available) * Add password for the client/server mode (-P password) * Process column style auto (underline) or manual (bold) * Display a sort indicator (is space is available) * Change the table key in the help screen Version 1.5.2 ============= * Add sensors module (enable it with -e option) * Improve CPU stats (IO wait, Nice, IRQ) * More stats in lower space (yes it's possible) * Refactor processes list and count (lower CPU/MEM footprint) * Add functions to the RCP method * Completed unit test * and fixes... Version 1.5.1 ============= * Patch for psutil 0.4 compatibility * Test psutil version before running Glances Version 1.5 =========== * Add a client/server mode (XMLRPC) for remote monitoring * Correct a bug on process IO with non root users * Add 'w' shortkey to delete finished warning message * Add 'x' shortkey to delete finished warning/critical message * Bugs correction * Code optimization Version 1.4.2.2 =============== * Add switch between bit/sec and byte/sec for network IO * Add Changelog (generated with gitchangelog) Version 1.4.2.1 =============== * Minor patch to solve memomy issue (#94) on Mac OS X Version 1.4.2 ============= * Use the new virtual_memory() and virtual_swap() fct (psutil) * Display "Top process" in logs * Minor patch on man page for Debian packaging * Code optimization (less try and except) Version 1.4.1.1 =============== * Minor patch to disable Process IO for OS X (not available in psutil) Version 1.4.1 ============= * Per core CPU stats (if space is available) * Add Process IO Read/Write information (if space is available) * Uniformize units Version 1.4 =========== * Goodby StatGrab... Welcome to the psutil library ! * No more autotools, use setup.py to install (or package) * Only major stats (CPU, Load and memory) use background colors * Improve operating system name detection * New system info: one-line layout and add Arch Linux support * No decimal places for values < GB * New memory and swap layout * Add percentage of usage for both memory and swap * Add MEM% usage, NICE, STATUS, UID, PID and running TIME per process * Add sort by MEM% ('m' key) * Add sort by Process name ('p' key) * Multiple minor fixes, changes and improvements * Disable Disk IO module from the command line (-d) * Disable Mount module from the command line (-m) * Disable Net rate module from the command line (-n) * Improved FreeBSD support * Cleaning code and style * Code is now checked with pep8 * CSV and HTML output (experimental functions, no yet documentation) Version 1.3.7 ============= * Display (if terminal space is available) an alerts history (logs) * Add a limits class to manage stats limits * Manage black and white console (issue #31) Version 1.3.6 ============= * Add control before libs import * Change static Python path (issue #20) * Correct a bug with a network interface disaippear (issue #27) * Add French and Spanish translation (thx to Jean Bob) Version 1.3.5 ============= * Add an help panel when Glances is running (key: 'h') * Add keys descriptions in the syntax (--help | -h) Version 1.3.4 ============= * New key: 'n' to enable/disable network stats * New key: 'd' to enable/disable disk IO stats * New key: 'f' to enable/disable FS stats * Reorganised the screen when stat are not available|disable * Force Glances to use the enmbeded fs stats (issue #16) Version 1.3.3 ============= * Automatically switch between process short and long name * Center the host / system information * Always put the hour/date in the bottom/right * Correct a bug if there is a lot of Disk/IO * Add control about available libstatgrab functions Version 1.3.2 ============= * Add alert for network bit rate° * Change the caption * Optimised net, disk IO and fs display (share the space) Disable on Ubuntu because the libstatgrab return a zero value for the network interface speed. Version 1.3.1 ============= * Add alert on load (depend on number of CPU core) * Fix bug when the FS list is very long Version 1.3 =========== * Add file system stats (total and used space) * Adapt unit dynamically (K, M, G) * Add man page (Thanks to Edouard Bourguignon) Version 1.2 =========== * Resize the terminal and the windows are adapted dynamically * Refresh screen instantanetly when a key is pressed Version 1.1.3 ============= * Add disk IO monitoring * Add caption * Correct a bug when computing the bitrate with the option -t * Catch CTRL-C before init the screen (Bug #2) * Check if mem.total = 0 before division (Bug #1) ================================================ FILE: README-pypi.rst ================================================ Glances 🌟 ========== **Glances** is an open-source system cross-platform monitoring tool. It allows real-time monitoring of various aspects of your system such as CPU, memory, disk, network usage etc. It also allows monitoring of running processes, logged in users, temperatures, voltages, fan speeds etc. It also supports container monitoring, it supports different container management systems such as Docker, LXC. The information is presented in an easy to read dashboard and can also be used for remote monitoring of systems via a web interface or command line interface. It is easy to install and use and can be customized to show only the information that you are interested in. In client/server mode, remote monitoring could be done via terminal, Web interface or API (XML-RPC and RESTful). Stats can also be exported to files or external time/value databases, CSV or direct output to STDOUT. Glances is written in Python and uses libraries to grab information from your system. It is based on an open architecture where developers can add new plugins or exports modules. Usage 👋 ======== For the standalone mode, just run: .. code-block:: console $ glances .. image:: https://github.com/nicolargo/glances/raw/refs/heads/master/docs/_static/glances-responsive-webdesign.png For the Web server mode, run: .. code-block:: console $ glances -w and enter the URL ``http://:61208`` in your favorite web browser. In this mode, a HTTP/Restful API is exposed, see document `RestfulApi`_ for more details. .. image:: https://github.com/nicolargo/glances/raw/refs/heads/master/docs/_static/screenshot-web.png For the client/server mode (remote monitoring through XML-RPC), run the following command on the server: .. code-block:: console $ glances -s and this one on the client: .. code-block:: console $ glances -c You can also detect and display all Glances servers available on your network (or defined in the configuration file) in TUI: .. code-block:: console $ glances --browser or WebUI: .. code-block:: console $ glances -w --browser It possible to display raw stats on stdout: .. code-block:: console $ glances --stdout cpu.user,mem.used,load cpu.user: 30.7 mem.used: 3278204928 load: {'cpucore': 4, 'min1': 0.21, 'min5': 0.4, 'min15': 0.27} cpu.user: 3.4 mem.used: 3275251712 load: {'cpucore': 4, 'min1': 0.19, 'min5': 0.39, 'min15': 0.27} ... or in a CSV format thanks to the stdout-csv option: .. code-block:: console $ glances --stdout-csv now,cpu.user,mem.used,load now,cpu.user,mem.used,load.cpucore,load.min1,load.min5,load.min15 2018-12-08 22:04:20 CEST,7.3,5948149760,4,1.04,0.99,1.04 2018-12-08 22:04:23 CEST,5.4,5949136896,4,1.04,0.99,1.04 ... or in a JSON format thanks to the stdout-json option (attribute not supported in this mode in order to have a real JSON object in output): .. code-block:: console $ glances --stdout-json cpu,mem cpu: {"total": 29.0, "user": 24.7, "nice": 0.0, "system": 3.8, "idle": 71.4, "iowait": 0.0, "irq": 0.0, "softirq": 0.0, "steal": 0.0, "guest": 0.0, "guest_nice": 0.0, "time_since_update": 1, "cpucore": 4, "ctx_switches": 0, "interrupts": 0, "soft_interrupts": 0, "syscalls": 0} mem: {"total": 7837949952, "available": 2919079936, "percent": 62.8, "used": 4918870016, "free": 2919079936, "active": 2841214976, "inactive": 3340550144, "buffers": 546799616, "cached": 3068141568, "shared": 788156416} ... Last but not least, you can use the fetch mode to get a quick look of a machine: .. code-block:: console $ glances --fetch Results look like this: .. image:: https://github.com/nicolargo/glances/raw/refs/heads/master/docs/_static/screenshot-fetch.png Use Glances as a Python library 📚 ================================== You can access the Glances API by importing the `glances.api` module and creating an instance of the `GlancesAPI` class. This instance provides access to all Glances plugins and their fields. For example, to access the CPU plugin and its total field, you can use the following code: .. code-block:: python >>> from glances import api >>> gl = api.GlancesAPI() >>> gl.cpu {'cpucore': 16, 'ctx_switches': 1214157811, 'guest': 0.0, 'idle': 91.4, 'interrupts': 991768733, 'iowait': 0.3, 'irq': 0.0, 'nice': 0.0, 'soft_interrupts': 423297898, 'steal': 0.0, 'syscalls': 0, 'system': 5.4, 'total': 7.3, 'user': 3.0} >>> gl.cpu["total"] 7.3 >>> gl.mem["used"] 12498582144 >>> gl.auto_unit(gl.mem["used"]) 11.6G If the stats return a list of items (like network interfaces or processes), you can access them by their name: .. code-block:: python >>> gl.network.keys() ['wlp0s20f3', 'veth33b370c', 'veth19c7711'] >>> gl.network["wlp0s20f3"] {'alias': None, 'bytes_all': 362, 'bytes_all_gauge': 9242285709, 'bytes_all_rate_per_sec': 1032.0, 'bytes_recv': 210, 'bytes_recv_gauge': 7420522678, 'bytes_recv_rate_per_sec': 599.0, 'bytes_sent': 152, 'bytes_sent_gauge': 1821763031, 'bytes_sent_rate_per_sec': 433.0, 'interface_name': 'wlp0s20f3', 'key': 'interface_name', 'speed': 0, 'time_since_update': 0.3504955768585205} For a complete example of how to use Glances as a library, have a look to the `PythonApi`_. Documentation 📜 ================ For complete documentation have a look at the readthedocs_ website. If you have any question (after RTFM! and the `FAQ`_), please post it on the official Reddit `forum`_ or in GitHub `Discussions`_. Gateway to other services 🌐 ============================ Glances can export stats to: - ``CSV`` file - ``JSON`` file - ``InfluxDB`` server - ``Cassandra`` server - ``CouchDB`` server - ``OpenTSDB`` server - ``Prometheus`` server - ``StatsD`` server - ``ElasticSearch`` server - ``PostgreSQL/TimeScale`` server - ``RabbitMQ/ActiveMQ`` broker - ``ZeroMQ`` broker - ``Kafka`` broker - ``Riemann`` server - ``Graphite`` server - ``RESTful`` endpoint Installation 🚀 =============== There are several methods to test/install Glances on your system. Choose your weapon! PyPI: Pip, the standard way --------------------------- Glances is on ``PyPI``. By using PyPI, you will be using the latest stable version. To install Glances, simply use the ``pip`` command line. Warning: on modern Linux operating systems, you may have an externally-managed-environment error message when you try to use ``pip``. In this case, go to the the PipX section below. .. code-block:: console pip install --user glances *Note*: Python headers are required to install `psutil`_, a Glances dependency. For example, on Debian/Ubuntu **the simplest** is ``apt install python3-psutil`` or alternatively need to install first the *python-dev* package and gcc (*python-devel* on Fedora/CentOS/RHEL). For Windows, just install psutil from the binary installation file. By default, Glances is installed **without** the Web interface dependencies. To install it, use the following command: .. code-block:: console pip install --user 'glances[web]' For a full installation (with all features, see features list bellow): .. code-block:: console pip install --user 'glances[all]' Features list: - all: install dependencies for all features - action: install dependencies for action feature - browser: install dependencies for Glances centram browser - cloud: install dependencies for cloud plugin - containers: install dependencies for container plugin - export: install dependencies for all exports modules - gpu: install dependencies for GPU plugin - graph: install dependencies for graph export - ip: install dependencies for IP public option - raid: install dependencies for RAID plugin - sensors: install dependencies for sensors plugin - smart: install dependencies for smart plugin - snmp: install dependencies for SNMP - sparklines: install dependencies for sparklines option - web: install dependencies for Webserver (WebUI) and Web API - wifi: install dependencies for Wifi plugin To upgrade Glances to the latest version: .. code-block:: console pip install --user --upgrade glances The current develop branch is published to the test.pypi.org package index. If you want to test the develop version (could be instable), enter: .. code-block:: console pip install --user -i https://test.pypi.org/simple/ Glances PyPI: PipX, the alternative way ------------------------------- Install PipX on your system (apt install pipx on Ubuntu). Install Glances (with all features): .. code-block:: console pipx install 'glances[all]' The glances script will be installed in the ~/.local/bin folder. Shell tab completion 🔍 ======================= Glances 4.3.2 and higher includes shell tab autocompletion thanks to the --print-completion option. For example, on a Linux operating system with bash shell: .. code-block:: console $ mkdir -p ${XDG_DATA_HOME:="$HOME/.local/share"}/bash-completion $ glances --print-completion bash > ${XDG_DATA_HOME:="$HOME/.local/share"}/bash-completion/glances $ source ${XDG_DATA_HOME:="$HOME/.local/share"}/bash-completion/glances Following shells are supported: bash, zsh and tcsh. Requirements 🧩 =============== Glances is developed in Python. A minimal Python version 3.10 or higher should be installed on your system. *Note for Python 2 users* Glances version 4 or higher do not support Python 2 (and Python 3 < 3.10). Please uses Glances version 3.4.x if you need Python 2 support. Dependencies: - ``psutil`` (better with latest version) - ``defusedxml`` (in order to monkey patch xmlrpc) - ``packaging`` (for the version comparison) - ``windows-curses`` (Windows Curses implementation) [Windows-only] - ``shtab`` (Shell autocompletion) [All but Windows] - ``jinja2`` (for fetch mode and templating) Extra dependencies: - ``batinfo`` (for battery monitoring) - ``bernhard`` (for the Riemann export module) - ``cassandra-driver`` (for the Cassandra export module) - ``chevron`` (for the action script feature) - ``docker`` (for the Containers Docker monitoring support) - ``elasticsearch`` (for the Elastic Search export module) - ``FastAPI`` and ``Uvicorn`` (for Web server mode) - ``graphitesender`` (For the Graphite export module) - ``hddtemp`` (for HDD temperature monitoring support) [Linux-only] - ``influxdb`` (for the InfluxDB version 1 export module) - ``influxdb-client`` (for the InfluxDB version 2 export module) - ``kafka-python`` (for the Kafka export module) - ``nvidia-ml-py`` (for the GPU plugin) - ``pycouchdb`` (for the CouchDB export module) - ``pika`` (for the RabbitMQ/ActiveMQ export module) - ``podman`` (for the Containers Podman monitoring support) - ``potsdb`` (for the OpenTSDB export module) - ``prometheus_client`` (for the Prometheus export module) - ``pylxd`` (for the LXC Containers monitoring support) - ``psycopg[binary]`` (for the PostgreSQL/TimeScale export module) - ``pygal`` (for the graph export module) - ``pymdstat`` (for RAID support) [Linux-only] - ``pymongo`` (for the MongoDB export module) - ``pysnmp-lextudio`` (for SNMP support) - ``pySMART.smartx`` (for HDD Smart support) [Linux-only] - ``pyzmq`` (for the ZeroMQ export module) - ``requests`` (for the Ports, Cloud plugins and RESTful export module) - ``sparklines`` (for the Quick Plugin sparklines option) - ``statsd`` (for the StatsD export module) - ``wifi`` (for the wifi plugin) [Linux-only] - ``zeroconf`` (for the autodiscover mode) Project sponsorship 🙌 ====================== You can help me to achieve my goals of improving this open-source project or just say "thank you" by: - sponsor me using one-time or monthly tier Github sponsors_ page - send me some pieces of bitcoin: 185KN9FCix3svJYp7JQM7hRMfSKyeaJR4X - buy me a gift on my wishlist_ page Any and all contributions are greatly appreciated. Authors and Contributors 🔥 =========================== Nicolas Hennion (@nicolargo) .. image:: https://img.shields.io/twitter/url/https/twitter.com/cloudposse.svg?style=social&label=Follow%20%40nicolargo :target: https://twitter.com/nicolargo License 📜 ========== Glances is distributed under the LGPL version 3 license. See ``COPYING`` for more details. .. _psutil: https://github.com/giampaolo/psutil .. _readthedocs: https://glances.readthedocs.io/ .. _forum: https://www.reddit.com/r/glances/ .. _sponsors: https://github.com/sponsors/nicolargo .. _wishlist: https://www.amazon.fr/hz/wishlist/ls/BWAAQKWFR3FI?ref_=wl_share .. _PythonApi: https://glances.readthedocs.io/en/develop/api/python.html .. _RestfulApi: https://glances.readthedocs.io/en/develop/api/restful.html .. _FAQ: https://github.com/nicolargo/glances/blob/develop/docs/faq.rst .. _Discussions: https://github.com/nicolargo/glances/discussions ================================================ FILE: README.rst ================================================ .. raw:: html
.. image:: ./docs/_static/glances-responsive-webdesign.png .. raw:: html

Glances

An Eye on your System | |pypi| |test| |contributors| |quality| | |starts| |docker| |pypistat| |sponsors| | |reddit| .. |pypi| image:: https://img.shields.io/pypi/v/glances.svg :target: https://pypi.python.org/pypi/Glances .. |starts| image:: https://img.shields.io/github/stars/nicolargo/glances.svg :target: https://github.com/nicolargo/glances/ :alt: Github stars .. |docker| image:: https://img.shields.io/docker/pulls/nicolargo/glances :target: https://hub.docker.com/r/nicolargo/glances/ :alt: Docker pull .. |pypistat| image:: https://pepy.tech/badge/glances/month :target: https://pepy.tech/project/glances :alt: Pypi downloads .. |test| image:: https://github.com/nicolargo/glances/actions/workflows/ci.yml/badge.svg?branch=develop :target: https://github.com/nicolargo/glances/actions :alt: Linux tests (GitHub Actions) .. |contributors| image:: https://img.shields.io/github/contributors/nicolargo/glances :target: https://github.com/nicolargo/glances/issues?q=is%3Aissue+is%3Aopen+label%3A%22needs+contributor%22 :alt: Contributors .. |quality| image:: https://scrutinizer-ci.com/g/nicolargo/glances/badges/quality-score.png?b=develop :target: https://scrutinizer-ci.com/g/nicolargo/glances/?branch=develop :alt: Code quality .. |sponsors| image:: https://img.shields.io/github/sponsors/nicolargo :target: https://github.com/sponsors/nicolargo :alt: Sponsors .. |twitter| image:: https://img.shields.io/badge/X-000000?style=for-the-badge&logo=x&logoColor=white :target: https://twitter.com/nicolargo :alt: @nicolargo .. |reddit| image:: https://img.shields.io/badge/Reddit-FF4500?style=for-the-badge&logo=reddit&logoColor=white :target: https://www.reddit.com/r/glances/ :alt: @reddit .. raw:: html
Summary 🌟 ========== **Glances** is an open-source system cross-platform monitoring tool. It allows real-time monitoring of various aspects of your system such as CPU, memory, disk, network usage etc. It also allows monitoring of running processes, logged in users, temperatures, voltages, fan speeds etc. It also supports container monitoring, it supports different container management systems such as Docker, LXC. The information is presented in an easy to read dashboard and can also be used for remote monitoring of systems via a web interface or command line interface. It is easy to install and use and can be customized to show only the information that you are interested in. In client/server mode, remote monitoring could be done via terminal, Web interface or API (XML-RPC and RESTful). Stats can also be exported to files or external time/value databases, CSV or direct output to STDOUT. AI assistants (Claude, Cursor, …) can query Glances directly through the built-in MCP server (available in Glances 4.5.1 and higher). Glances is written in Python and uses libraries to grab information from your system. It is based on an open architecture where developers can add new plugins or exports modules. Usage 👋 ======== For the standalone mode, just run: .. code-block:: console $ glances .. image:: ./docs/_static/glances-summary.png For the Web server mode, run: .. code-block:: console $ glances -w and enter the URL ``http://:61208`` in your favorite web browser. In this mode, a HTTP/Restful API is exposed, see document `RestfulApi`_ for more details. .. image:: ./docs/_static/screenshot-web.png To also expose a `MCP (Model Context Protocol)`_ server (for AI assistants), add ``--enable-mcp``: .. code-block:: console $ glances -w --enable-mcp The MCP endpoint (SSE transport) is then available at ``http://:61208/mcp/sse``. See the `McpApi`_ documentation for client configuration and usage. You can also detect and display all Glances servers available on your network (or defined in the configuration file) in TUI: .. code-block:: console $ glances --browser or WebUI: .. code-block:: console $ glances -w --browser It possible to display raw stats on stdout: .. code-block:: console $ glances --stdout cpu.user,mem.used,load cpu.user: 30.7 mem.used: 3278204928 load: {'cpucore': 4, 'min1': 0.21, 'min5': 0.4, 'min15': 0.27} cpu.user: 3.4 mem.used: 3275251712 load: {'cpucore': 4, 'min1': 0.19, 'min5': 0.39, 'min15': 0.27} ... or in a CSV format thanks to the stdout-csv option: .. code-block:: console $ glances --stdout-csv now,cpu.user,mem.used,load now,cpu.user,mem.used,load.cpucore,load.min1,load.min5,load.min15 2018-12-08 22:04:20 CEST,7.3,5948149760,4,1.04,0.99,1.04 2018-12-08 22:04:23 CEST,5.4,5949136896,4,1.04,0.99,1.04 ... or in a JSON format thanks to the stdout-json option (attribute not supported in this mode in order to have a real JSON object in output): .. code-block:: console $ glances --stdout-json cpu,mem cpu: {"total": 29.0, "user": 24.7, "nice": 0.0, "system": 3.8, "idle": 71.4, "iowait": 0.0, "irq": 0.0, "softirq": 0.0, "steal": 0.0, "guest": 0.0, "guest_nice": 0.0, "time_since_update": 1, "cpucore": 4, "ctx_switches": 0, "interrupts": 0, "soft_interrupts": 0, "syscalls": 0} mem: {"total": 7837949952, "available": 2919079936, "percent": 62.8, "used": 4918870016, "free": 2919079936, "active": 2841214976, "inactive": 3340550144, "buffers": 546799616, "cached": 3068141568, "shared": 788156416} ... Last but not least, you can use the fetch mode to get a quick look of a machine: .. code-block:: console $ glances --fetch Results look like this: .. image:: ./docs/_static/screenshot-fetch.png For the record, Glances also have a XML-RPC client/server mode, run the following command on the server: .. code-block:: console $ glances -s and this one on the client: .. code-block:: console $ glances -c Use Glances as a Python library 📚 ================================== You can access the Glances API by importing the `glances.api` module and creating an instance of the `GlancesAPI` class. This instance provides access to all Glances plugins and their fields. For example, to access the CPU plugin and its total field, you can use the following code: .. code-block:: python >>> from glances import api >>> gl = api.GlancesAPI() >>> gl.cpu {'cpucore': 16, 'ctx_switches': 1214157811, 'guest': 0.0, 'idle': 91.4, 'interrupts': 991768733, 'iowait': 0.3, 'irq': 0.0, 'nice': 0.0, 'soft_interrupts': 423297898, 'steal': 0.0, 'syscalls': 0, 'system': 5.4, 'total': 7.3, 'user': 3.0} >>> gl.cpu.get("total") 7.3 >>> gl.mem.get("used") 12498582144 >>> gl.auto_unit(gl.mem.get("used")) 11.6G If the stats return a list of items (like network interfaces or processes), you can access them by their name: .. code-block:: python >>> gl.network.keys() ['wlp0s20f3', 'veth33b370c', 'veth19c7711'] >>> gl.network.get("wlp0s20f3") {'alias': None, 'bytes_all': 362, 'bytes_all_gauge': 9242285709, 'bytes_all_rate_per_sec': 1032.0, 'bytes_recv': 210, 'bytes_recv_gauge': 7420522678, 'bytes_recv_rate_per_sec': 599.0, 'bytes_sent': 152, 'bytes_sent_gauge': 1821763031, 'bytes_sent_rate_per_sec': 433.0, 'interface_name': 'wlp0s20f3', 'key': 'interface_name', 'speed': 0, 'time_since_update': 0.3504955768585205} For a complete example of how to use Glances as a library, have a look to the `PythonApi`_. Documentation 📜 ================ For complete documentation have a look at the readthedocs_ website. If you have any question (after RTFM! and the `FAQ`_), please post it on the official Reddit `forum`_ or in GitHub `Discussions`_. Gateway to other services 🌐 ============================ Glances can export stats to: - files: ``CSV`` and ``JSON`` - databases: ``InfluxDB``, ``ElasticSearch``, ``PostgreSQL/TimeScale``, ``Cassandra``, ``CouchDB``, ``OpenTSDB``, ``Prometheus``, ``StatsD``, ``Riemann`` and ``Graphite`` - brokers: ``RabbitMQ/ActiveMQ``, ``NATS``, ``ZeroMQ`` and ``Kafka`` - others: ``RESTful`` endpoint Installation 🚀 =============== There are several methods to test/install Glances on your system. Choose your weapon! PyPI: Pip, the standard way --------------------------- Glances is on ``PyPI``. By using PyPI, you will be using the latest stable version. To install Glances, simply use the ``pip`` command line in an virtual environment. .. code-block:: console cd ~ python3 -m venv ~/.venv source ~/.venv/bin/activate pip install glances *Note*: Python headers are required to install `psutil`_, a Glances dependency. For example, on Debian/Ubuntu **the simplest** is ``apt install python3-psutil`` or alternatively need to install first the *python-dev* package and gcc (*python-devel* on Fedora/CentOS/RHEL). For Windows, just install psutil from the binary installation file. By default, Glances is installed **without** the Web interface dependencies. To install it, use the following command: .. code-block:: console pip install 'glances[web]' For a full installation (with all features, see features list bellow): .. code-block:: console pip install 'glances[all]' Features list: - all: install dependencies for all features - action: install dependencies for action feature - browser: install dependencies for Glances centram browser - cloud: install dependencies for cloud plugin - containers: install dependencies for container plugin - export: install dependencies for all exports modules - gpu: install dependencies for GPU plugin - graph: install dependencies for graph export - ip: install dependencies for IP public option - mcp: install dependencies for the MCP server (AI assistant integration) - raid: install dependencies for RAID plugin - sensors: install dependencies for sensors plugin - smart: install dependencies for smart plugin - snmp: install dependencies for SNMP - sparklines: install dependencies for sparklines option - web: install dependencies for Webserver (WebUI) and Web API - wifi: install dependencies for Wifi plugin To upgrade Glances to the latest version: .. code-block:: console pip install --upgrade glances UVx, the magic way ------------------ Install and run directly Glances with the one line: .. code-block:: console uvx glances Note: `Uv`_ should be installed on your system. PyPI: PipX, the alternative way ------------------------------- Install PipX on your system. For example on Ubuntu/Debian: .. code-block:: console sudo apt install pipx Then install Glances (with all features): .. code-block:: console pipx install 'glances[all]' The glances script will be installed in the ~/.local/bin folder. To upgrade Glances to the latest version: .. code-block:: console pipx upgrade glances Docker: the cloudy way ---------------------- Glances Docker images are available. You can use it to monitor your server and all your containers ! The following tags are available: - *latest-full* for a full Alpine Glances image (latest release) with all dependencies - *latest* for a basic Alpine Glances (latest release) version with minimal dependencies (FastAPI and Docker) - *dev* for a basic Alpine Glances image (based on development branch) with all dependencies (Warning: may be instable) - *ubuntu-latest-full* for a full Ubuntu Glances image (latest release) with all dependencies - *ubuntu-latest* for a basic Ubuntu Glances (latest release) version with minimal dependencies (FastAPI and Docker) - *ubuntu-dev* for a basic Ubuntu Glances image (based on development branch) with all dependencies (Warning: may be instable) Run last version of Glances container in *console mode*: .. code-block:: console docker run --rm -e TZ="${TZ}" -v /var/run/docker.sock:/var/run/docker.sock:ro -v /run/user/1000/podman/podman.sock:/run/user/1000/podman/podman.sock:ro --pid host --network host -it nicolargo/glances:latest-full By default, the /etc/glances/glances.conf file is used (based on docker-compose/glances.conf). Additionally, if you want to use your own glances.conf file, you can create your own Dockerfile: .. code-block:: console FROM nicolargo/glances:latest COPY glances.conf /root/.config/glances/glances.conf CMD python -m glances -C /root/.config/glances/glances.conf $GLANCES_OPT Alternatively, you can specify something along the same lines with docker run options (notice the `GLANCES_OPT` environment variable setting parameters for the glances startup command): .. code-block:: console docker run -e TZ="${TZ}" -v $HOME/.config/glances/glances.conf:/glances.conf:ro -v /var/run/docker.sock:/var/run/docker.sock:ro -v /run/user/1000/podman/podman.sock:/run/user/1000/podman/podman.sock:ro --pid host -e GLANCES_OPT="-C /glances.conf" -it nicolargo/glances:latest-full Where $HOME/.config/glances/glances.conf is a local directory containing your glances.conf file. Run the container in *Web server mode*: .. code-block:: console docker run -d --restart="always" -p 61208-61209:61208-61209 -e TZ="${TZ}" -e GLANCES_OPT="-w" -v /var/run/docker.sock:/var/run/docker.sock:ro -v /run/user/1000/podman/podman.sock:/run/user/1000/podman/podman.sock:ro --pid host nicolargo/glances:latest-full For a full list of options, see the Glances `Docker`_ documentation page. It is also possible to use a simple Docker compose file (see in ./docker-compose/docker-compose.yml): .. code-block:: console cd ./docker-compose docker-compose up It will start a Glances server with WebUI. Brew: The missing package manager --------------------------------- For Linux and Mac OS, it is also possible to install Glances with `Brew`_: .. code-block:: console brew install glances GNU/Linux package ----------------- `Glances` is available on many Linux distributions, so you should be able to install it using your favorite package manager. Nevetheless, i do not recommend it. Be aware that when you use this method the operating system `package`_ for `Glances` may not be the latest version and only basics plugins are enabled. Note: The Debian package (and all other Debian-based distributions) do not include anymore the JS statics files used by the Web interface (see ``issue2021``). If you want to add it to your Glances installation, follow the instructions: ``issue2021comment``. In Glances version 4 and higher, the path to the statics file is configurable (see ``issue2612``). FreeBSD ------- On FreeBSD, package name depends on the Python version. Check for Python version: .. code-block:: console # python --version Install the Glances package: .. code-block:: console # pkg install pyXY-glances Where X and Y are the Major and Minor Values of your Python System. .. code-block:: console # Example for Python 3.11.3: pkg install py311-glances **NOTE:** Check Glances Binary Package Version for your System Architecture. You must have the Correct Python Version Installed which corresponds to the Glances Binary Package. To install Glances from Ports: .. code-block:: console # cd /usr/ports/sysutils/py-glances/ # make install clean macOS ----- MacOS users can install Glances using ``Homebrew`` or ``MacPorts``. Homebrew ```````` .. code-block:: console $ brew install glances MacPorts ```````` .. code-block:: console $ sudo port install glances Windows ------- Install `Python`_ for Windows (Python 3.4+ ship with pip) and follow the Glances Pip install procedure. Android ------- You need a rooted device and the `Termux`_ application (available on the Google Play Store). Start Termux on your device and enter: .. code-block:: console $ apt update $ apt upgrade $ apt install clang python $ pip install fastapi uvicorn jinja2 $ pip install glances And start Glances: .. code-block:: console $ glances You can also run Glances in server mode (-s or -w) in order to remotely monitor your Android device. Source ------ To install Glances from source: .. code-block:: console $ pip install https://github.com/nicolargo/glances/archive/vX.Y.tar.gz *Note*: Python headers are required to install psutil. Chef ---- An awesome ``Chef`` cookbook is available to monitor your infrastructure: https://supermarket.chef.io/cookbooks/glances (thanks to Antoine Rouyer) Puppet ------ You can install Glances using ``Puppet``: https://github.com/rverchere/puppet-glances Ansible ------- A Glances ``Ansible`` role is available: https://galaxy.ansible.com/zaxos/glances-ansible-role/ Shell tab completion 🔍 ======================= Glances 4.3.2 and higher includes shell tab autocompletion thanks to the --print-completion option. For example, on a Linux operating system with bash shell: .. code-block:: console $ mkdir -p ${XDG_DATA_HOME:="$HOME/.local/share"}/bash-completion $ glances --print-completion bash > ${XDG_DATA_HOME:="$HOME/.local/share"}/bash-completion/glances $ source ${XDG_DATA_HOME:="$HOME/.local/share"}/bash-completion/glances Following shells are supported: bash, zsh and tcsh. Requirements 🧩 =============== Glances is developed in Python. A minimal Python version 3.10 or higher should be installed on your system. *Note for Python 2 users* Glances version 4 or higher do not support Python 2 (and Python 3 < 3.10). Please uses Glances version 3.4.x if you need Python 2 support. Dependencies: - ``psutil`` (better with latest version) - ``defusedxml`` (in order to monkey patch xmlrpc) - ``packaging`` (for the version comparison) - ``windows-curses`` (Windows Curses implementation) [Windows-only] - ``shtab`` (Shell autocompletion) [All but Windows] - ``jinja2`` (for fetch mode and templating) Extra dependencies: - ``batinfo`` (for battery monitoring) - ``bernhard`` (for the Riemann export module) - ``cassandra-driver`` (for the Cassandra export module) - ``chevron`` (for the action script feature) - ``docker`` (for the Containers Docker monitoring support) - ``elasticsearch`` (for the Elastic Search export module) - ``FastAPI`` and ``Uvicorn`` (for Web server mode) - ``mcp`` (for the MCP server — AI assistant integration) - ``graphitesender`` (For the Graphite export module) - ``hddtemp`` (for HDD temperature monitoring support) [Linux-only] - ``influxdb`` (for the InfluxDB version 1 export module) - ``influxdb-client`` (for the InfluxDB version 2 export module) - ``kafka-python`` (for the Kafka export module) - ``nats-py`` (for the NATS export module) - ``nvidia-ml-py`` (for the GPU plugin) - ``pycouchdb`` (for the CouchDB export module) - ``pika`` (for the RabbitMQ/ActiveMQ export module) - ``podman`` (for the Containers Podman monitoring support) - ``potsdb`` (for the OpenTSDB export module) - ``prometheus_client`` (for the Prometheus export module) - ``pylxd`` (for the LXC Containers monitoring support) - ``psycopg[binary]`` (for the PostgreSQL/TimeScale export module) - ``pygal`` (for the graph export module) - ``pymdstat`` (for RAID support) [Linux-only] - ``pymongo`` (for the MongoDB export module) - ``pysnmp-lextudio`` (for SNMP support) - ``pySMART.smartx`` (for HDD Smart support) [Linux-only] - ``pyzmq`` (for the ZeroMQ export module) - ``requests`` (for the Ports, Cloud plugins and RESTful export module) - ``sparklines`` (for the Quick Plugin sparklines option) - ``statsd`` (for the StatsD export module) - ``wifi`` (for the wifi plugin) [Linux-only] - ``zeroconf`` (for the autodiscover mode) How to contribute ? 🤝 ====================== If you want to contribute to the Glances project, read this `wiki`_ page. There is also a chat dedicated to the Glances developers: .. image:: https://badges.gitter.im/Join%20Chat.svg :target: https://gitter.im/nicolargo/glances?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge Project sponsorship 🙌 ====================== You can help me to achieve my goals of improving this open-source project or just say "thank you" by: - sponsor me using one-time or monthly tier Github sponsors_ page - send me some pieces of bitcoin: 185KN9FCix3svJYp7JQM7hRMfSKyeaJR4X - buy me a gift on my wishlist_ page Any and all contributions are greatly appreciated. Authors and Contributors 🔥 =========================== Nicolas Hennion (@nicolargo) .. image:: https://img.shields.io/twitter/url/https/twitter.com/cloudposse.svg?style=social&label=Follow%20%40nicolargo :target: https://twitter.com/nicolargo License 📜 ========== Glances is distributed under the LGPL version 3 license. See ``COPYING`` for more details. More stars ! 🌟 =============== Please give us a star on `GitHub`_ if you like this project. .. image:: https://api.star-history.com/svg?repos=nicolargo/glances&type=Date :target: https://www.star-history.com/#nicolargo/glances&Date :alt: Star history .. _psutil: https://github.com/giampaolo/psutil .. _Brew: https://formulae.brew.sh/formula/glances .. _Python: https://www.python.org/getit/ .. _Termux: https://play.google.com/store/apps/details?id=com.termux .. _readthedocs: https://glances.readthedocs.io/ .. _forum: https://www.reddit.com/r/glances/ .. _wiki: https://github.com/nicolargo/glances/wiki/How-to-contribute-to-Glances-%3F .. _package: https://repology.org/project/glances/versions .. _sponsors: https://github.com/sponsors/nicolargo .. _wishlist: https://www.amazon.fr/hz/wishlist/ls/BWAAQKWFR3FI?ref_=wl_share .. _Uv: https://docs.astral.sh/uv/getting-started/installation/ .. _Docker: https://github.com/nicolargo/glances/blob/master/docs/docker.rst .. _GitHub: https://github.com/nicolargo/glances .. _PythonApi: https://glances.readthedocs.io/en/develop/api/python.html .. _RestfulApi: https://glances.readthedocs.io/en/develop/api/restful.html .. _McpApi: https://glances.readthedocs.io/en/develop/api/mcp.html .. _`MCP (Model Context Protocol)`: https://modelcontextprotocol.io .. _FAQ: https://github.com/nicolargo/glances/blob/develop/docs/faq.rst .. _Discussions: https://github.com/nicolargo/glances/discussions ================================================ FILE: SECURITY.md ================================================ # Security Policy ## Supported Versions | Version | Support security updates | | ------- | ------------------------ | | 4.x | :white_check_mark: | | < 4.0 | :x: | ## Reporting a Vulnerability If there are any vulnerabilities in {{cookiecutter.project_name}}, don't hesitate to report them. 1. Describe the vulnerability. * Type of issue (e.g. buffer overflow, SQL injection, cross-site scripting, etc.) * Full paths of source file(s) related to the manifestation of the issue * The location of the affected source code (tag/branch/commit or direct URL) * Any special configuration required to reproduce the issue * Step-by-step instructions to reproduce the issue * Proof-of-concept or exploit code (if possible) * Impact of the issue, including how an attacker might exploit the issue 2. If you have a fix, that is most welcome -- please attach or summarize it in your message! 3. We will evaluate the vulnerability and, if necessary, release a fix or mitigating steps to address it. We will contact you to let you know the outcome, and will credit you in the report. 4. Please do not disclose the vulnerability publicly until a fix is released! Once we have either a) published a fix, or b) declined to address the vulnerability for whatever reason, you are free to publicly disclose it. ================================================ FILE: all-requirements.txt ================================================ # This file was autogenerated by uv via the following command: # uv export --no-emit-workspace --no-hashes --all-extras --no-group dev --output-file all-requirements.txt annotated-doc==0.0.4 # via fastapi annotated-types==0.7.0 # via pydantic anyio==4.12.1 # via # elasticsearch # httpx # mcp # sse-starlette # starlette attrs==25.4.0 # via # jsonschema # referencing batinfo==0.4.2 ; sys_platform == 'linux' # via glances bernhard==0.2.6 # via glances certifi==2026.2.25 # via # elastic-transport # httpcore # httpx # influxdb-client # influxdb3-python # requests cffi==2.0.0 ; implementation_name == 'pypy' or platform_python_implementation != 'PyPy' # via # cryptography # pyzmq chardet==7.1.0 # via pysmart charset-normalizer==3.4.5 # via requests chevron==0.14.0 # via glances click==8.1.8 # via uvicorn colorama==0.4.6 ; sys_platform == 'win32' # via click cryptography==46.0.5 # via # pyjwt # pylxd # pysnmpcrypto # python-jose defusedxml==0.7.1 # via glances dnspython==2.8.0 # via pymongo docker==7.1.0 # via glances ecdsa==0.19.1 # via python-jose elastic-transport==9.2.1 # via elasticsearch elasticsearch==9.3.0 # via glances exceptiongroup==1.2.2 ; python_full_version < '3.11' # via anyio fastapi==0.135.1 # via glances graphitesender==0.11.2 # via glances h11==0.16.0 # via # httpcore # uvicorn httpcore==1.0.9 # via httpx httpx==0.28.1 # via mcp httpx-sse==0.4.3 # via mcp humanfriendly==10.0 # via pysmart ibm-cloud-sdk-core==3.24.4 # via ibmcloudant ibmcloudant==0.11.4 # via glances idna==3.11 # via # anyio # httpx # requests ifaddr==0.2.0 # via zeroconf importlib-metadata==8.7.1 # via pygal influxdb==5.3.2 # via glances influxdb-client==1.50.0 # via glances influxdb3-python==0.18.0 # via glances jinja2==3.1.6 # via # glances # pysmi-lextudio jsonschema==4.25.1 # via mcp jsonschema-specifications==2025.9.1 # via jsonschema kafka-python==2.3.0 # via glances markupsafe==3.0.3 # via jinja2 mcp==1.23.3 # via glances msgpack==1.1.2 # via influxdb nats-py==2.14.0 # via glances nvidia-ml-py==13.590.48 # via glances packaging==26.0 # via glances paho-mqtt==2.1.0 # via glances pbkdf2==1.3 # via wifi pika==1.3.2 # via glances ply==3.11 # via pysmi-lextudio podman==5.7.0 # via glances potsdb==1.0.3 # via glances prometheus-client==0.24.1 # via glances protobuf==6.33.5 # via bernhard psutil==7.2.2 # via glances psycopg==3.3.3 # via glances psycopg-binary==3.3.3 ; implementation_name != 'pypy' # via psycopg pyarrow==23.0.1 # via influxdb3-python pyasn1==0.6.2 # via # pysnmp-lextudio # python-jose # rsa pycparser==3.0 ; (implementation_name != 'PyPy' and platform_python_implementation != 'PyPy') or (implementation_name == 'pypy' and platform_python_implementation == 'PyPy') # via cffi pydantic==2.12.5 # via # fastapi # mcp # pydantic-settings pydantic-core==2.41.5 # via pydantic pydantic-settings==2.13.1 # via mcp pygal==3.1.0 # via glances pyinstrument==5.1.2 # via glances pyjwt==2.12.1 # via # ibm-cloud-sdk-core # ibmcloudant # mcp pylxd==2.3.9 # via glances pymdstat==0.5.1 # via glances pymongo==4.16.0 # via glances pyreadline3==3.5.4 ; sys_platform == 'win32' # via humanfriendly pysmart==1.4.2 # via glances pysmi-lextudio==1.4.3 # via pysnmp-lextudio pysnmp-lextudio==6.1.2 # via glances pysnmpcrypto==0.0.4 # via pysnmp-lextudio python-dateutil==2.9.0.post0 # via # elasticsearch # glances # ibm-cloud-sdk-core # ibmcloudant # influxdb # influxdb-client # influxdb3-python # pylxd python-dotenv==1.2.2 # via pydantic-settings python-jose==3.5.0 # via glances python-multipart==0.0.22 # via mcp pytz==2026.1.post1 # via influxdb pywin32==311 ; sys_platform == 'win32' # via # docker # mcp pyzmq==27.1.0 # via glances reactivex==4.1.0 # via # influxdb-client # influxdb3-python referencing==0.37.0 # via # jsonschema # jsonschema-specifications requests==2.32.5 # via # docker # glances # ibm-cloud-sdk-core # ibmcloudant # influxdb # podman # pylxd # pysmi-lextudio # requests-toolbelt requests-toolbelt==1.0.0 # via pylxd rpds-py==0.30.0 # via # jsonschema # referencing rsa==4.9.1 # via python-jose setuptools==82.0.1 # via wifi shtab==1.8.0 ; sys_platform != 'win32' # via glances six==1.17.0 # via # ecdsa # glances # influxdb # python-dateutil sniffio==1.3.1 # via # elastic-transport # elasticsearch sparklines==0.7.0 # via glances sse-starlette==3.3.2 # via mcp starlette==0.52.1 # via # fastapi # mcp # sse-starlette statsd==4.0.1 # via glances termcolor==3.3.0 # via sparklines tomli==2.0.2 ; python_full_version < '3.11' # via podman typing-extensions==4.15.0 # via # anyio # cryptography # elasticsearch # fastapi # mcp # psycopg # pydantic # pydantic-core # pyjwt # reactivex # referencing # starlette # typing-inspection # uvicorn typing-inspection==0.4.2 # via # fastapi # mcp # pydantic # pydantic-settings tzdata==2025.3 ; sys_platform == 'win32' # via psycopg urllib3==2.6.3 # via # docker # elastic-transport # ibm-cloud-sdk-core # influxdb-client # influxdb3-python # podman # requests uvicorn==0.41.0 # via # glances # mcp wifi==0.3.8 # via glances windows-curses==2.4.1 ; sys_platform == 'win32' # via glances ws4py==0.6.0 # via pylxd zeroconf==0.148.0 # via glances zipp==3.23.0 # via importlib-metadata ================================================ FILE: appveyor.yml ================================================ image: Visual Studio 2022 environment: matrix: - PYTHON: "C:\\Python310-x64" - PYTHON: "C:\\Python311-x64" - PYTHON: "C:\\Python312-x64" install: - "%PYTHON%\\python.exe -m pip install --upgrade pip" - "%PYTHON%\\python.exe -m pip install -r requirements.txt" - "%PYTHON%\\python.exe -m pip install -r dev-requirements.txt" - "%PYTHON%\\python.exe -m pip install \".[web]\"" build: off test_script: - "%PYTHON%\\python.exe -m pytest tests/" ================================================ FILE: conf/empty.conf ================================================ # Empty conf, only for test ================================================ FILE: conf/fetch-templates/short.jinja ================================================ ✨ {{ gl.system['hostname'] }}{{ ' - ' + gl.ip['address'] if gl.ip['address'] else '' }} ⚙️ {{ gl.system['hr_name'] }} | Uptime: {{ gl.uptime }} 💡 LOAD {{ '%0.2f'| format(gl.load['min1']) }} {{ '%0.2f'| format(gl.load['min5']) }} {{ '%0.2f'| format(gl.load['min15']) }} ⚡ CPU {{ gl.bar(gl.cpu['total']) }} {{ gl.cpu['total'] }}% of {{ gl.core['log'] }} cores 🧠 MEM {{ gl.bar(gl.mem['percent']) }} {{ gl.mem['percent'] }}% ({{ gl.auto_unit(gl.mem['used']) }} {{ gl.auto_unit(gl.mem['total']) }}) {% for fs in gl.fs.keys() %}💾 {% if loop.index == 1 %}DISK{% else %} {% endif %} {{ gl.bar(gl.fs[fs]['percent']) }} {{ gl.fs[fs]['percent'] }}% ({{ gl.auto_unit(gl.fs[fs]['used']) }} {{ gl.auto_unit(gl.fs[fs]['size']) }}) for {{ fs }} {% endfor %}{% for net in gl.network.keys() %}📡 {% if loop.index == 1 %}NET{% else %} {% endif %} ↓ {{ gl.auto_unit(gl.network[net]['bytes_recv_rate_per_sec']) }}b/s ↑ {{ gl.auto_unit(gl.network[net]['bytes_sent_rate_per_sec']) }}b/s for {{ net }} {% endfor %} ================================================ FILE: conf/fetch-templates/with-logo.jinja ================================================ _____ _ / ____| | | | __| | __ _ _ __ ___ ___ ___ | | |_ | |/ _` | '_ \ / __/ _ \/ __| | |__| | | (_| | | | | (_| __/\__ \_____|_|\__,_|_| |_|\___\___||___/ ✨ {{ gl.system['hostname'] }}{{ ' - ' + gl.ip['address'] if gl.ip['address'] else '' }} ⚙️ {{ gl.system['hr_name'] }} | Uptime: {{ gl.uptime }} 💡 LOAD {{ '%0.2f'| format(gl.load['min1']) }} {{ '%0.2f'| format(gl.load['min5']) }} {{ '%0.2f'| format(gl.load['min15']) }} ⚡ CPU {{ gl.bar(gl.cpu['total']) }} {{ gl.cpu['total'] }}% of {{ gl.core['log'] }} cores 🧠 MEM {{ gl.bar(gl.mem['percent']) }} {{ gl.mem['percent'] }}% ({{ gl.auto_unit(gl.mem['used']) }} {{ gl.auto_unit(gl.mem['total']) }}) {% for fs in gl.fs.keys() %}💾 {% if loop.index == 1 %}DISK{% else %} {% endif %} {{ gl.bar(gl.fs[fs]['percent']) }} {{ gl.fs[fs]['percent'] }}% ({{ gl.auto_unit(gl.fs[fs]['used']) }} {{ gl.auto_unit(gl.fs[fs]['size']) }}) for {{ fs }} {% endfor %}{% for net in gl.network.keys() %}📡 {% if loop.index == 1 %}NET{% else %} {% endif %} ↓ {{ gl.auto_unit(gl.network[net]['bytes_recv_rate_per_sec']) }}b/s ↑ {{ gl.auto_unit(gl.network[net]['bytes_sent_rate_per_sec']) }}b/s for {{ net }} {% endfor %} 🔥 TOP PROCESS by CPU {% for process in gl.top_process() %}{{ loop.index }}️⃣ {{ process['name'][:20] }}{{ ' ' * (20 - process['name'][:20] | length) }} ⚡ {{ process['cpu_percent'] }}% CPU{{ ' ' * (8 - (gl.auto_unit(process['cpu_percent']) | length)) }} 🧠 {{ gl.auto_unit(process['memory_info']['rss']) }}B MEM {% endfor %} 🔥 TOP PROCESS by MEM {% for process in gl.top_process(sorted_by='memory_percent', sorted_by_secondary='cpu_percent') %}{{ loop.index }}️⃣ {{ process['name'][:20] }}{{ ' ' * (20 - process['name'][:20] | length) }} 🧠 {{ gl.auto_unit(process['memory_info']['rss']) }}B MEM{{ ' ' * (7 - (gl.auto_unit(process['memory_info']['rss']) | length)) }} ⚡ {{ process['cpu_percent'] }}% CPU {% endfor %} ================================================ FILE: conf/glances-grafana-flux.json ================================================ { "__inputs": [ { "name": "DS_GLANCES", "label": "glances", "description": "", "type": "datasource", "pluginId": "influxdb", "pluginName": "InfluxDB" } ], "__requires": [ { "type": "grafana", "id": "grafana", "name": "Grafana", "version": "8.2.5" }, { "type": "panel", "id": "heatmap", "name": "Heatmap", "version": "" }, { "type": "datasource", "id": "influxdb", "name": "InfluxDB", "version": "1.0.0" }, { "type": "panel", "id": "stat", "name": "Stat", "version": "" }, { "type": "panel", "id": "timeseries", "name": "Time series", "version": "" } ], "annotations": { "list": [ { "builtIn": 1, "datasource": "-- Grafana --", "enable": true, "hide": true, "iconColor": "rgba(0, 211, 255, 1)", "name": "Annotations & Alerts", "target": { "limit": 100, "matchAny": false, "tags": [], "type": "dashboard" }, "type": "dashboard" } ] }, "editable": true, "fiscalYearStartMonth": 0, "gnetId": null, "graphTooltip": 0, "id": null, "iteration": 1638092370245, "links": [], "liveNow": false, "panels": [ { "collapsed": false, "datasource": null, "gridPos": { "h": 1, "w": 24, "x": 0, "y": 0 }, "id": 29, "panels": [], "title": "Glances $host", "type": "row" }, { "cacheTimeout": null, "datasource": "${DS_GLANCES}", "fieldConfig": { "defaults": { "color": { "mode": "thresholds" }, "mappings": [ { "options": { "match": "null", "result": { "text": "N/A" } }, "type": "special" } ], "thresholds": { "mode": "absolute", "steps": [ { "color": "green", "value": null }, { "color": "red", "value": 80 } ] }, "unit": "none" }, "overrides": [] }, "gridPos": { "h": 6, "w": 2, "x": 0, "y": 1 }, "id": 5, "interval": null, "links": [], "maxDataPoints": 100, "options": { "colorMode": "none", "graphMode": "none", "justifyMode": "auto", "orientation": "horizontal", "reduceOptions": { "calcs": ["lastNotNull"], "fields": "", "values": false }, "text": {}, "textMode": "auto" }, "pluginVersion": "8.2.5", "targets": [ { "column": "cpucore", "dsType": "influxdb", "function": "mean", "groupBy": [ { "params": ["auto"], "type": "time" } ], "measurement": "load", "orderByTime": "ASC", "policy": "default", "query": "from(bucket: \"glances\")\n |> range(start: v.timeRangeStart, stop:v.timeRangeStop)\n |> filter(fn: (r) =>\n r._measurement == \"load\" and\n r._field == \"cpucore\" and\n r.hostname == \"${host}\"\n )\n |> last()", "refId": "A", "resultFormat": "time_series", "select": [ [ { "params": ["cpucore"], "type": "field" }, { "params": [], "type": "max" } ] ], "series": "load", "tags": [ { "key": "hostname", "operator": "=~", "value": "/^$host$/" } ] } ], "title": "Core", "type": "stat" }, { "datasource": "${DS_GLANCES}", "fieldConfig": { "defaults": { "color": { "mode": "palette-classic" }, "custom": { "axisLabel": "", "axisPlacement": "auto", "barAlignment": 0, "drawStyle": "line", "fillOpacity": 10, "gradientMode": "none", "hideFrom": { "legend": false, "tooltip": false, "viz": false }, "lineInterpolation": "linear", "lineWidth": 2, "pointSize": 5, "scaleDistribution": { "type": "linear" }, "showPoints": "never", "spanNulls": true, "stacking": { "group": "A", "mode": "normal" }, "thresholdsStyle": { "mode": "off" } }, "mappings": [], "thresholds": { "mode": "absolute", "steps": [ { "color": "green", "value": null }, { "color": "red", "value": 80 } ] }, "unit": "short" }, "overrides": [] }, "gridPos": { "h": 6, "w": 20, "x": 2, "y": 1 }, "id": 4, "links": [], "options": { "legend": { "calcs": ["mean", "max", "min"], "displayMode": "table", "placement": "right" }, "tooltip": { "mode": "single" } }, "pluginVersion": "8.2.5", "targets": [ { "alias": "1min", "column": "min1", "dsType": "influxdb", "function": "mean", "groupBy": [ { "params": ["auto"], "type": "time" }, { "params": ["none"], "type": "fill" } ], "measurement": "load", "orderByTime": "ASC", "policy": "default", "query": "from(bucket: \"glances\")\n |> range(start: v.timeRangeStart, stop:v.timeRangeStop)\n |> filter(fn: (r) =>\n r._measurement == \"load\" and\n r._field == \"min5\" and\n r.hostname == \"${host}\"\n )\n |> aggregateWindow(every: v.windowPeriod, fn: mean, createEmpty: false)\n |> yield(name: \"mean5\")\n \n ", "refId": "A", "resultFormat": "time_series", "select": [ [ { "params": ["min1"], "type": "field" }, { "params": [], "type": "mean" } ] ], "series": "load", "tags": [ { "key": "hostname", "operator": "=~", "value": "/^$host$/" } ], "target": "randomWalk('random walk')" }, { "alias": "1min", "column": "min1", "dsType": "influxdb", "function": "mean", "groupBy": [ { "params": ["auto"], "type": "time" }, { "params": ["none"], "type": "fill" } ], "hide": false, "measurement": "load", "orderByTime": "ASC", "policy": "default", "query": "from(bucket: \"glances\")\n |> range(start: v.timeRangeStart, stop:v.timeRangeStop)\n |> filter(fn: (r) =>\n r._measurement == \"load\" and\n r._field == \"min15\" and\n r.hostname == \"${host}\"\n )\n |> aggregateWindow(every: v.windowPeriod, fn: mean, createEmpty: false)\n |> yield(name: \"mean15\")\n \n ", "refId": "B", "resultFormat": "time_series", "select": [ [ { "params": ["min1"], "type": "field" }, { "params": [], "type": "mean" } ] ], "series": "load", "tags": [ { "key": "hostname", "operator": "=~", "value": "/^$host$/" } ], "target": "randomWalk('random walk')" }, { "alias": "1min", "column": "min1", "dsType": "influxdb", "function": "mean", "groupBy": [ { "params": ["auto"], "type": "time" }, { "params": ["none"], "type": "fill" } ], "hide": false, "measurement": "load", "orderByTime": "ASC", "policy": "default", "query": "from(bucket: \"glances\")\n |> range(start: v.timeRangeStart, stop:v.timeRangeStop)\n |> filter(fn: (r) =>\n r._measurement == \"load\" and\n r._field == \"min1\" and\n r.hostname == \"${host}\"\n )\n |> aggregateWindow(every: v.windowPeriod, fn: mean, createEmpty: false)\n |> yield(name: \"mean1\")\n \n ", "refId": "C", "resultFormat": "time_series", "select": [ [ { "params": ["min1"], "type": "field" }, { "params": [], "type": "mean" } ] ], "series": "load", "tags": [ { "key": "hostname", "operator": "=~", "value": "/^$host$/" } ], "target": "randomWalk('random walk')" } ], "timeFrom": null, "timeShift": null, "title": "Load", "type": "timeseries" }, { "cacheTimeout": null, "datasource": "${DS_GLANCES}", "fieldConfig": { "defaults": { "color": { "fixedColor": "rgb(31, 120, 193)", "mode": "fixed" }, "mappings": [ { "options": { "match": "null", "result": { "text": "N/A" } }, "type": "special" } ], "thresholds": { "mode": "absolute", "steps": [ { "color": "green", "value": null }, { "color": "red", "value": 80 } ] }, "unit": "none" }, "overrides": [] }, "gridPos": { "h": 6, "w": 2, "x": 22, "y": 1 }, "id": 18, "interval": null, "links": [], "maxDataPoints": 100, "options": { "colorMode": "none", "graphMode": "area", "justifyMode": "auto", "orientation": "horizontal", "reduceOptions": { "calcs": ["mean"], "fields": "", "values": false }, "text": {}, "textMode": "auto" }, "pluginVersion": "8.2.5", "targets": [ { "column": "total", "dsType": "influxdb", "function": "mean", "groupBy": [ { "params": ["$__interval"], "type": "time" } ], "measurement": "processcount", "orderByTime": "ASC", "policy": "default", "query": "from(bucket: \"glances\")\n |> range(start: v.timeRangeStart, stop:v.timeRangeStop)\n |> filter(fn: (r) =>\n r._measurement == \"processcount\" and\n r._field == \"total\" and\n r.hostname == \"${host}\"\n )\n |> last()", "refId": "A", "resultFormat": "time_series", "select": [ [ { "params": ["total"], "type": "field" }, { "params": [], "type": "last" } ] ], "series": "processcount", "tags": [ { "key": "hostname", "operator": "=~", "value": "/^$host$/" } ] } ], "title": "Processes", "type": "stat" }, { "datasource": "${DS_GLANCES}", "fieldConfig": { "defaults": { "color": { "mode": "palette-classic" }, "custom": { "axisLabel": "", "axisPlacement": "auto", "barAlignment": 0, "drawStyle": "line", "fillOpacity": 0, "gradientMode": "none", "hideFrom": { "legend": false, "tooltip": false, "viz": false }, "lineInterpolation": "linear", "lineWidth": 1, "pointSize": 5, "scaleDistribution": { "type": "linear" }, "showPoints": "never", "spanNulls": true, "stacking": { "group": "A", "mode": "none" }, "thresholdsStyle": { "mode": "off" } }, "mappings": [], "thresholds": { "mode": "absolute", "steps": [ { "color": "green", "value": null }, { "color": "red", "value": 80 } ] }, "unit": "percent" }, "overrides": [] }, "gridPos": { "h": 7, "w": 12, "x": 0, "y": 7 }, "id": 6, "links": [], "options": { "legend": { "calcs": [], "displayMode": "list", "placement": "bottom" }, "tooltip": { "mode": "single" } }, "pluginVersion": "8.2.5", "targets": [ { "alias": "User", "column": "user", "dsType": "influxdb", "function": "mean", "groupBy": [ { "params": ["auto"], "type": "time" }, { "params": ["none"], "type": "fill" } ], "measurement": "cpu", "orderByTime": "ASC", "policy": "default", "query": "from(bucket: \"glances\")\n |> range(start: v.timeRangeStart, stop:v.timeRangeStop)\n |> filter(fn: (r) =>\n r._measurement == \"cpu\" and\n r._field == \"user\" and\n r.hostname == \"${host}\"\n )\n |> aggregateWindow(every: v.windowPeriod, fn: mean, createEmpty: false)\n |> yield(name: \"user\")\n \n ", "refId": "A", "resultFormat": "time_series", "select": [ [ { "params": ["user"], "type": "field" }, { "params": [], "type": "mean" } ] ], "series": "cpu", "tags": [ { "key": "hostname", "operator": "=~", "value": "/^$host$/" } ] }, { "alias": "System", "column": "system", "dsType": "influxdb", "function": "mean", "groupBy": [ { "params": ["auto"], "type": "time" }, { "params": ["none"], "type": "fill" } ], "measurement": "cpu", "orderByTime": "ASC", "policy": "default", "query": "from(bucket: \"glances\")\n |> range(start: v.timeRangeStart, stop:v.timeRangeStop)\n |> filter(fn: (r) =>\n r._measurement == \"cpu\" and\n r._field == \"system\" and\n r.hostname == \"${host}\"\n )\n |> aggregateWindow(every: v.windowPeriod, fn: mean, createEmpty: false)\n |> yield(name: \"system\")\n \n ", "refId": "B", "resultFormat": "time_series", "select": [ [ { "params": ["system"], "type": "field" }, { "params": [], "type": "mean" } ] ], "series": "cpu", "tags": [ { "key": "hostname", "operator": "=~", "value": "/^$host$/" } ], "target": "" }, { "alias": "IoWait", "column": "iowait", "dsType": "influxdb", "function": "mean", "groupBy": [ { "params": ["auto"], "type": "time" }, { "params": ["none"], "type": "fill" } ], "measurement": "cpu", "orderByTime": "ASC", "policy": "default", "query": "from(bucket: \"glances\")\n |> range(start: v.timeRangeStart, stop:v.timeRangeStop)\n |> filter(fn: (r) =>\n r._measurement == \"cpu\" and\n r._field == \"iowait\" and\n r.hostname == \"${host}\"\n )\n |> aggregateWindow(every: v.windowPeriod, fn: mean, createEmpty: false)\n |> yield(name: \"iowait\")\n \n ", "refId": "C", "resultFormat": "time_series", "select": [ [ { "params": ["iowait"], "type": "field" }, { "params": [], "type": "mean" } ] ], "series": "cpu", "tags": [ { "key": "hostname", "operator": "=~", "value": "/^$host$/" } ], "target": "" } ], "timeFrom": null, "timeShift": null, "title": "CPU (%)", "type": "timeseries" }, { "datasource": "${DS_GLANCES}", "fieldConfig": { "defaults": { "color": { "mode": "palette-classic" }, "custom": { "axisLabel": "", "axisPlacement": "auto", "barAlignment": 0, "drawStyle": "line", "fillOpacity": 0, "gradientMode": "none", "hideFrom": { "legend": false, "tooltip": false, "viz": false }, "lineInterpolation": "linear", "lineWidth": 1, "pointSize": 5, "scaleDistribution": { "type": "linear" }, "showPoints": "never", "spanNulls": true, "stacking": { "group": "A", "mode": "none" }, "thresholdsStyle": { "mode": "off" } }, "mappings": [], "min": 0, "thresholds": { "mode": "absolute", "steps": [ { "color": "green", "value": null }, { "color": "red", "value": 80 } ] }, "unit": "bytes" }, "overrides": [ { "matcher": { "id": "byRegexp", "options": "/.*total./" }, "properties": [ { "id": "color", "value": { "fixedColor": "dark-red", "mode": "fixed" } }, { "id": "custom.lineWidth", "value": 2 } ] }, { "matcher": { "id": "byRegexp", "options": "/^used.*$/" }, "properties": [ { "id": "custom.fillOpacity", "value": 30 } ] } ] }, "gridPos": { "h": 7, "w": 12, "x": 12, "y": 7 }, "id": 7, "links": [], "options": { "legend": { "calcs": [], "displayMode": "list", "placement": "bottom" }, "tooltip": { "mode": "single" } }, "pluginVersion": "8.2.5", "targets": [ { "alias": "Used", "column": "used", "dsType": "influxdb", "function": "mean", "groupBy": [ { "params": ["$__interval"], "type": "time" }, { "params": ["none"], "type": "fill" } ], "measurement": "mem", "orderByTime": "ASC", "policy": "default", "query": "from(bucket: \"glances\")\n |> range(start: v.timeRangeStart, stop:v.timeRangeStop)\n |> filter(fn: (r) =>\n r._measurement == \"mem\" and\n r._field == \"used\" and\n r.hostname == \"${host}\"\n )\n |> aggregateWindow(every: v.windowPeriod, fn: mean, createEmpty: false)\n |> yield(name: \"used\")\n \n ", "rawQuery": false, "refId": "A", "resultFormat": "time_series", "select": [ [ { "params": ["used"], "type": "field" }, { "params": [], "type": "mean" } ] ], "series": "mem", "tags": [ { "key": "hostname", "operator": "=~", "value": "/^$host$/" } ] }, { "alias": "Max", "column": "total", "dsType": "influxdb", "function": "mean", "groupBy": [ { "params": ["$__interval"], "type": "time" }, { "params": ["none"], "type": "fill" } ], "measurement": "mem", "orderByTime": "ASC", "policy": "default", "query": "from(bucket: \"glances\")\n |> range(start: v.timeRangeStart, stop:v.timeRangeStop)\n |> filter(fn: (r) =>\n r._measurement == \"mem\" and\n r._field == \"total\" and\n r.hostname == \"${host}\"\n )\n |> aggregateWindow(every: v.windowPeriod, fn: mean, createEmpty: false)\n |> yield(name: \"total\")\n \n ", "rawQuery": false, "refId": "B", "resultFormat": "time_series", "select": [ [ { "params": ["total"], "type": "field" }, { "params": [], "type": "mean" } ] ], "series": "mem", "tags": [ { "key": "hostname", "operator": "=~", "value": "/^$host$/" } ], "target": "" } ], "timeFrom": null, "timeShift": null, "title": "MEM", "type": "timeseries" }, { "datasource": "${DS_GLANCES}", "description": "", "fieldConfig": { "defaults": { "color": { "mode": "palette-classic" }, "custom": { "axisLabel": "", "axisPlacement": "auto", "barAlignment": 0, "drawStyle": "line", "fillOpacity": 30, "gradientMode": "none", "hideFrom": { "legend": false, "tooltip": false, "viz": false }, "lineInterpolation": "linear", "lineWidth": 1, "pointSize": 5, "scaleDistribution": { "type": "linear" }, "showPoints": "never", "spanNulls": true, "stacking": { "group": "A", "mode": "none" }, "thresholdsStyle": { "mode": "off" } }, "mappings": [], "thresholds": { "mode": "absolute", "steps": [ { "color": "green", "value": null }, { "color": "red", "value": 80 } ] }, "unit": "bps" }, "overrides": [] }, "gridPos": { "h": 7, "w": 12, "x": 0, "y": 14 }, "id": 9, "links": [], "options": { "legend": { "calcs": ["mean", "max", "min"], "displayMode": "list", "placement": "bottom" }, "tooltip": { "mode": "single" } }, "pluginVersion": "8.2.5", "targets": [ { "alias": "In", "column": "enp0s25.rx", "dsType": "influxdb", "function": "mean", "groupBy": [ { "params": ["auto"], "type": "time" }, { "params": ["null"], "type": "fill" } ], "hide": false, "interval": "", "measurement": "$host.network", "orderByTime": "ASC", "policy": "default", "query": "from(bucket: \"glances\")\n |> range(start: v.timeRangeStart, stop:v.timeRangeStop)\n |> filter(fn: (r) =>\n r._measurement == \"network\" and\n (r._field == \"rx\" or r._field == \"time_since_update\") and\n r.interface_name == \"${interface}\" and\n r.hostname == \"${host}\"\n )\n |> pivot(\n rowKey:[\"_time\"],\n columnKey: [\"_field\"],\n valueColumn: \"_value\"\n )\n |> map(fn: (r) => ({ r with _value: (r.rx / r.time_since_update) * 8.0 }))\n |> aggregateWindow(every: v.windowPeriod, fn: mean, createEmpty: false)\n |> keep(columns: [\"_time\", \"_value\"])\n |> rename(columns: {_value: \"rx_rate\"})\n", "rawQuery": true, "refId": "A", "resultFormat": "time_series", "select": [ [ { "params": ["eth0.rx"], "type": "field" }, { "params": [], "type": "mean" } ] ], "series": "network", "tags": [] }, { "alias": "Out", "column": "eth0.tx*-1", "dsType": "influxdb", "function": "mean", "groupBy": [ { "params": ["auto"], "type": "time" }, { "params": ["null"], "type": "fill" } ], "measurement": "$host.network", "orderByTime": "ASC", "policy": "default", "query": "from(bucket: \"glances\")\n |> range(start: v.timeRangeStart, stop:v.timeRangeStop)\n |> filter(fn: (r) =>\n r._measurement == \"network\" and\n (r._field == \"tx\" or r._field == \"time_since_update\") and\n r.interface_name == \"${interface}\" and\n r.hostname == \"${host}\"\n )\n |> pivot(\n rowKey:[\"_time\"],\n columnKey: [\"_field\"],\n valueColumn: \"_value\"\n )\n |> map(fn: (r) => ({ r with _value: (r.tx / r.time_since_update) * -8.0 }))\n |> aggregateWindow(every: v.windowPeriod, fn: mean, createEmpty: false)\n |> keep(columns: [\"_time\", \"_value\"])\n |> rename(columns: {_value: \"tx_rate\"})\n", "rawQuery": true, "refId": "B", "resultFormat": "time_series", "select": [ [ { "params": ["eth0.tx"], "type": "field" }, { "params": [], "type": "mean" } ] ], "series": "network", "tags": [], "target": "" } ], "timeFrom": null, "timeShift": null, "title": "$interface network interface", "transformations": [], "type": "timeseries" }, { "datasource": "${DS_GLANCES}", "fieldConfig": { "defaults": { "color": { "mode": "palette-classic" }, "custom": { "axisLabel": "", "axisPlacement": "auto", "barAlignment": 0, "drawStyle": "line", "fillOpacity": 0, "gradientMode": "none", "hideFrom": { "legend": false, "tooltip": false, "viz": false }, "lineInterpolation": "linear", "lineWidth": 1, "pointSize": 5, "scaleDistribution": { "type": "linear" }, "showPoints": "never", "spanNulls": true, "stacking": { "group": "A", "mode": "none" }, "thresholdsStyle": { "mode": "off" } }, "mappings": [], "min": 0, "thresholds": { "mode": "absolute", "steps": [ { "color": "green", "value": null }, { "color": "red", "value": 80 } ] }, "unit": "bytes" }, "overrides": [ { "matcher": { "id": "byRegexp", "options": "/total.*/" }, "properties": [ { "id": "color", "value": { "fixedColor": "dark-red", "mode": "fixed" } }, { "id": "custom.lineWidth", "value": 2 } ] }, { "matcher": { "id": "byRegexp", "options": "/used.*/" }, "properties": [ { "id": "custom.fillOpacity", "value": 30 } ] } ] }, "gridPos": { "h": 7, "w": 12, "x": 12, "y": 14 }, "id": 8, "links": [], "options": { "legend": { "calcs": [], "displayMode": "list", "placement": "bottom" }, "tooltip": { "mode": "single" } }, "pluginVersion": "8.2.5", "targets": [ { "alias": "Used", "column": "used", "dsType": "influxdb", "function": "mean", "groupBy": [ { "params": ["$__interval"], "type": "time" } ], "measurement": "$host.memswap", "orderByTime": "ASC", "policy": "default", "query": "from(bucket: \"glances\")\n |> range(start: v.timeRangeStart, stop:v.timeRangeStop)\n |> filter(fn: (r) =>\n r._measurement == \"memswap\" and\n r._field == \"used\" and\n r.hostname == \"${host}\"\n )\n |> aggregateWindow(every: v.windowPeriod, fn: mean, createEmpty: false)\n |> yield(name: \"used\")\n ", "rawQuery": true, "refId": "A", "resultFormat": "time_series", "select": [ [ { "params": ["used"], "type": "field" }, { "params": [], "type": "mean" } ] ], "series": "memswap", "tags": [] }, { "alias": "Max", "column": "total", "dsType": "influxdb", "function": "mean", "groupBy": [ { "params": ["$__interval"], "type": "time" } ], "measurement": "$host.memswap", "orderByTime": "ASC", "policy": "default", "query": "from(bucket: \"glances\")\n |> range(start: v.timeRangeStart, stop:v.timeRangeStop)\n |> filter(fn: (r) =>\n r._measurement == \"memswap\" and\n r._field == \"total\" and\n r.hostname == \"${host}\"\n )\n |> aggregateWindow(every: v.windowPeriod, fn: mean, createEmpty: false)\n |> yield(name: \"total\")\n \n ", "rawQuery": true, "refId": "B", "resultFormat": "time_series", "select": [ [ { "params": ["total"], "type": "field" }, { "params": [], "type": "mean" } ] ], "series": "memswap", "tags": [], "target": "" } ], "timeFrom": null, "timeShift": null, "title": "SWAP", "type": "timeseries" }, { "datasource": "${DS_GLANCES}", "description": "", "fieldConfig": { "defaults": { "color": { "mode": "palette-classic" }, "custom": { "axisLabel": "", "axisPlacement": "auto", "barAlignment": 0, "drawStyle": "line", "fillOpacity": 15, "gradientMode": "none", "hideFrom": { "legend": false, "tooltip": false, "viz": false }, "lineInterpolation": "linear", "lineWidth": 1, "pointSize": 5, "scaleDistribution": { "type": "linear" }, "showPoints": "never", "spanNulls": true, "stacking": { "group": "A", "mode": "none" }, "thresholdsStyle": { "mode": "off" } }, "mappings": [], "thresholds": { "mode": "absolute", "steps": [ { "color": "green", "value": null }, { "color": "red", "value": 80 } ] }, "unit": "bytes" }, "overrides": [] }, "gridPos": { "h": 7, "w": 12, "x": 0, "y": 21 }, "id": 10, "links": [], "options": { "legend": { "calcs": ["mean", "max", "min"], "displayMode": "list", "placement": "bottom" }, "tooltip": { "mode": "single" } }, "pluginVersion": "8.2.5", "targets": [ { "alias": "Read", "column": "sda2.read_bytes", "dsType": "influxdb", "function": "mean", "groupBy": [ { "params": ["auto"], "type": "time" }, { "params": ["none"], "type": "fill" } ], "measurement": "$host.diskio", "orderByTime": "ASC", "policy": "default", "query": "from(bucket: \"glances\")\n |> range(start: v.timeRangeStart, stop:v.timeRangeStop)\n |> filter(fn: (r) =>\n r._measurement == \"diskio\" and\n (r._field == \"read_bytes\" or r._field == \"time_since_update\") and\n r.disk_name == \"${disk}\" and\n r.hostname == \"${host}\"\n )\n |> pivot(\n rowKey:[\"_time\"],\n columnKey: [\"_field\"],\n valueColumn: \"_value\"\n )\n |> map(fn: (r) => ({ r with _value: (r.read_bytes / r.time_since_update) }))\n |> aggregateWindow(every: v.windowPeriod, fn: mean, createEmpty: false)\n |> keep(columns: [\"_time\", \"_value\"])\n |> rename(columns: {_value: \"read_rate\"})\n", "rawQuery": true, "refId": "A", "resultFormat": "time_series", "select": [ [ { "params": ["sda2.read_bytes"], "type": "field" }, { "params": [], "type": "mean" } ] ], "series": "diskio", "tags": [] }, { "alias": "Write", "column": "sda2.write_bytes", "dsType": "influxdb", "function": "mean", "groupBy": [ { "params": ["auto"], "type": "time" }, { "params": ["none"], "type": "fill" } ], "measurement": "$host.diskio", "orderByTime": "ASC", "policy": "default", "query": "from(bucket: \"glances\")\n |> range(start: v.timeRangeStart, stop:v.timeRangeStop)\n |> filter(fn: (r) =>\n r._measurement == \"diskio\" and\n (r._field == \"write_bytes\" or r._field == \"time_since_update\") and\n r.disk_name == \"${disk}\" and\n r.hostname == \"${host}\"\n )\n |> pivot(\n rowKey:[\"_time\"],\n columnKey: [\"_field\"],\n valueColumn: \"_value\"\n )\n |> map(fn: (r) => ({ r with _value: (r.write_bytes / r.time_since_update) * -1.0 }))\n |> aggregateWindow(every: v.windowPeriod, fn: mean, createEmpty: false)\n |> keep(columns: [\"_time\", \"_value\"])\n |> rename(columns: {_value: \"write_rate\"})\n", "rawQuery": true, "refId": "B", "resultFormat": "time_series", "select": [ [ { "params": ["sda2.write_bytes"], "type": "field" }, { "params": [], "type": "mean" } ] ], "series": "diskio", "tags": [], "target": "" } ], "timeFrom": null, "timeShift": null, "title": "$disk disk IO", "type": "timeseries" }, { "datasource": "${DS_GLANCES}", "description": "", "fieldConfig": { "defaults": { "color": { "mode": "palette-classic" }, "custom": { "axisLabel": "", "axisPlacement": "auto", "barAlignment": 0, "drawStyle": "line", "fillOpacity": 0, "gradientMode": "none", "hideFrom": { "legend": false, "tooltip": false, "viz": false }, "lineInterpolation": "linear", "lineWidth": 3, "pointSize": 5, "scaleDistribution": { "type": "linear" }, "showPoints": "never", "spanNulls": true, "stacking": { "group": "A", "mode": "none" }, "thresholdsStyle": { "mode": "off" } }, "mappings": [], "min": 0, "thresholds": { "mode": "absolute", "steps": [ { "color": "green", "value": null }, { "color": "red", "value": 80 } ] }, "unit": "bytes" }, "overrides": [ { "matcher": { "id": "byName", "options": "Max" }, "properties": [ { "id": "color", "value": { "fixedColor": "#BF1B00", "mode": "fixed" } } ] }, { "matcher": { "id": "byName", "options": "Used" }, "properties": [ { "id": "custom.fillOpacity", "value": 100 }, { "id": "custom.fillOpacity", "value": 80 } ] } ] }, "gridPos": { "h": 7, "w": 10, "x": 12, "y": 21 }, "id": 11, "links": [], "options": { "legend": { "calcs": [], "displayMode": "list", "placement": "bottom" }, "tooltip": { "mode": "single" } }, "pluginVersion": "8.2.5", "targets": [ { "alias": "Used", "column": "\"/.used\"", "dsType": "influxdb", "function": "mean", "groupBy": [ { "params": ["$__interval"], "type": "time" }, { "params": ["none"], "type": "fill" } ], "measurement": "fs", "orderByTime": "ASC", "policy": "default", "query": "from(bucket: \"glances\")\n |> range(start: v.timeRangeStart, stop:v.timeRangeStop)\n |> filter(fn: (r) =>\n r._measurement == \"fs\" and\n r._field == \"used\" and\n r.mnt_point == \"/\" and \n r.hostname == \"${host}\"\n )\n |> aggregateWindow(every: v.windowPeriod, fn: mean, createEmpty: false)\n |> yield(name: \"used\")\n \n ", "refId": "A", "resultFormat": "time_series", "select": [ [ { "params": ["used"], "type": "field" }, { "params": [], "type": "mean" } ] ], "series": "fs", "tags": [ { "key": "mnt_point", "operator": "=", "value": "/" }, { "condition": "AND", "key": "hostname", "operator": "=~", "value": "/^$host$/" } ] }, { "alias": "Max", "column": "\"/.size\"", "dsType": "influxdb", "function": "mean", "groupBy": [ { "params": ["$__interval"], "type": "time" }, { "params": ["none"], "type": "fill" } ], "measurement": "fs", "orderByTime": "ASC", "policy": "default", "query": "from(bucket: \"glances\")\n |> range(start: v.timeRangeStart, stop:v.timeRangeStop)\n |> filter(fn: (r) =>\n r._measurement == \"fs\" and\n r._field == \"size\" and\n r.mnt_point == \"/\" and \n r.hostname == \"${host}\"\n )\n |> aggregateWindow(every: v.windowPeriod, fn: mean, createEmpty: false)\n |> yield(name: \"size\")\n \n ", "refId": "B", "resultFormat": "time_series", "select": [ [ { "params": ["size"], "type": "field" }, { "params": [], "type": "mean" } ] ], "series": "fs", "tags": [ { "key": "mnt_point", "operator": "=", "value": "/" }, { "condition": "AND", "key": "hostname", "operator": "=~", "value": "/^$host$/" } ], "target": "" } ], "timeFrom": null, "timeShift": null, "title": "/ Size", "type": "timeseries" }, { "cacheTimeout": null, "datasource": "${DS_GLANCES}", "fieldConfig": { "defaults": { "color": { "mode": "thresholds" }, "mappings": [ { "options": { "match": "null", "result": { "text": "N/A" } }, "type": "special" } ], "thresholds": { "mode": "absolute", "steps": [ { "color": "rgba(71, 212, 59, 0.4)", "value": null }, { "color": "rgba(245, 150, 40, 0.73)", "value": 70 }, { "color": "rgba(225, 40, 40, 0.59)", "value": 90 } ] }, "unit": "percent" }, "overrides": [] }, "gridPos": { "h": 7, "w": 2, "x": 22, "y": 21 }, "id": 16, "interval": null, "links": [], "maxDataPoints": 100, "options": { "colorMode": "background", "graphMode": "area", "justifyMode": "auto", "orientation": "horizontal", "reduceOptions": { "calcs": ["mean"], "fields": "", "values": false }, "text": {}, "textMode": "auto" }, "pluginVersion": "8.2.5", "targets": [ { "column": "\"/.percent\"", "dsType": "influxdb", "function": "mean", "groupBy": [ { "params": ["auto"], "type": "time" } ], "measurement": "fs", "orderByTime": "ASC", "policy": "default", "query": "from(bucket: \"glances\")\n |> range(start: v.timeRangeStart, stop:v.timeRangeStop)\n |> filter(fn: (r) =>\n r._measurement == \"fs\" and\n r._field == \"percent\" and\n r.mnt_point == \"/\" and \n r.hostname == \"${host}\"\n )\n |> last()\n", "refId": "A", "resultFormat": "time_series", "select": [ [ { "params": ["percent"], "type": "field" }, { "params": [], "type": "mean" } ] ], "series": "fs", "tags": [ { "key": "mnt_point", "operator": "=", "value": "/" }, { "condition": "AND", "key": "hostname", "operator": "=~", "value": "/^$host$/" } ] } ], "title": "/ used", "type": "stat" }, { "collapsed": false, "datasource": null, "gridPos": { "h": 1, "w": 24, "x": 0, "y": 28 }, "id": 33, "panels": [], "title": "Sensors $host", "type": "row" }, { "cards": { "cardPadding": null, "cardRound": null }, "color": { "cardColor": "rgb(255, 0, 0)", "colorScale": "sqrt", "colorScheme": "interpolateReds", "exponent": 1, "min": null, "mode": "opacity" }, "dataFormat": "timeseries", "datasource": "${DS_GLANCES}", "gridPos": { "h": 6, "w": 12, "x": 0, "y": 29 }, "heatmap": {}, "hideZeroBuckets": false, "highlightCards": true, "id": 21, "legend": { "show": false }, "links": [], "reverseYBuckets": false, "targets": [ { "alias": "AmbientTemperature", "dsType": "influxdb", "groupBy": [ { "params": ["$__interval"], "type": "time" }, { "params": ["null"], "type": "fill" } ], "measurement": "sensors", "orderByTime": "ASC", "policy": "default", "query": "from(bucket: \"glances\")\n |> range(start: v.timeRangeStart, stop:v.timeRangeStop)\n |> filter(fn: (r) =>\n r._measurement == \"sensors\" and\n r._field == \"value\" and\n r.label == \"Ambient\" and\n r.hostname == \"${host}\"\n )\n |> aggregateWindow(every: v.windowPeriod, fn: mean, createEmpty: false)\n |> yield(name: \"Ambient\")\n \n ", "refId": "A", "resultFormat": "time_series", "select": [ [ { "params": ["value"], "type": "field" }, { "params": [], "type": "mean" } ] ], "tags": [ { "key": "label", "operator": "=", "value": "Ambient" }, { "condition": "AND", "key": "hostname", "operator": "=~", "value": "/^$host$/" } ] } ], "title": "Ambient temperature", "tooltip": { "show": true, "showHistogram": false }, "type": "heatmap", "xAxis": { "show": true }, "xBucketNumber": null, "xBucketSize": null, "yAxis": { "decimals": null, "format": "celsius", "logBase": 1, "max": null, "min": "0", "show": true, "splitFactor": null }, "yBucketBound": "auto", "yBucketNumber": null, "yBucketSize": null }, { "cards": { "cardPadding": null, "cardRound": null }, "color": { "cardColor": "rgb(255, 0, 0)", "colorScale": "sqrt", "colorScheme": "interpolateOranges", "exponent": 1, "mode": "opacity" }, "dataFormat": "timeseries", "datasource": "${DS_GLANCES}", "gridPos": { "h": 6, "w": 12, "x": 12, "y": 29 }, "heatmap": {}, "hideZeroBuckets": false, "highlightCards": true, "id": 23, "legend": { "show": false }, "links": [], "reverseYBuckets": false, "targets": [ { "alias": "CpuTemperature", "dsType": "influxdb", "groupBy": [ { "params": ["$__interval"], "type": "time" }, { "params": ["null"], "type": "fill" } ], "measurement": "sensors", "orderByTime": "ASC", "policy": "default", "query": "from(bucket: \"glances\")\n |> range(start: v.timeRangeStart, stop:v.timeRangeStop)\n |> filter(fn: (r) =>\n r._measurement == \"sensors\" and\n r._field == \"value\" and\n r.label == \"CPU\" and\n r.hostname == \"${host}\"\n )\n |> aggregateWindow(every: v.windowPeriod, fn: mean, createEmpty: false)\n |> yield(name: \"Ambient\")\n \n ", "refId": "A", "resultFormat": "time_series", "select": [ [ { "params": ["value"], "type": "field" }, { "params": [], "type": "mean" } ] ], "tags": [ { "key": "label", "operator": "=", "value": "CPU" }, { "condition": "AND", "key": "hostname", "operator": "=~", "value": "/^$host$/" } ] } ], "title": "CPU temperature", "tooltip": { "show": true, "showHistogram": false }, "type": "heatmap", "xAxis": { "show": true }, "xBucketNumber": null, "xBucketSize": null, "yAxis": { "decimals": null, "format": "celsius", "logBase": 1, "max": null, "min": "0", "show": true, "splitFactor": null }, "yBucketBound": "auto", "yBucketNumber": null, "yBucketSize": null }, { "collapsed": false, "datasource": null, "gridPos": { "h": 1, "w": 24, "x": 0, "y": 35 }, "id": 37, "panels": [], "title": "Containers hosted on $host", "type": "row" }, { "datasource": "${DS_GLANCES}", "fieldConfig": { "defaults": { "color": { "mode": "palette-classic" }, "custom": { "axisLabel": "", "axisPlacement": "auto", "barAlignment": 0, "drawStyle": "line", "fillOpacity": 0, "gradientMode": "none", "hideFrom": { "legend": false, "tooltip": false, "viz": false }, "lineInterpolation": "linear", "lineWidth": 2, "pointSize": 5, "scaleDistribution": { "type": "linear" }, "showPoints": "never", "spanNulls": true, "stacking": { "group": "A", "mode": "none" }, "thresholdsStyle": { "mode": "off" } }, "mappings": [], "min": 0, "thresholds": { "mode": "absolute", "steps": [ { "color": "green", "value": null }, { "color": "red", "value": 80 } ] }, "unit": "short" }, "overrides": [ { "matcher": { "id": "byName", "options": "cpu_percent" }, "properties": [ { "id": "color", "value": { "fixedColor": "#cca300", "mode": "fixed" } }, { "id": "unit", "value": "percent" } ] }, { "matcher": { "id": "byName", "options": "memory_usage" }, "properties": [ { "id": "color", "value": { "fixedColor": "#2f575e", "mode": "fixed" } }, { "id": "unit", "value": "decbytes" }, { "id": "custom.fillOpacity", "value": 36 } ] } ] }, "gridPos": { "h": 8, "w": 24, "x": 0, "y": 36 }, "id": 25, "links": [], "options": { "legend": { "calcs": [], "displayMode": "list", "placement": "bottom" }, "tooltip": { "mode": "single" } }, "pluginVersion": "8.2.5", "repeat": "container", "repeatDirection": "v", "targets": [ { "alias": "MEM", "groupBy": [ { "params": ["$__interval"], "type": "time" }, { "params": ["none"], "type": "fill" } ], "hide": false, "measurement": "containers", "orderByTime": "ASC", "policy": "default", "query": "from(bucket: \"glances\")\n |> range(start: v.timeRangeStart, stop:v.timeRangeStop)\n |> filter(fn: (r) =>\n r._measurement == \"containers\" and\n r._field == \"memory_usage\" and\n r.name == \"${container}\" and\n r.hostname == \"${host}\"\n )\n |> aggregateWindow(every: v.windowPeriod, fn: mean, createEmpty: false)\n |> yield(name: \"MEM\")\n \n ", "rawQuery": false, "refId": "B", "resultFormat": "time_series", "select": [ [ { "params": ["memory_usage"], "type": "field" }, { "params": [], "type": "mean" } ] ], "tags": [ { "key": "name", "operator": "=~", "value": "/^$container$/" }, { "condition": "AND", "key": "hostname", "operator": "=~", "value": "/^$host$/" } ] }, { "alias": "CPU%", "groupBy": [ { "params": ["$__interval"], "type": "time" }, { "params": ["none"], "type": "fill" } ], "hide": false, "measurement": "containers", "orderByTime": "ASC", "policy": "default", "query": "from(bucket: \"glances\")\n |> range(start: v.timeRangeStart, stop:v.timeRangeStop)\n |> filter(fn: (r) =>\n r._measurement == \"containers\" and\n r._field == \"cpu_percent\" and\n r.name == \"${container}\" and\n r.hostname == \"${host}\"\n )\n |> aggregateWindow(every: v.windowPeriod, fn: mean, createEmpty: false)\n |> yield(name: \"CPU%\")\n \n ", "rawQuery": false, "refId": "A", "resultFormat": "time_series", "select": [ [ { "params": ["cpu_percent"], "type": "field" }, { "params": [], "type": "mean" } ] ], "tags": [ { "key": "name", "operator": "=~", "value": "/^$container$/" }, { "condition": "AND", "key": "hostname", "operator": "=~", "value": "/^$host$/" } ] } ], "timeFrom": null, "timeShift": null, "title": "$container container", "type": "timeseries" } ], "refresh": "5s", "schemaVersion": 32, "style": "dark", "tags": [], "templating": { "list": [ { "allValue": null, "current": {}, "datasource": "${DS_GLANCES}", "definition": "import \"influxdata/influxdb/v1\"\nv1.tagValues(\n bucket: v.bucket,\n tag: \"hostname\",\n predicate: (r) => true,\n start: -1d\n)", "description": null, "error": null, "hide": 0, "includeAll": false, "label": null, "multi": false, "name": "host", "options": [], "query": "import \"influxdata/influxdb/v1\"\nv1.tagValues(\n bucket: v.bucket,\n tag: \"hostname\",\n predicate: (r) => true,\n start: -1d\n)", "refresh": 1, "regex": "", "skipUrlSync": false, "sort": 0, "tagValuesQuery": "", "tagsQuery": "", "type": "query", "useTags": false }, { "allValue": null, "current": {}, "datasource": "${DS_GLANCES}", "definition": "import \"influxdata/influxdb/v1\"\nv1.tagValues(\n bucket: v.bucket,\n tag: \"name\",\n predicate: (r) => true,\n start: -1d\n)", "description": null, "error": null, "hide": 0, "includeAll": true, "label": null, "multi": true, "name": "container", "options": [], "query": "import \"influxdata/influxdb/v1\"\nv1.tagValues(\n bucket: v.bucket,\n tag: \"name\",\n predicate: (r) => true,\n start: -1d\n)", "refresh": 1, "regex": "", "skipUrlSync": false, "sort": 1, "tagValuesQuery": "", "tagsQuery": "", "type": "query", "useTags": false }, { "allValue": null, "current": {}, "datasource": "${DS_GLANCES}", "definition": "import \"influxdata/influxdb/v1\"\nv1.tagValues(\n bucket: v.bucket,\n tag: \"interface_name\",\n predicate: (r) => true,\n start: -1d\n)", "description": null, "error": null, "hide": 0, "includeAll": false, "label": null, "multi": false, "name": "interface", "options": [], "query": "import \"influxdata/influxdb/v1\"\nv1.tagValues(\n bucket: v.bucket,\n tag: \"interface_name\",\n predicate: (r) => true,\n start: -1d\n)", "refresh": 1, "regex": "", "skipUrlSync": false, "sort": 1, "tagValuesQuery": "", "tagsQuery": "", "type": "query", "useTags": false }, { "allValue": null, "current": {}, "datasource": "${DS_GLANCES}", "definition": "import \"influxdata/influxdb/v1\"\nv1.tagValues(\n bucket: v.bucket,\n tag: \"disk_name\",\n predicate: (r) => true,\n start: -1d\n)", "description": null, "error": null, "hide": 0, "includeAll": false, "label": null, "multi": false, "name": "disk", "options": [], "query": "import \"influxdata/influxdb/v1\"\nv1.tagValues(\n bucket: v.bucket,\n tag: \"disk_name\",\n predicate: (r) => true,\n start: -1d\n)", "refresh": 1, "regex": "", "skipUrlSync": false, "sort": 1, "tagValuesQuery": "", "tagsQuery": "", "type": "query", "useTags": false } ] }, "time": { "from": "now-1h", "to": "now" }, "timepicker": { "collapse": false, "enable": true, "notice": false, "now": true, "refresh_intervals": [ "5s", "10s", "30s", "1m", "5m", "15m", "30m", "1h", "2h", "1d" ], "status": "Stable", "time_options": ["5m", "15m", "1h", "6h", "12h", "24h", "2d", "7d", "30d"], "type": "timepicker" }, "timezone": "browser", "title": "Glances For FLUX", "uid": "ESYAe0tnk", "version": 21 } ================================================ FILE: conf/glances-grafana-influxql.json ================================================ { "__inputs": [ { "name": "DS_GLANCES", "label": "glances", "description": "", "type": "datasource", "pluginId": "influxdb", "pluginName": "InfluxDB" }, { "name": "DS_LSAT1", "label": "lsat1", "description": "", "type": "datasource", "pluginId": "influxdb", "pluginName": "InfluxDB" } ], "__elements": {}, "__requires": [ { "type": "grafana", "id": "grafana", "name": "Grafana", "version": "10.4.1" }, { "type": "datasource", "id": "influxdb", "name": "InfluxDB", "version": "1.0.0" }, { "type": "panel", "id": "stat", "name": "Stat", "version": "" }, { "type": "panel", "id": "text", "name": "Text", "version": "" }, { "type": "panel", "id": "timeseries", "name": "Time series", "version": "" } ], "annotations": { "list": [ { "builtIn": 1, "datasource": { "type": "datasource", "uid": "grafana" }, "enable": true, "hide": true, "iconColor": "rgba(0, 211, 255, 1)", "name": "Annotations & Alerts", "type": "dashboard" } ] }, "editable": true, "fiscalYearStartMonth": 0, "graphTooltip": 0, "id": null, "links": [], "panels": [ { "datasource": { "type": "influxdb", "uid": "${DS_GLANCES}" }, "fieldConfig": { "defaults": { "color": { "mode": "thresholds" }, "mappings": [ { "options": { "match": "null", "result": { "text": "N/A" } }, "type": "special" } ], "thresholds": { "mode": "absolute", "steps": [ { "color": "green", "value": null }, { "color": "red", "value": 80 } ] }, "unit": "none" }, "overrides": [] }, "gridPos": { "h": 6, "w": 2, "x": 0, "y": 0 }, "id": 5, "maxDataPoints": 100, "options": { "colorMode": "none", "graphMode": "none", "justifyMode": "auto", "orientation": "horizontal", "reduceOptions": { "calcs": ["mean"], "fields": "", "values": false }, "showPercentChange": false, "textMode": "auto", "wideLayout": true }, "pluginVersion": "10.4.1", "targets": [ { "column": "cpucore", "datasource": { "type": "influxdb", "uid": "${DS_GLANCES}" }, "dsType": "influxdb", "function": "mean", "groupBy": [ { "params": ["auto"], "type": "time" } ], "measurement": "load", "orderByTime": "ASC", "policy": "default", "query": "SELECT mean(\"cpucore\") FROM \"$host.load\" WHERE $timeFilter GROUP BY time($interval)", "refId": "A", "resultFormat": "time_series", "select": [ [ { "params": ["cpucore"], "type": "field" }, { "params": [], "type": "max" } ] ], "series": "load", "tags": [ { "key": "hostname", "operator": "=~", "value": "/^$host$/" } ] } ], "title": "Core", "type": "stat" }, { "datasource": { "type": "influxdb", "uid": "${DS_GLANCES}" }, "fieldConfig": { "defaults": { "color": { "mode": "palette-classic" }, "custom": { "axisBorderShow": false, "axisCenteredZero": false, "axisColorMode": "text", "axisLabel": "", "axisPlacement": "auto", "barAlignment": 0, "drawStyle": "line", "fillOpacity": 10, "gradientMode": "none", "hideFrom": { "legend": false, "tooltip": false, "viz": false }, "insertNulls": false, "lineInterpolation": "linear", "lineWidth": 2, "pointSize": 5, "scaleDistribution": { "type": "linear" }, "showPoints": "never", "spanNulls": false, "stacking": { "group": "A", "mode": "normal" }, "thresholdsStyle": { "mode": "off" } }, "mappings": [], "thresholds": { "mode": "absolute", "steps": [ { "color": "green", "value": null }, { "color": "red", "value": 80 } ] }, "unit": "short" }, "overrides": [] }, "gridPos": { "h": 6, "w": 20, "x": 2, "y": 0 }, "id": 4, "options": { "legend": { "calcs": ["mean", "max", "min"], "displayMode": "table", "placement": "right", "showLegend": true }, "tooltip": { "mode": "single", "sort": "none" } }, "pluginVersion": "10.4.1", "targets": [ { "alias": "1min", "column": "min1", "datasource": { "type": "influxdb", "uid": "${DS_GLANCES}" }, "dsType": "influxdb", "function": "mean", "groupBy": [ { "params": ["auto"], "type": "time" }, { "params": ["none"], "type": "fill" } ], "measurement": "load", "orderByTime": "ASC", "policy": "default", "query": "SELECT mean(\"min1\") FROM \"$host.load\" WHERE $timeFilter GROUP BY time($interval) fill(null)", "refId": "A", "resultFormat": "time_series", "select": [ [ { "params": ["min1"], "type": "field" }, { "params": [], "type": "mean" } ] ], "series": "load", "tags": [ { "key": "hostname", "operator": "=~", "value": "/^$host$/" } ], "target": "randomWalk('random walk')" }, { "alias": "5mins", "column": "min5", "datasource": { "type": "influxdb", "uid": "${DS_GLANCES}" }, "dsType": "influxdb", "function": "mean", "groupBy": [ { "params": ["auto"], "type": "time" }, { "params": ["none"], "type": "fill" } ], "measurement": "load", "orderByTime": "ASC", "policy": "default", "query": "SELECT mean(\"min5\") FROM \"$host.load\" WHERE $timeFilter GROUP BY time($interval) fill(null)", "refId": "B", "resultFormat": "time_series", "select": [ [ { "params": ["min5"], "type": "field" }, { "params": [], "type": "mean" } ] ], "series": "load", "tags": [ { "key": "hostname", "operator": "=~", "value": "/^$host$/" } ], "target": "" }, { "alias": "15mins", "column": "min15", "datasource": { "type": "influxdb", "uid": "${DS_GLANCES}" }, "dsType": "influxdb", "function": "mean", "groupBy": [ { "params": ["auto"], "type": "time" }, { "params": ["none"], "type": "fill" } ], "measurement": "load", "orderByTime": "ASC", "policy": "default", "query": "SELECT mean(\"min15\") FROM \"$host.load\" WHERE $timeFilter GROUP BY time($interval) fill(null)", "refId": "C", "resultFormat": "time_series", "select": [ [ { "params": ["min15"], "type": "field" }, { "params": [], "type": "mean" } ] ], "series": "load", "tags": [ { "key": "hostname", "operator": "=~", "value": "/^$host$/" } ], "target": "" } ], "title": "Load", "type": "timeseries" }, { "datasource": { "type": "influxdb", "uid": "${DS_GLANCES}" }, "fieldConfig": { "defaults": { "color": { "fixedColor": "rgb(31, 120, 193)", "mode": "fixed" }, "mappings": [ { "options": { "match": "null", "result": { "text": "N/A" } }, "type": "special" } ], "thresholds": { "mode": "absolute", "steps": [ { "color": "green", "value": null }, { "color": "red", "value": 80 } ] }, "unit": "none" }, "overrides": [] }, "gridPos": { "h": 6, "w": 2, "x": 22, "y": 0 }, "id": 18, "maxDataPoints": 100, "options": { "colorMode": "none", "graphMode": "area", "justifyMode": "auto", "orientation": "horizontal", "reduceOptions": { "calcs": ["mean"], "fields": "", "values": false }, "showPercentChange": false, "textMode": "auto", "wideLayout": true }, "pluginVersion": "10.4.1", "targets": [ { "column": "total", "datasource": { "type": "influxdb", "uid": "${DS_GLANCES}" }, "dsType": "influxdb", "function": "mean", "groupBy": [ { "params": ["$__interval"], "type": "time" } ], "measurement": "processcount", "orderByTime": "ASC", "policy": "default", "query": "SELECT mean(\"total\") FROM \"$host.processcount\" WHERE $timeFilter GROUP BY time($interval)", "refId": "A", "resultFormat": "time_series", "select": [ [ { "params": ["total"], "type": "field" }, { "params": [], "type": "last" } ] ], "series": "processcount", "tags": [ { "key": "hostname", "operator": "=~", "value": "/^$host$/" } ] } ], "title": "Processes", "type": "stat" }, { "datasource": { "type": "influxdb", "uid": "${DS_GLANCES}" }, "fieldConfig": { "defaults": { "color": { "mode": "palette-classic" }, "custom": { "axisBorderShow": false, "axisCenteredZero": false, "axisColorMode": "text", "axisLabel": "", "axisPlacement": "auto", "barAlignment": 0, "drawStyle": "line", "fillOpacity": 0, "gradientMode": "none", "hideFrom": { "legend": false, "tooltip": false, "viz": false }, "insertNulls": false, "lineInterpolation": "linear", "lineWidth": 1, "pointSize": 5, "scaleDistribution": { "type": "linear" }, "showPoints": "never", "spanNulls": false, "stacking": { "group": "A", "mode": "none" }, "thresholdsStyle": { "mode": "off" } }, "mappings": [], "thresholds": { "mode": "absolute", "steps": [ { "color": "green", "value": null }, { "color": "red", "value": 80 } ] }, "unit": "percent" }, "overrides": [] }, "gridPos": { "h": 7, "w": 12, "x": 0, "y": 6 }, "id": 6, "options": { "legend": { "calcs": [], "displayMode": "list", "placement": "bottom", "showLegend": true }, "tooltip": { "mode": "single", "sort": "none" } }, "pluginVersion": "10.4.1", "targets": [ { "alias": "User", "column": "user", "datasource": { "type": "influxdb", "uid": "${DS_GLANCES}" }, "dsType": "influxdb", "function": "mean", "groupBy": [ { "params": ["auto"], "type": "time" }, { "params": ["none"], "type": "fill" } ], "measurement": "cpu", "orderByTime": "ASC", "policy": "default", "query": "SELECT mean(\"user\") FROM \"$host.cpu\" WHERE $timeFilter GROUP BY time($interval) fill(null)", "refId": "A", "resultFormat": "time_series", "select": [ [ { "params": ["user"], "type": "field" }, { "params": [], "type": "mean" } ] ], "series": "cpu", "tags": [ { "key": "hostname", "operator": "=~", "value": "/^$host$/" } ] }, { "alias": "System", "column": "system", "datasource": { "type": "influxdb", "uid": "${DS_GLANCES}" }, "dsType": "influxdb", "function": "mean", "groupBy": [ { "params": ["auto"], "type": "time" }, { "params": ["none"], "type": "fill" } ], "measurement": "cpu", "orderByTime": "ASC", "policy": "default", "query": "SELECT mean(\"system\") FROM \"$host.cpu\" WHERE $timeFilter GROUP BY time($interval) fill(null)", "refId": "B", "resultFormat": "time_series", "select": [ [ { "params": ["system"], "type": "field" }, { "params": [], "type": "mean" } ] ], "series": "cpu", "tags": [ { "key": "hostname", "operator": "=~", "value": "/^$host$/" } ], "target": "" }, { "alias": "IoWait", "column": "iowait", "datasource": { "type": "influxdb", "uid": "${DS_GLANCES}" }, "dsType": "influxdb", "function": "mean", "groupBy": [ { "params": ["auto"], "type": "time" }, { "params": ["none"], "type": "fill" } ], "measurement": "cpu", "orderByTime": "ASC", "policy": "default", "query": "SELECT mean(\"iowait\") FROM \"$host.cpu\" WHERE $timeFilter GROUP BY time($interval) fill(null)", "refId": "C", "resultFormat": "time_series", "select": [ [ { "params": ["iowait"], "type": "field" }, { "params": [], "type": "mean" } ] ], "series": "cpu", "tags": [ { "key": "hostname", "operator": "=~", "value": "/^$host$/" } ], "target": "" } ], "title": "CPU (%)", "type": "timeseries" }, { "datasource": { "type": "influxdb", "uid": "${DS_GLANCES}" }, "fieldConfig": { "defaults": { "color": { "mode": "palette-classic" }, "custom": { "axisBorderShow": false, "axisCenteredZero": false, "axisColorMode": "text", "axisLabel": "", "axisPlacement": "auto", "barAlignment": 0, "drawStyle": "line", "fillOpacity": 0, "gradientMode": "none", "hideFrom": { "legend": false, "tooltip": false, "viz": false }, "insertNulls": false, "lineInterpolation": "linear", "lineWidth": 1, "pointSize": 5, "scaleDistribution": { "type": "linear" }, "showPoints": "never", "spanNulls": false, "stacking": { "group": "A", "mode": "none" }, "thresholdsStyle": { "mode": "off" } }, "mappings": [], "min": 0, "thresholds": { "mode": "absolute", "steps": [ { "color": "green", "value": null }, { "color": "red", "value": 80 } ] }, "unit": "bytes" }, "overrides": [ { "matcher": { "id": "byName", "options": "Max" }, "properties": [ { "id": "color", "value": { "fixedColor": "#BF1B00", "mode": "fixed" } } ] } ] }, "gridPos": { "h": 7, "w": 12, "x": 12, "y": 6 }, "id": 7, "options": { "legend": { "calcs": [], "displayMode": "list", "placement": "bottom", "showLegend": true }, "tooltip": { "mode": "single", "sort": "none" } }, "pluginVersion": "10.4.1", "targets": [ { "alias": "Used", "column": "used", "datasource": { "type": "influxdb", "uid": "${DS_GLANCES}" }, "dsType": "influxdb", "function": "mean", "groupBy": [ { "params": ["$__interval"], "type": "time" }, { "params": ["none"], "type": "fill" } ], "measurement": "mem", "orderByTime": "ASC", "policy": "default", "query": "SELECT mean(\"used\") FROM \"mem\" WHERE (\"hostname\" =~ /^$host$/) AND $timeFilter GROUP BY time($__interval) fill(none)", "rawQuery": false, "refId": "A", "resultFormat": "time_series", "select": [ [ { "params": ["used"], "type": "field" }, { "params": [], "type": "mean" } ] ], "series": "mem", "tags": [ { "key": "hostname", "operator": "=~", "value": "/^$host$/" } ] }, { "alias": "Max", "column": "total", "datasource": { "type": "influxdb", "uid": "${DS_GLANCES}" }, "dsType": "influxdb", "function": "mean", "groupBy": [ { "params": ["$__interval"], "type": "time" }, { "params": ["none"], "type": "fill" } ], "measurement": "mem", "orderByTime": "ASC", "policy": "default", "query": "SELECT mean(\"total\") FROM \"mem\" WHERE $timeFilter GROUP BY time($__interval) fill(none)", "rawQuery": false, "refId": "B", "resultFormat": "time_series", "select": [ [ { "params": ["total"], "type": "field" }, { "params": [], "type": "mean" } ] ], "series": "mem", "tags": [ { "key": "hostname", "operator": "=~", "value": "/^$host$/" } ], "target": "" } ], "title": "MEM", "type": "timeseries" }, { "datasource": { "type": "influxdb", "uid": "${DS_GLANCES}" }, "fieldConfig": { "defaults": { "color": { "mode": "palette-classic" }, "custom": { "axisBorderShow": false, "axisCenteredZero": false, "axisColorMode": "text", "axisLabel": "", "axisPlacement": "auto", "barAlignment": 0, "drawStyle": "line", "fillOpacity": 30, "gradientMode": "none", "hideFrom": { "legend": false, "tooltip": false, "viz": false }, "insertNulls": false, "lineInterpolation": "linear", "lineWidth": 1, "pointSize": 5, "scaleDistribution": { "type": "linear" }, "showPoints": "never", "spanNulls": false, "stacking": { "group": "A", "mode": "none" }, "thresholdsStyle": { "mode": "off" } }, "mappings": [], "thresholds": { "mode": "absolute", "steps": [ { "color": "green", "value": null }, { "color": "red", "value": 80 } ] }, "unit": "bps" }, "overrides": [] }, "gridPos": { "h": 7, "w": 12, "x": 0, "y": 13 }, "id": 9, "options": { "legend": { "calcs": ["mean", "max", "min"], "displayMode": "list", "placement": "bottom", "showLegend": true }, "tooltip": { "mode": "single", "sort": "none" } }, "pluginVersion": "10.4.1", "targets": [ { "alias": "In", "column": "enp0s25.rx", "datasource": { "type": "influxdb", "uid": "${DS_GLANCES}" }, "dsType": "influxdb", "function": "mean", "groupBy": [ { "params": ["auto"], "type": "time" }, { "params": ["null"], "type": "fill" } ], "interval": "", "measurement": "$host.network", "orderByTime": "ASC", "policy": "default", "query": "SELECT mean(\"rx\")/mean(\"time_since_update\")*8 FROM \"network\" WHERE (\"hostname\" =~ /^$host$/) AND (\"interface_name\" =~ /^$interface$/) AND $timeFilter GROUP BY time($interval) fill(none)", "rawQuery": true, "refId": "A", "resultFormat": "time_series", "select": [ [ { "params": ["eth0.rx"], "type": "field" }, { "params": [], "type": "mean" } ] ], "series": "network", "tags": [] }, { "alias": "Out", "column": "eth0.tx*-1", "datasource": { "type": "influxdb", "uid": "${DS_GLANCES}" }, "dsType": "influxdb", "function": "mean", "groupBy": [ { "params": ["auto"], "type": "time" }, { "params": ["null"], "type": "fill" } ], "measurement": "$host.network", "orderByTime": "ASC", "policy": "default", "query": "SELECT mean(\"tx\")/mean(\"time_since_update\")*-8 FROM \"network\" WHERE (\"hostname\" =~ /^$host$/) AND (\"interface_name\" =~ /^$interface$/) AND $timeFilter GROUP BY time($interval) fill(none)", "rawQuery": true, "refId": "B", "resultFormat": "time_series", "select": [ [ { "params": ["eth0.tx"], "type": "field" }, { "params": [], "type": "mean" } ] ], "series": "network", "tags": [], "target": "" } ], "title": "$interface network interface", "type": "timeseries" }, { "datasource": { "type": "influxdb", "uid": "${DS_GLANCES}" }, "fieldConfig": { "defaults": { "color": { "mode": "palette-classic" }, "custom": { "axisBorderShow": false, "axisCenteredZero": false, "axisColorMode": "text", "axisLabel": "", "axisPlacement": "auto", "barAlignment": 0, "drawStyle": "line", "fillOpacity": 0, "gradientMode": "none", "hideFrom": { "legend": false, "tooltip": false, "viz": false }, "insertNulls": false, "lineInterpolation": "linear", "lineWidth": 1, "pointSize": 5, "scaleDistribution": { "type": "linear" }, "showPoints": "never", "spanNulls": false, "stacking": { "group": "A", "mode": "none" }, "thresholdsStyle": { "mode": "off" } }, "mappings": [], "min": 0, "thresholds": { "mode": "absolute", "steps": [ { "color": "green", "value": null }, { "color": "red", "value": 80 } ] }, "unit": "bytes" }, "overrides": [ { "matcher": { "id": "byName", "options": "Max" }, "properties": [ { "id": "color", "value": { "fixedColor": "#BF1B00", "mode": "fixed" } } ] } ] }, "gridPos": { "h": 7, "w": 12, "x": 12, "y": 13 }, "id": 8, "options": { "legend": { "calcs": [], "displayMode": "list", "placement": "bottom", "showLegend": true }, "tooltip": { "mode": "single", "sort": "none" } }, "pluginVersion": "10.4.1", "targets": [ { "alias": "Used", "column": "used", "datasource": { "type": "influxdb", "uid": "${DS_GLANCES}" }, "dsType": "influxdb", "function": "mean", "groupBy": [ { "params": ["$__interval"], "type": "time" } ], "measurement": "$host.memswap", "orderByTime": "ASC", "policy": "default", "query": "SELECT mean(\"used\") FROM \"memswap\" WHERE (\"hostname\" =~ /^$host$/) AND $timeFilter GROUP BY time($__interval) fill(none)", "rawQuery": true, "refId": "A", "resultFormat": "time_series", "select": [ [ { "params": ["used"], "type": "field" }, { "params": [], "type": "mean" } ] ], "series": "memswap", "tags": [] }, { "alias": "Max", "column": "total", "datasource": { "type": "influxdb", "uid": "${DS_GLANCES}" }, "dsType": "influxdb", "function": "mean", "groupBy": [ { "params": ["$__interval"], "type": "time" } ], "measurement": "$host.memswap", "orderByTime": "ASC", "policy": "default", "query": "SELECT mean(\"total\") FROM \"memswap\" WHERE (\"hostname\" =~ /^$host$/) AND $timeFilter GROUP BY time($__interval) fill(none)", "rawQuery": true, "refId": "B", "resultFormat": "time_series", "select": [ [ { "params": ["total"], "type": "field" }, { "params": [], "type": "mean" } ] ], "series": "memswap", "tags": [], "target": "" } ], "title": "SWAP", "type": "timeseries" }, { "datasource": { "type": "influxdb", "uid": "${DS_GLANCES}" }, "fieldConfig": { "defaults": { "color": { "mode": "palette-classic" }, "custom": { "axisBorderShow": false, "axisCenteredZero": false, "axisColorMode": "text", "axisLabel": "", "axisPlacement": "auto", "barAlignment": 0, "drawStyle": "line", "fillOpacity": 0, "gradientMode": "none", "hideFrom": { "legend": false, "tooltip": false, "viz": false }, "insertNulls": false, "lineInterpolation": "linear", "lineWidth": 1, "pointSize": 5, "scaleDistribution": { "type": "linear" }, "showPoints": "never", "spanNulls": false, "stacking": { "group": "A", "mode": "none" }, "thresholdsStyle": { "mode": "off" } }, "mappings": [], "thresholds": { "mode": "absolute", "steps": [ { "color": "green", "value": null }, { "color": "red", "value": 80 } ] }, "unit": "bytes" }, "overrides": [] }, "gridPos": { "h": 7, "w": 12, "x": 0, "y": 20 }, "id": 10, "options": { "legend": { "calcs": ["mean", "max", "min"], "displayMode": "list", "placement": "bottom", "showLegend": true }, "tooltip": { "mode": "single", "sort": "none" } }, "pluginVersion": "10.4.1", "targets": [ { "alias": "Read", "column": "sda2.read_bytes", "datasource": { "type": "influxdb", "uid": "${DS_GLANCES}" }, "dsType": "influxdb", "function": "mean", "groupBy": [ { "params": ["auto"], "type": "time" }, { "params": ["none"], "type": "fill" } ], "measurement": "$host.diskio", "orderByTime": "ASC", "policy": "default", "query": "SELECT mean(\"read_bytes\")/mean(\"time_since_update\") FROM \"diskio\" WHERE (\"hostname\" =~ /^$host$/) AND (\"disk_name\" =~ /^$disk$/) AND $timeFilter GROUP BY time($__interval) fill(none)", "rawQuery": true, "refId": "A", "resultFormat": "time_series", "select": [ [ { "params": ["sda2.read_bytes"], "type": "field" }, { "params": [], "type": "mean" } ] ], "series": "diskio", "tags": [] }, { "alias": "Write", "column": "sda2.write_bytes", "datasource": { "type": "influxdb", "uid": "${DS_GLANCES}" }, "dsType": "influxdb", "function": "mean", "groupBy": [ { "params": ["auto"], "type": "time" }, { "params": ["none"], "type": "fill" } ], "measurement": "$host.diskio", "orderByTime": "ASC", "policy": "default", "query": "SELECT mean(\"write_bytes\")/mean(\"time_since_update\") FROM \"diskio\" WHERE (\"hostname\" =~ /^$host$/) AND (\"disk_name\" =~ /^$disk$/) AND $timeFilter GROUP BY time($__interval) fill(none)", "rawQuery": true, "refId": "B", "resultFormat": "time_series", "select": [ [ { "params": ["sda2.write_bytes"], "type": "field" }, { "params": [], "type": "mean" } ] ], "series": "diskio", "tags": [], "target": "" } ], "title": "$disk disk IO", "type": "timeseries" }, { "datasource": { "type": "influxdb", "uid": "${DS_GLANCES}" }, "fieldConfig": { "defaults": { "color": { "mode": "palette-classic" }, "custom": { "axisBorderShow": false, "axisCenteredZero": false, "axisColorMode": "text", "axisLabel": "", "axisPlacement": "auto", "barAlignment": 0, "drawStyle": "line", "fillOpacity": 0, "gradientMode": "none", "hideFrom": { "legend": false, "tooltip": false, "viz": false }, "insertNulls": false, "lineInterpolation": "linear", "lineWidth": 3, "pointSize": 5, "scaleDistribution": { "type": "linear" }, "showPoints": "never", "spanNulls": false, "stacking": { "group": "A", "mode": "none" }, "thresholdsStyle": { "mode": "off" } }, "mappings": [], "min": 0, "thresholds": { "mode": "absolute", "steps": [ { "color": "green", "value": null }, { "color": "red", "value": 80 } ] }, "unit": "bytes" }, "overrides": [ { "matcher": { "id": "byName", "options": "Max" }, "properties": [ { "id": "color", "value": { "fixedColor": "#BF1B00", "mode": "fixed" } } ] }, { "matcher": { "id": "byName", "options": "Used" }, "properties": [ { "id": "custom.fillOpacity", "value": 100 }, { "id": "custom.fillOpacity", "value": 80 } ] } ] }, "gridPos": { "h": 7, "w": 8, "x": 12, "y": 20 }, "id": 11, "options": { "legend": { "calcs": [], "displayMode": "list", "placement": "bottom", "showLegend": true }, "tooltip": { "mode": "single", "sort": "none" } }, "pluginVersion": "10.4.1", "targets": [ { "alias": "Used", "column": "\"/.used\"", "datasource": { "type": "influxdb", "uid": "${DS_GLANCES}" }, "dsType": "influxdb", "function": "mean", "groupBy": [ { "params": ["$__interval"], "type": "time" }, { "params": ["none"], "type": "fill" } ], "measurement": "fs", "orderByTime": "ASC", "policy": "default", "query": "SELECT mean(\"/.used\") FROM \"$host.fs\" WHERE $timeFilter GROUP BY time($interval) fill(null)", "refId": "A", "resultFormat": "time_series", "select": [ [ { "params": ["used"], "type": "field" }, { "params": [], "type": "mean" } ] ], "series": "fs", "tags": [ { "key": "mnt_point", "operator": "=", "value": "/" }, { "condition": "AND", "key": "hostname", "operator": "=~", "value": "/^$host$/" } ] }, { "alias": "Max", "column": "\"/.size\"", "datasource": { "type": "influxdb", "uid": "${DS_GLANCES}" }, "dsType": "influxdb", "function": "mean", "groupBy": [ { "params": ["$__interval"], "type": "time" }, { "params": ["none"], "type": "fill" } ], "measurement": "fs", "orderByTime": "ASC", "policy": "default", "query": "SELECT mean(\"/.size\") FROM \"$host.fs\" WHERE $timeFilter GROUP BY time($interval) fill(null)", "refId": "B", "resultFormat": "time_series", "select": [ [ { "params": ["size"], "type": "field" }, { "params": [], "type": "mean" } ] ], "series": "fs", "tags": [ { "key": "mnt_point", "operator": "=", "value": "/" }, { "condition": "AND", "key": "hostname", "operator": "=~", "value": "/^$host$/" } ], "target": "" } ], "title": "/ Size", "type": "timeseries" }, { "datasource": { "type": "influxdb", "uid": "${DS_GLANCES}" }, "fieldConfig": { "defaults": { "color": { "mode": "thresholds" }, "mappings": [ { "options": { "match": "null", "result": { "text": "N/A" } }, "type": "special" } ], "thresholds": { "mode": "absolute", "steps": [ { "color": "rgba(71, 212, 59, 0.4)", "value": null }, { "color": "rgba(245, 150, 40, 0.73)", "value": 70 }, { "color": "rgba(225, 40, 40, 0.59)", "value": 90 } ] }, "unit": "percent" }, "overrides": [] }, "gridPos": { "h": 7, "w": 2, "x": 20, "y": 20 }, "id": 16, "maxDataPoints": 100, "options": { "colorMode": "background", "graphMode": "area", "justifyMode": "auto", "orientation": "horizontal", "reduceOptions": { "calcs": ["mean"], "fields": "", "values": false }, "showPercentChange": false, "textMode": "auto", "wideLayout": true }, "pluginVersion": "10.4.1", "targets": [ { "column": "\"/.percent\"", "datasource": { "type": "influxdb", "uid": "${DS_GLANCES}" }, "dsType": "influxdb", "function": "mean", "groupBy": [ { "params": ["auto"], "type": "time" } ], "measurement": "fs", "orderByTime": "ASC", "policy": "default", "query": "SELECT mean(\"/.percent\") FROM \"$host.fs\" WHERE $timeFilter GROUP BY time($interval)", "refId": "A", "resultFormat": "time_series", "select": [ [ { "params": ["percent"], "type": "field" }, { "params": [], "type": "mean" } ] ], "series": "fs", "tags": [ { "key": "mnt_point", "operator": "=", "value": "/" }, { "condition": "AND", "key": "hostname", "operator": "=~", "value": "/^$host$/" } ] } ], "title": "/ used", "type": "stat" }, { "datasource": { "type": "influxdb", "uid": "${DS_GLANCES}" }, "fieldConfig": { "defaults": { "color": { "mode": "thresholds" }, "mappings": [ { "options": { "match": "null", "result": { "text": "N/A" } }, "type": "special" } ], "thresholds": { "mode": "absolute", "steps": [ { "color": "rgba(71, 212, 59, 0.4)", "value": null }, { "color": "rgba(245, 150, 40, 0.73)", "value": 70 }, { "color": "rgba(225, 40, 40, 0.59)", "value": 90 } ] }, "unit": "percent" }, "overrides": [] }, "gridPos": { "h": 7, "w": 2, "x": 22, "y": 20 }, "id": 17, "maxDataPoints": 100, "options": { "colorMode": "background", "graphMode": "area", "justifyMode": "auto", "orientation": "horizontal", "reduceOptions": { "calcs": ["mean"], "fields": "", "values": false }, "showPercentChange": false, "textMode": "auto", "wideLayout": true }, "pluginVersion": "10.4.1", "targets": [ { "column": "\"/home.percent\"", "datasource": { "type": "influxdb", "uid": "${DS_GLANCES}" }, "dsType": "influxdb", "function": "mean", "groupBy": [ { "params": ["auto"], "type": "time" } ], "measurement": "fs", "orderByTime": "ASC", "policy": "default", "query": "SELECT mean(\"percent\") FROM \"fs\" WHERE (\"hostname\" =~ /^$host$/) AND (\"mnt_point\" = '/boot') AND $timeFilter GROUP BY time($__interval)", "rawQuery": true, "refId": "A", "resultFormat": "time_series", "select": [ [ { "params": ["percent"], "type": "field" }, { "params": [], "type": "mean" } ] ], "series": "fs", "tags": [ { "key": "mnt_point", "operator": "=", "value": "/boot" } ] } ], "title": "/boot used", "type": "stat" }, { "datasource": { "type": "influxdb", "uid": "${DS_LSAT1}" }, "gridPos": { "h": 3, "w": 24, "x": 0, "y": 27 }, "id": 22, "options": { "code": { "language": "plaintext", "showLineNumbers": false, "showMiniMap": false }, "content": "", "mode": "markdown" }, "pluginVersion": "10.4.1", "targets": [ { "datasource": { "type": "influxdb", "uid": "${DS_LSAT1}" }, "refId": "A" } ], "title": "Sensors", "type": "text" }, { "datasource": { "type": "influxdb", "uid": "${DS_GLANCES}" }, "description": "", "fieldConfig": { "defaults": { "color": { "mode": "palette-classic" }, "custom": { "axisBorderShow": false, "axisCenteredZero": false, "axisColorMode": "text", "axisLabel": "", "axisPlacement": "auto", "barAlignment": 0, "drawStyle": "line", "fillOpacity": 0, "gradientMode": "none", "hideFrom": { "legend": false, "tooltip": false, "viz": false }, "insertNulls": false, "lineInterpolation": "linear", "lineWidth": 1, "pointSize": 5, "scaleDistribution": { "type": "linear" }, "showPoints": "auto", "spanNulls": false, "stacking": { "group": "A", "mode": "none" }, "thresholdsStyle": { "mode": "off" } }, "fieldMinMax": false, "mappings": [], "thresholds": { "mode": "absolute", "steps": [ { "color": "green", "value": null }, { "color": "red", "value": 80 } ] }, "unit": "celsius" }, "overrides": [] }, "gridPos": { "h": 6, "w": 12, "x": 0, "y": 30 }, "id": 21, "options": { "legend": { "calcs": [], "displayMode": "list", "placement": "bottom", "showLegend": true }, "tooltip": { "mode": "single", "sort": "none" } }, "pluginVersion": "10.4.1", "targets": [ { "alias": "$tag_label", "datasource": { "type": "influxdb", "uid": "${DS_GLANCES}" }, "dsType": "influxdb", "groupBy": [ { "params": ["$__interval"], "type": "time" }, { "params": ["label::tag"], "type": "tag" }, { "params": ["null"], "type": "fill" } ], "measurement": "sensors", "orderByTime": "ASC", "policy": "default", "refId": "A", "resultFormat": "time_series", "select": [ [ { "params": ["value"], "type": "field" }, { "params": [], "type": "mean" } ] ], "tags": [ { "condition": "AND", "key": "hostname", "operator": "=~", "value": "/^$host$/" }, { "condition": "AND", "key": "type", "operator": "=~", "value": "/^SensorType.CPU_TEMP$/" } ] } ], "title": "CPU temperature", "type": "timeseries" }, { "datasource": { "type": "influxdb", "uid": "${DS_GLANCES}" }, "description": "", "fieldConfig": { "defaults": { "color": { "mode": "palette-classic" }, "custom": { "axisBorderShow": false, "axisCenteredZero": false, "axisColorMode": "text", "axisLabel": "", "axisPlacement": "auto", "barAlignment": 0, "drawStyle": "line", "fillOpacity": 0, "gradientMode": "none", "hideFrom": { "legend": false, "tooltip": false, "viz": false }, "insertNulls": false, "lineInterpolation": "linear", "lineWidth": 1, "pointSize": 5, "scaleDistribution": { "type": "linear" }, "showPoints": "auto", "spanNulls": false, "stacking": { "group": "A", "mode": "none" }, "thresholdsStyle": { "mode": "off" } }, "fieldMinMax": false, "mappings": [], "thresholds": { "mode": "absolute", "steps": [ { "color": "green", "value": null }, { "color": "red", "value": 80 } ] }, "unit": "rotrpm" }, "overrides": [] }, "gridPos": { "h": 6, "w": 12, "x": 12, "y": 30 }, "id": 32, "options": { "legend": { "calcs": [], "displayMode": "list", "placement": "bottom", "showLegend": true }, "tooltip": { "mode": "single", "sort": "none" } }, "pluginVersion": "10.4.1", "targets": [ { "alias": "$tag_label", "datasource": { "type": "influxdb", "uid": "${DS_GLANCES}" }, "dsType": "influxdb", "groupBy": [ { "params": ["$__interval"], "type": "time" }, { "params": ["label::tag"], "type": "tag" }, { "params": ["null"], "type": "fill" } ], "measurement": "sensors", "orderByTime": "ASC", "policy": "default", "refId": "A", "resultFormat": "time_series", "select": [ [ { "params": ["value"], "type": "field" }, { "params": [], "type": "mean" } ] ], "tags": [ { "condition": "AND", "key": "hostname", "operator": "=~", "value": "/^$host$/" }, { "condition": "AND", "key": "type", "operator": "=~", "value": "/^SensorType.FAN_SPEED$/" } ] } ], "title": "FAN speed", "type": "timeseries" }, { "datasource": { "type": "influxdb", "uid": "${DS_LSAT1}" }, "editable": true, "error": false, "gridPos": { "h": 3, "w": 24, "x": 0, "y": 36 }, "id": 13, "options": { "code": { "language": "plaintext", "showLineNumbers": false, "showMiniMap": false }, "content": "", "mode": "markdown" }, "pluginVersion": "10.4.1", "style": {}, "targets": [ { "datasource": { "type": "influxdb", "uid": "${DS_LSAT1}" }, "refId": "A" } ], "title": "Containers", "type": "text" }, { "datasource": { "type": "influxdb", "uid": "${DS_GLANCES}" }, "fieldConfig": { "defaults": { "color": { "mode": "palette-classic" }, "custom": { "axisBorderShow": false, "axisCenteredZero": false, "axisColorMode": "text", "axisLabel": "", "axisPlacement": "auto", "barAlignment": 0, "drawStyle": "line", "fillOpacity": 0, "gradientMode": "none", "hideFrom": { "legend": false, "tooltip": false, "viz": false }, "insertNulls": false, "lineInterpolation": "linear", "lineWidth": 2, "pointSize": 5, "scaleDistribution": { "type": "linear" }, "showPoints": "never", "spanNulls": false, "stacking": { "group": "A", "mode": "none" }, "thresholdsStyle": { "mode": "off" } }, "mappings": [], "min": 0, "thresholds": { "mode": "absolute", "steps": [ { "color": "green", "value": null }, { "color": "red", "value": 80 } ] }, "unit": "short" }, "overrides": [ { "matcher": { "id": "byName", "options": "MEM" }, "properties": [ { "id": "unit", "value": "decbytes" } ] }, { "matcher": { "id": "byName", "options": "$host.docker.mean" }, "properties": [ { "id": "color", "value": { "fixedColor": "#ba43a9", "mode": "fixed" } } ] }, { "matcher": { "id": "byName", "options": "CPU%" }, "properties": [ { "id": "color", "value": { "fixedColor": "#cca300", "mode": "fixed" } } ] }, { "matcher": { "id": "byName", "options": "MEM" }, "properties": [ { "id": "color", "value": { "fixedColor": "#2f575e", "mode": "fixed" } } ] }, { "matcher": { "id": "byName", "options": "MEM" }, "properties": [ { "id": "unit", "value": "decbytes" } ] }, { "matcher": { "id": "byName", "options": "MEM" }, "properties": [ { "id": "custom.fillOpacity", "value": 100 }, { "id": "custom.fillOpacity", "value": 80 } ] } ] }, "gridPos": { "h": 8, "w": 24, "x": 0, "y": 39 }, "id": 25, "options": { "legend": { "calcs": [], "displayMode": "list", "placement": "bottom", "showLegend": true }, "tooltip": { "mode": "multi", "sort": "none" } }, "pluginVersion": "10.4.1", "repeat": "container", "repeatDirection": "v", "targets": [ { "alias": "CPU%", "datasource": { "type": "influxdb", "uid": "${DS_GLANCES}" }, "groupBy": [ { "params": ["$__interval"], "type": "time" }, { "params": ["none"], "type": "fill" } ], "hide": false, "measurement": "containers", "orderByTime": "ASC", "policy": "default", "query": "SELECT mean(\"cpu_percent\") FROM \"$host.docker\" WHERE $timeFilter GROUP BY time($__interval) fill(none)", "rawQuery": false, "refId": "A", "resultFormat": "time_series", "select": [ [ { "params": ["cpu_percent"], "type": "field" }, { "params": [], "type": "mean" } ] ], "tags": [ { "key": "name", "operator": "=~", "value": "/^$container$/" }, { "condition": "AND", "key": "hostname", "operator": "=~", "value": "/^$host$/" } ] }, { "alias": "MEM", "datasource": { "type": "influxdb", "uid": "${DS_GLANCES}" }, "groupBy": [ { "params": ["$__interval"], "type": "time" }, { "params": ["none"], "type": "fill" } ], "hide": false, "measurement": "containers", "orderByTime": "ASC", "policy": "default", "query": "SELECT mean(\"cpu_percent\") FROM \"$host.docker\" WHERE $timeFilter GROUP BY time($__interval) fill(none)", "rawQuery": false, "refId": "B", "resultFormat": "time_series", "select": [ [ { "params": ["memory_usage"], "type": "field" }, { "params": [], "type": "mean" } ] ], "tags": [ { "key": "name", "operator": "=~", "value": "/^$container$/" }, { "condition": "AND", "key": "hostname", "operator": "=~", "value": "/^$host$/" } ] } ], "title": "$container container", "type": "timeseries" } ], "refresh": "5s", "schemaVersion": 39, "tags": [], "templating": { "list": [ { "current": {}, "datasource": { "type": "influxdb", "uid": "${DS_GLANCES}" }, "definition": "show tag values with key=\"hostname\"", "hide": 0, "includeAll": false, "multi": false, "name": "host", "options": [], "query": "show tag values with key=\"hostname\"", "refresh": 1, "regex": "", "skipUrlSync": false, "sort": 0, "tagValuesQuery": "", "tagsQuery": "", "type": "query", "useTags": false }, { "current": {}, "datasource": { "type": "influxdb", "uid": "${DS_GLANCES}" }, "definition": "show tag values with key=\"name\"", "hide": 0, "includeAll": true, "multi": true, "name": "container", "options": [], "query": "show tag values with key=\"name\"", "refresh": 1, "regex": "", "skipUrlSync": false, "sort": 1, "tagValuesQuery": "", "tagsQuery": "", "type": "query", "useTags": false }, { "current": {}, "datasource": { "type": "influxdb", "uid": "${DS_GLANCES}" }, "definition": "show tag values with key=\"interface_name\"", "hide": 0, "includeAll": false, "multi": false, "name": "interface", "options": [], "query": "show tag values with key=\"interface_name\"", "refresh": 1, "regex": "", "skipUrlSync": false, "sort": 1, "tagValuesQuery": "", "tagsQuery": "", "type": "query", "useTags": false }, { "current": {}, "datasource": { "type": "influxdb", "uid": "${DS_GLANCES}" }, "definition": "show tag values with key=\"disk_name\"", "hide": 0, "includeAll": false, "multi": false, "name": "disk", "options": [], "query": "show tag values with key=\"disk_name\"", "refresh": 1, "regex": "", "skipUrlSync": false, "sort": 1, "tagValuesQuery": "", "tagsQuery": "", "type": "query", "useTags": false } ] }, "time": { "from": "now-1h", "to": "now" }, "timepicker": { "collapse": false, "enable": true, "notice": false, "now": true, "refresh_intervals": [ "5s", "10s", "30s", "1m", "5m", "15m", "30m", "1h", "2h", "1d" ], "status": "Stable", "time_options": ["5m", "15m", "1h", "6h", "12h", "24h", "2d", "7d", "30d"], "type": "timepicker" }, "timezone": "browser", "title": "Glances", "uid": "000000002", "version": 5, "weekStart": "" } ================================================ FILE: conf/glances.conf ================================================ ############################################################################## # Globals Glances parameters ############################################################################## [global] # Stats refresh rate (default is a minimum of 2 seconds) # Can be overwrite by the -t option # It is also possible to overwrite it in each plugin sections refresh=2 # Does Glances should 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 ############################################################################## # User interface ############################################################################## [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 # # Specifics options for TUI #-------------------------- # Disable background color #disable_bg=True # # Specifics 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 False. # Set to True only when cors_origins is explicitly configured with specific origins. #cors_credentials=False # 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_password=kfp #ssl_keyfile=./glances.local+3-key.pem #ssl_certfile=./glances.local+3.pem # # JWT Authentication settings # Secret key for signing JWT tokens (generate with: openssl rand -hex 32) # If not set, a random key is generated per server instance (tokens won't survive restart) #jwt_secret_key=your-secure-secret-key-here # Token expiration time in minutes (default: 60) #jwt_expire_minutes=60 # # DNS rebinding protection for the REST API / WebUI # Restrict the HTTP Host header accepted by the web server. # Comma-separated list of hostnames or IPs. Wildcards are supported (e.g. *.example.com). # When this key is absent or commented out, no host filtering is applied (default behaviour). # Recommended for any internet-facing or multi-tenant deployment. #webui_allowed_hosts=localhost,127.0.0.1,myserver.example.com # # MCP # Overwrite the default MCP path #mcp_path=/mcp # Allowed Host headers for the MCP SSE endpoint (DNS rebinding protection). # Comma-separated list. Defaults to localhost,127.0.0.1 when not set. # Set to * to allow any host - use only behind a trusted reverse proxy. #mcp_allowed_hosts=localhost,127.0.0.1,myserver.example.com ############################################################################## # Plugins ############################################################################## [quicklook] # Set to true to disable a plugin # Note: you can also disable it from the command line (see --disable-plugin ) disable=False # Stats list (default is cpu,mem,load) # Available stats are: cpu,mem,load,swap list=cpu,mem,load # Graphical bar char used in the terminal user interface (default is |) bar_char=▪ # Define CPU, MEM and SWAP thresholds in % cpu_careful=50 cpu_warning=70 cpu_critical=90 mem_careful=50 mem_warning=70 mem_critical=90 swap_careful=50 swap_warning=70 swap_critical=90 # Source: http://blog.scoutapp.com/articles/2009/07/31/understanding-load-averages # With 1 CPU core, the load should be lower than 1.00 ~ 100% load_careful=70 load_warning=100 load_critical=500 [system] # This plugin display the first line in the Glances UI with: # Hostname / Operating system name / Architecture information # Set to true to disable a plugin disable=False # Default refresh rate is 60 seconds #refresh=60 # System information to display (a string where {key} will be replaced by the value) # Available information are: hostname, os_name, os_version, os_arch, linux_distro, platform #system_info_msg= | My {os_name} system | [cpu] disable=False # See https://scoutapm.com/blog/slow_server_flow_chart # # I/O wait percentage should be lower than 1/# (# = Logical CPU cores) # Leave commented to just use the default config: # Careful=1/#*100-20% / Warning=1/#*100-10% / Critical=1/#*100 #iowait_careful=30 #iowait_warning=40 #iowait_critical=50 # # Total % is 100 - idle total_careful=65 total_warning=75 total_critical=85 total_log=True # # Default values if not defined: 50/70/90 (except for iowait) user_careful=50 user_warning=70 user_critical=90 user_log=False #user_critical_action=echo "{{time}} User CPU {{user}} higher than {{critical}}" > /tmp/cpu.alert # system_careful=50 system_warning=70 system_critical=90 system_log=False # steal_careful=50 steal_warning=70 steal_critical=90 #steal_log=True # # Context switch limit (core / second) # Leave commented to just use the default config critical is 50000*(Logical CPU cores) #ctx_switches_careful=10000 #ctx_switches_warning=12000 #ctx_switches_critical=14000 [percpu] disable=False # Define the maximum number of CPU displayed at a time # If the number of CPU is higher than the one configured in max_cpu_display then: # - display top 'max_cpu_display' (sorted by CPU consumption) # - a last line will be added with the mean of all other CPUs max_cpu_display=4 # Define CPU thresholds in % # Default values if not defined: 50/70/90 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 [gpu] disable=False # Default GPU load thresholds in % proc_careful=50 proc_warning=70 proc_critical=90 # Default GPU memory thresholds in % mem_careful=50 mem_warning=70 mem_critical=90 # Default GPU temperature thresholds in degrees Celsus temperature_careful=60 temperature_warning=70 temperature_critical=80 [npu] disable=True # Default NPU load thresholds in % load_careful=50 load_warning=70 load_critical=90 # Default NPU frequency thresholds in % freq_careful=50 freq_warning=70 freq_critical=90 [mem] disable=False # Display available memory instead of used memory #available=True # Define RAM thresholds in % # Default values if not defined: 50/70/90 careful=50 warning=70 critical=90 #critical_action_repeat=echo "{{time}} {{percent}} higher than {{critical}}"" >> /tmp/memory.alert [memswap] disable=False # Define SWAP thresholds in % # Default values if not defined: 50/70/90 careful=50 warning=70 critical=90 #warning_action=echo "{{time}} {{percent}} higher than {{warning}}"" > /tmp/memory.alert [load] disable=False # Define LOAD thresholds # Value * number of cores # Default values if not defined: 0.7/1.0/5.0 per number of cores # Source: http://blog.scoutapp.com/articles/2009/07/31/understanding-load-averages # http://www.linuxjournal.com/article/9001 careful=0.7 warning=1.0 critical=5.0 #log=False [network] disable=False # Default bitrate thresholds in % of the network interface speed # Default values if not defined: 70/80/90 rx_careful=70 rx_warning=80 rx_critical=90 tx_careful=70 tx_warning=80 tx_critical=90 # Define the list of hidden network interfaces (comma-separated regexp) hide=docker.*,lo # Define the list of wireless network interfaces to be show (comma-separated) #show=docker.* # Automatically hide interface not up (default is False) hide_no_up=True # Automatically hide interface with no IP address (default is False) hide_no_ip=True # Set hide_zero to True to automatically hide interface with no traffic hide_zero=False # Set hide_threshold_bytes to an integer value to automatically hide # interface with traffic less or equal than this value #hide_threshold_bytes=0 # It is possible to overwrite the bitrate thresholds per interface # WLAN 0 Default limits (in bits per second aka bps) for interface bitrate #wlan0_rx_careful=4000000 #wlan0_rx_warning=5000000 #wlan0_rx_critical=6000000 #wlan0_rx_log=True #wlan0_tx_careful=700000 #wlan0_tx_warning=900000 #wlan0_tx_critical=1000000 #wlan0_tx_log=True #wlan0_rx_critical_action=echo "{{time}} {{interface_name}} RX {{bytes_recv_rate_per_sec}}Bps" > /tmp/network.alert # Alias for network interface name #alias=wlp0s20f3:WIFI [ip] # Disable display of private IP address disable=False # Configure the online service where public IP address information will be downloaded # - public_disabled: Disable public IP address information (set to True for offline platform) # - public_refresh_interval: Refresh interval between to calls to the online service # - public_api: URL of the API (the API should return an JSON object) # - public_username: Login for the online service (if needed) # - public_password: Password for the online service (if needed) # - public_field: Field name of the public IP address in onlibe service JSON message # - public_template: Template to build the public message # # Example for IPLeak service: # public_api=https://ipv4.ipleak.net/json/ # public_field=ip # public_template={ip} {continent_name}/{country_name}/{city_name} # public_disabled=True public_refresh_interval=300 public_api=https://ipv4.ipleak.net/json/ #public_username= #public_password= public_field=ip public_template={continent_name}/{country_name}/{city_name} [connections] # Display additional information about TCP connections # This plugin is disabled by default because it consumes lots of CPU disable=True # nf_conntrack thresholds in % nf_conntrack_percent_careful=70 nf_conntrack_percent_warning=80 nf_conntrack_percent_critical=90 [wifi] disable=False # Define SIGNAL thresholds in dBm (lower is better...) # Based on: http://serverfault.com/questions/501025/industry-standard-for-minimum-wifi-signal-strength careful=-65 warning=-75 critical=-85 [diskio] disable=False # Define the list of hidden disks (comma-separated regexp) #hide=sda2,sda5,loop.* hide=loop.*,/dev/loop.* # Set hide_zero to True to automatically hide disk with no read/write hide_zero=False # Set hide_threshold_bytes to an integer value to automatically hide # interface with traffic less or equal than this value #hide_threshold_bytes=0 # Define the list of disks to be show (comma-separated) #show=sda.* # Alias for sda1 and sdb1 #alias=sda1:SystemDisk,sdb1:DataDisk # Default latency thresholds (in ms) (rx = read / tx = write) rx_latency_careful=10 rx_latency_warning=20 rx_latency_critical=50 tx_latency_careful=10 tx_latency_warning=20 tx_latency_critical=50 # Set latency thresholds (latency in ms) for a given disk name (rx = read / tx = write) # dm-0_rx_latency_careful=10 # dm-0_rx_latency_warning=20 # dm-0_rx_latency_critical=50 # dm-0_rx_latency_log=False # dm-0_tx_latency_careful=10 # dm-0_tx_latency_warning=20 # dm-0_tx_latency_critical=50 # dm-0_tx_latency_log=False # There is no default bitrate thresholds for disk (because it is not possible to know the disk speed) # Set bitrate thresholds (in bytes per second) for a given disk name (rx = read / tx = write) #dm-0_rx_careful=4000000000 #dm-0_rx_warning=5000000000 #dm-0_rx_critical=6000000000 #dm-0_rx_log=False #dm-0_tx_careful=700000000 #dm-0_tx_warning=900000000 #dm-0_tx_critical=1000000000 #dm-0_tx_log=False [fs] disable=False # Define the list of file system to hide (comma-separated regexp) hide=/boot.*,.*/snap.* # Define the list of file system to show (comma-separated regexp) #show=/,/srv # Define filesystem space thresholds in % # Default values if not defined: 50/70/90 careful=50 warning=70 critical=90 # It is also possible to define per mount point value # Example: /_careful=40 #/_careful=1 #/_warning=5 #/_critical=10 #/_critical_action=echo "{{time}} {{mnt_point}} filesystem space {{percent}}% higher than {{critical}}%" > /tmp/fs.alert # Allow additional file system types (comma-separated FS type) #allow=shm # Alias for root file system #alias=/:Root,/zfspool:ZFS [irq] # Documentation: https://glances.readthedocs.io/en/latest/aoa/irq.html # This plugin is disabled by default disable=True [folders] # Documentation: https://glances.readthedocs.io/en/latest/aoa/folders.html disable=False # Define a folder list to monitor # The list is composed of items (list_#nb <= 10) # An item is defined by: # * path: absolute path # * careful: optional careful threshold (in MB) # * warning: optional warning threshold (in MB) # * critical: optional critical threshold (in MB) # * refresh: interval in second between two refreshes #folder_1_path=/tmp #folder_1_careful=2500 #folder_1_warning=3000 #folder_1_critical=3500 #folder_1_refresh=60 #folder_2_path=/home/nicolargo/Videos #folder_2_warning=17000 #folder_2_critical=20000 #folder_3_path=/nonexisting #folder_4_path=/root [cloud] # Documentation: https://glances.readthedocs.io/en/latest/aoa/cloud.html # This plugin is disabled by default disable=True [raid] # Documentation: https://glances.readthedocs.io/en/latest/aoa/raid.html # This plugin is disabled by default disable=True [smart] # Documentation: https://glances.readthedocs.io/en/latest/aoa/smart.html # This plugin is disabled by default disable=True # Define the list of sensors to hide (comma-separated regexp) #hide=.*Hide_this_driver.* # Define the list of sensors to show (comma-separated regexp) #show=.*Drive_Temperature.* # List of attributes to hide (comma separated) #hide_attributes=Self-tests,Errors [hddtemp] disable=False # Define hddtemp server IP and port (default is 127.0.0.1 and 7634 (TCP)) host=127.0.0.1 port=7634 [sensors] # Documentation: https://glances.readthedocs.io/en/latest/aoa/sensors.html disable=False # Set the refresh multiplicator for the sensors # By default refresh every Glances refresh * 5 (increase to reduce CPU consumption) #refresh=5 # Hide some sensors (comma separated list of regexp) hide=unknown.* # Show only the following sensors (comma separated list of regexp) #show=CPU.* # Sensors core thresholds (in Celsius...) # By default values are grabbed from the system # Overwrite thresholds for a specific sensor # temperature_core_Ambient_careful=40 # temperature_core_Ambient_warning=60 # temperature_core_Ambient_critical=85 # temperature_core_Ambient_log=True # temperature_core_Ambient_critical_action=echo "{{time}} {{label}} temperature {{value}}{{unit}} higher than {{critical}}{{unit}}" > /tmp/temperature.alert # Overwrite thresholds for a specific type of sensor #temperature_core_careful=45 #temperature_core_warning=65 #temperature_core_critical=80 # Temperatures threshold in °C for hddtemp # Default values if not defined: 45/52/60 #temperature_hdd_careful=45 #temperature_hdd_warning=52 #temperature_hdd_critical=60 # Battery threshold in % # Default values if not defined: 70/80/90 #battery_careful=70 #battery_warning=80 #battery_critical=90 # Fan speed threshold in RPM #fan_speed_careful=100 # Sensors alias #alias=core 0:CPU Core 0,core 1:CPU Core 1 [processcount] disable=False # If you want to change the refresh rate of the processing list, please uncomment: #refresh=10 [processlist] disable=False # Sort key: if not defined, the sort is automatically done by Glances (recommended) # Should be one of the following: # cpu_percent, memory_percent, io_counters, name, cpu_times, username #sort_key=memory_percent # List of stats to disable (not grabed and not display) # Stats that can be disabled: cpu_percent,memory_info,memory_percent,username,cpu_times,num_threads,nice,status,io_counters,cmdline,cpu_num # Stats that can not be disable: pid,name disable_stats=cpu_num # Disable display of virtual memory #disable_virtual_memory=True # Define CPU/MEM (per process) thresholds in % # Default values if not defined: 50/70/90 cpu_careful=50 cpu_warning=70 cpu_critical=90 mem_careful=50 mem_warning=70 mem_critical=90 # # Nice priorities range from -20 to 19. # Configure nice levels using a comma-separated list. # # Nice: Example 1, non-zero is warning (default behavior) nice_warning=-20,-19,-18,-17,-16,-15,-14,-13,-12,-11,-10,-9,-8,-7,-6,-5,-4,-3,-2,-1,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19 # # Nice: Example 2, low priority processes escalate from careful to critical #nice_ok=O #nice_careful=1,2,3,4,5,6,7,8,9 #nice_warning=10,11,12,13,14 #nice_critical=15,16,17,18,19 # # Status: define threshold regarding the process status (first letter of process status) # R: Running, S: Sleeping, Z: Zombie (complete list here https://psutil.readthedocs.io/en/latest/#process-status-constants) status_ok=R,W,P,I status_critical=Z,D # Define the list of processes to export using: # a comma-separated list of Glances filter #export=.*firefox.*,pid:1234 # Define a list of process to focus on (comma-separated list of Glances filter) #focus=.*firefox.*,.*python.* [ports] disable=False # Interval in second between two scans # Ports scanner plugin configuration refresh=30 # Set the default timeout (in second) for a scan (can be overwritten in the scan list) timeout=3 # If port_default_gateway is True, add the default gateway on top of the scan list port_default_gateway=True # # Define the scan list (1 < x < 255) # port_x_host (name or IP) is mandatory # port_x_port (TCP port number) is optional (if not set, use ICMP) # port_x_description is optional (if not set, define to host:port) # port_x_timeout is optional and overwrite the default timeout value # port_x_rtt_warning is optional and defines the warning threshold in ms # #port_1_host=192.168.0.1 #port_1_port=80 #port_1_description=Home Box #port_1_timeout=1 #port_2_host=www.free.fr #port_2_description=My ISP #port_3_host=www.google.com #port_3_description=Internet ICMP #port_3_rtt_warning=1000 #port_4_description=Internet Web #port_4_host=www.google.com #port_4_port=80 #port_4_rtt_warning=1000 # # Define Web (URL) monitoring list (1 < x < 255) # web_x_url is the URL to monitor (example: http://my.site.com/folder) # web_x_description is optional (if not set, define to URL) # web_x_timeout is optional and overwrite the default timeout value # web_x_rtt_warning is optional and defines the warning respond time in ms (approximately) # #web_1_url=https://blog.nicolargo.com #web_1_description=My Blog #web_1_rtt_warning=3000 #web_2_url=https://github.com #web_3_url=http://www.google.fr #web_3_description=Google Fr #web_4_url=https://blog.nicolargo.com/nonexist #web_4_description=Intranet [vms] disable=True # Define the maximum VMs size name (default is 20 chars) max_name_size=20 # By default, Glances only display running VMs with states: # 'Running', 'Paused', 'Starting' or 'Restarting' # Set the following key to True to display all VMs regarding their states all=False [containers] disable=False # Only show specific containers (comma-separated list of container name or regular expression) # Comment this line to display all containers (default configuration) ; show=telegraf # Hide some containers (comma-separated list of container name or regular expression) # Comment this line to display all containers (default configuration) ; hide=telegraf # Define the maximum docker size name (default is 20 chars) max_name_size=20 # List of stats to disable (not display) # Following stats can be disabled: name,status,uptime,cpu,mem,diskio,networkio,ports,command disable_stats=command # Thresholds for CPU and MEM (in %) ; cpu_careful=50 ; cpu_warning=70 ; cpu_critical=90 ; mem_careful=20 ; mem_warning=50 ; mem_critical=70 # # Per container thresholds ; containername_cpu_careful=10 ; containername_cpu_warning=20 ; containername_cpu_critical=30 # # By default, Glances only display running containers # Set the following key to True to display all containers all=False # Define Podman sock ; podman_sock=unix:///run/user/1000/podman/podman.sock [amps] # AMPs configuration are defined in the bottom of this file disable=False [alert] disable=False # Maximum number of events to display (default is 10 events) ;max_events=10 # Minimum duration for an event to be taken into account (default is 6 seconds) ;min_duration=6 # Minimum time between two events of the same type (default is 6 seconds) # This is used to avoid too many alerts for the same event # Events will be merged ;min_interval=6 ############################################################################## # Browser mode - Static servers definition ############################################################################## [serverlist] # Define columns (comma separated list of ::()) to grab/display # Default is: system:hr_name,load:min5,cpu:total,mem:percent # You can also add stats with key, like sensors:value:Ambient (key is case sensitive) #columns=system:hr_name,load:min5,cpu:total,mem:percent,memswap:percent,sensors:value:Ambient,sensors:value:Composite # Define the static servers list # _protocol can be: rpc (default if not defined) or rest # List is limited to 256 servers max (1 to 256) #server_1_name=localhost #server_1_alias=Local WebUI #server_1_port=61266 #server_1_protocol=rest #server_2_name=localhost #server_2_alias=My local PC #server_2_port=61209 #server_2_protocol=rpc #server_3_name=192.168.0.17 #server_3_alias=Another PC on my network #server_3_port=61209 #server_3_protocol=rpc #server_4_name=notagooddefinition #server_4_port=61237 [passwords] # Define the passwords list related to the [serverlist] section # Syntax: host=password # Where: host is the hostname # password is the clear password # Additionally (and optionally) a default password could be defined #localhost=abc #default=defaultpassword # # Define the path of the local '.pwd' file (default is system one) #local_password_path=~/.config/glances ############################################################################## # Exports ############################################################################## [export] # Common section for all exporters # Do not export following fields (comma separated list of regex) #exclude_fields=.*_critical,.*_careful,.*_warning,.*\.key$ [graph] # Configuration for the --export graph option # Set the path where the graph (.svg files) will be created # Can be overwrite by the --graph-path command line option path=/tmp/glances # It is possible to generate the graphs automatically by setting the # generate_every to a non zero value corresponding to the seconds between # two generation. Set it to 0 to disable graph auto generation. generate_every=0 # See following configuration keys definitions in the Pygal lib documentation # http://pygal.org/en/stable/documentation/index.html width=800 height=600 style=DarkStyle [influxdb] # !!! # Will be DEPRECATED in future release. # Please have a look on the new influxdb3 export module # !!! # Configuration for the --export influxdb option # https://influxdb.com/ host=localhost port=8086 protocol=http user=root password=root db=glances # Prefix will be added for all measurement name # Ex: prefix=foo # => foo.cpu # => foo.mem # You can also use dynamic values #prefix=foo # Following tags will be added for all measurements # You can also use dynamic values. # Note: hostname and name (for process) are always added as a tag #tags=foo:bar,spam:eggs,domain:`domainname` [influxdb2] # Configuration for the --export influxdb2 option # https://influxdb.com/ host=localhost port=8086 protocol=http org=nicolargo bucket=glances token=PUT_YOUR_INFLUXDB2_TOKEN_HERE # Set the interval between two exports (in seconds) # If the interval is set to 0, the Glances refresh time is used (default behavor) #interval=0 # Prefix will be added for all measurement name # Ex: prefix=foo # => foo.cpu # => foo.mem # You can also use dynamic values #prefix=foo # Following tags will be added for all measurements # You can also use dynamic values. # Note: hostname and name (for process) are always added as a tag #tags=foo:bar,spam:eggs,domain:`domainname` [influxdb3] # Configuration for the --export influxdb3 option # https://influxdb.com/ host=http://localhost:8181 org=nicolargo database=glances token=PUT_YOUR_INFLUXDB3_TOKEN_HERE # Set the interval between two exports (in seconds) # If the interval is set to 0, the Glances refresh time is used (default behavor) #interval=0 # Prefix will be added for all measurement name # Ex: prefix=foo # => foo.cpu # => foo.mem # You can also use dynamic values #prefix=foo # Following tags will be added for all measurements # You can also use dynamic values. # Note: hostname and name (for process) are always added as a tag #tags=foo:bar,spam:eggs,domain:`domainname` [cassandra] # Configuration for the --export cassandra option # Also works for the ScyllaDB # https://influxdb.com/ or http://www.scylladb.com/ host=localhost port=9042 protocol_version=3 keyspace=glances replication_factor=2 # If not define, table name is set to host key table=localhost # If not define, username and password will not be used #username=cassandra #password=password [opentsdb] # Configuration for the --export opentsdb option # http://opentsdb.net/ host=localhost port=4242 #prefix=glances #tags=foo:bar,spam:eggs [statsd] # Configuration for the --export statsd option # https://github.com/etsy/statsd host=localhost port=8125 #prefix=glances [elasticsearch] # Configuration for the --export elasticsearch option # Data are available via the ES RESTful API. ex: URL//cpu # https://www.elastic.co scheme=http host=localhost port=9200 index=glances [riemann] # Configuration for the --export riemann option # http://riemann.io host=localhost port=5555 [rabbitmq] # Configuration for the --export rabbitmq option host=localhost port=5672 user=guest password=guest queue=glances_queue #protocol=amqps [mqtt] # Configuration for the --export mqtt option host=localhost # Overwrite device name in the topic #devicename=localhost port=8883 tls=false user=guest password=guest topic=glances topic_structure=per-metric callback_api_version=2 [couchdb] # Configuration for the --export couchdb option # https://www.couchdb.org host=localhost port=5984 db=glances user=admin password=admin [mongodb] # Configuration for the --export mongodb option # https://www.mongodb.com host=localhost port=27017 db=glances user=root password=example [kafka] # Configuration for the --export kafka option # http://kafka.apache.org/ host=localhost port=9092 topic=glances #compression=gzip # Tags will be added for all events #tags=foo:bar,spam:eggs # You can also use dynamic values #tags=hostname:`hostname -f` [zeromq] # Configuration for the --export zeromq option # http://www.zeromq.org # Use * to bind on all interfaces host=* port=5678 # Glances envelopes the stats in a publish message with two frames: # - First frame containing the following prefix (STRING) # - Second frame with the Glances plugin name (STRING) # - Third frame with the Glances plugin stats (JSON) prefix=G [prometheus] # Configuration for the --export prometheus option # https://prometheus.io # Create a Prometheus exporter listening on localhost:9091 (default configuration) # Metric are exporter using the following name: # __{labelkey:labelvalue} # Note: You should add this exporter to your Prometheus server configuration: # scrape_configs: # - job_name: 'glances_exporter' # scrape_interval: 5s # static_configs: # - targets: ['localhost:9091'] # # Labels will be added for all measurements (default is src:glances) # labels=foo:bar,spam:eggs # You can also use dynamic values # labels=system:`uname -s` # host=localhost port=9091 #prefix=glances labels=src:glances [restful] # Configuration for the --export restful option # Example, export to http://localhost:6789/ host=localhost port=6789 protocol=http path=/ [graphite] # Configuration for the --export graphite option # https://graphiteapp.org/ host=localhost port=2003 # Prefix will be added for all measurement name prefix=glances # System name added between the prefix and the stats # By default, system_name = FQDN #system_name=mycomputer [timescaledb] # Configuration for the --export timescaledb option # https://www.timescale.com/ host=localhost port=5432 db=glances user=postgres password=password # Overwrite device name (default is the FQDN) # Most of the time, you should not overwrite this value #hostname=mycomputer [nats] # Configuration for the --export nats option # https://nats.io/ # Host is a separated list of NATS nodes host=nats://localhost:4222 # Prefix for the subjects (default is 'glances') prefix=glances [duckdb] # database defines where data are stored, can be one of: # :memory: (see https://duckdb.org/docs/stable/clients/python/dbapi#in-memory-connection) # :memory:glances (see https://duckdb.org/docs/stable/clients/python/dbapi#in-memory-connection) # /path/to/glances.db (see https://duckdb.org/docs/stable/clients/python/dbapi#file-based-connection) # Or anyone else supported by the API (see https://duckdb.org/docs/stable/clients/python/dbapi) database=:memory: ############################################################################## # AMPS # * enable: Enable (true) or disable (false) the AMP # * regex: Regular expression to filter the process(es) # * refresh: The AMP is executed every refresh seconds # * one_line: (optional) Force (if true) the AMP to be displayed in one line # * command: (optional) command to execute when the process is detected (thk to the regex) # * countmin: (optional) minimal number of processes # A warning will be displayed if number of process < count # * countmax: (optional) maximum number of processes # A warning will be displayed if number of process > count # * : Others variables can be defined and used in the AMP script ############################################################################## [amp_dropbox] # Use the default AMP (no dedicated AMP Python script) # Check if the Dropbox daemon is running # Every 3 seconds, display the 'dropbox status' command line enable=false regex=.*dropbox.* refresh=3 one_line=false command=dropbox status countmin=1 [amp_python] # Use the default AMP (no dedicated AMP Python script) # Monitor all the Python scripts # Alert if more than 20 Python scripts are running enable=false regex=.*python.* refresh=3 countmax=20 [amp_conntrack] # Use && separator for multiple commands # If the regex key is not defined, the AMP will be executed every refresh second # and the process count will not be displayed (countmin and countmax will be ignore) enable=false refresh=30 one_line=false command=sysctl net.netfilter.nf_conntrack_count && sysctl net.netfilter.nf_conntrack_max [amp_nginx] # Use the NGinx AMP # Nginx status page should be enable (https://easyengine.io/tutorials/nginx/status-page/) enable=false regex=\/usr\/sbin\/nginx refresh=60 one_line=false status_url=http://localhost/nginx_status [amp_systemd] # Use the Systemd AMP enable=false regex=\/lib\/systemd\/systemd refresh=30 one_line=true systemctl_cmd=/bin/systemctl --plain [amp_systemv] # Use the Systemv AMP enable=false regex=\/sbin\/init refresh=30 one_line=true service_cmd=/usr/bin/service --status-all ================================================ FILE: dev-requirements.txt ================================================ # This file was autogenerated by uv via the following command: # uv export --no-hashes --only-dev --output-file dev-requirements.txt alabaster==1.0.0 # via sphinx annotated-doc==0.0.4 # via typer annotated-types==0.7.0 # via pydantic anyio==4.12.1 # via # httpx # mcp # sse-starlette # starlette attrs==25.4.0 # via # glom # jsonschema # outcome # referencing # reuse # semgrep # trio babel==2.18.0 # via sphinx boltons==21.0.0 # via # face # glom # semgrep boolean-py==5.0 # via license-expression bracex==2.6 # via wcmatch certifi==2026.2.25 # via # httpcore # httpx # requests # selenium cffi==2.0.0 ; (implementation_name != 'pypy' and os_name == 'nt') or platform_python_implementation != 'PyPy' # via # cryptography # trio cfgv==3.5.0 # via pre-commit charset-normalizer==3.4.5 # via # python-debian # requests click==8.1.8 # via # click-option-group # reuse # semgrep # typer # uvicorn click-option-group==0.5.9 # via semgrep codespell==2.4.2 colorama==0.4.6 # via # click # pytest # semgrep # sphinx contourpy==1.3.2 ; python_full_version < '3.11' # via matplotlib contourpy==1.3.3 ; python_full_version >= '3.11' # via matplotlib cryptography==46.0.5 # via pyjwt cycler==0.12.1 # via matplotlib distlib==0.4.0 # via virtualenv docutils==0.21.2 ; python_full_version < '3.11' # via # rstcheck-core # sphinx # sphinx-rtd-theme docutils==0.22.4 ; python_full_version >= '3.11' # via # rstcheck-core # sphinx # sphinx-rtd-theme exceptiongroup==1.2.2 # via # anyio # pytest # semgrep # trio # trio-websocket face==26.0.0 # via glom filelock==3.25.2 # via # python-discovery # virtualenv fonttools==4.62.1 # via matplotlib glom==25.12.0 # via semgrep googleapis-common-protos==1.73.0 # via opentelemetry-exporter-otlp-proto-http gprof2dot==2025.4.14 h11==0.16.0 # via # httpcore # uvicorn # wsproto httpcore==1.0.9 # via httpx httpx==0.28.1 # via mcp httpx-sse==0.4.3 # via mcp identify==2.6.17 # via pre-commit idna==3.11 # via # anyio # httpx # requests # trio imagesize==2.0.0 # via sphinx importlib-metadata==8.7.1 # via opentelemetry-api iniconfig==2.3.0 # via pytest jinja2==3.1.6 # via # reuse # sphinx jsonschema==4.25.1 # via # mcp # semgrep jsonschema-specifications==2025.9.1 # via jsonschema kiwisolver==1.5.0 # via matplotlib license-expression==30.4.4 # via reuse markdown-it-py==4.0.0 # via rich markupsafe==3.0.3 # via jinja2 matplotlib==3.10.8 mcp==1.23.3 # via semgrep mdurl==0.1.2 # via markdown-it-py memory-profiler==0.61.0 nodeenv==1.10.0 # via # pre-commit # pyright numpy==2.2.6 ; python_full_version < '3.11' # via # contourpy # matplotlib numpy==2.4.3 ; python_full_version >= '3.11' # via # contourpy # matplotlib opentelemetry-api==1.37.0 # via # opentelemetry-exporter-otlp-proto-http # opentelemetry-instrumentation # opentelemetry-instrumentation-requests # opentelemetry-instrumentation-threading # opentelemetry-sdk # opentelemetry-semantic-conventions # semgrep opentelemetry-exporter-otlp-proto-common==1.37.0 # via opentelemetry-exporter-otlp-proto-http opentelemetry-exporter-otlp-proto-http==1.37.0 # via semgrep opentelemetry-instrumentation==0.58b0 # via # opentelemetry-instrumentation-requests # opentelemetry-instrumentation-threading opentelemetry-instrumentation-requests==0.58b0 # via semgrep opentelemetry-instrumentation-threading==0.58b0 # via semgrep opentelemetry-proto==1.37.0 # via # opentelemetry-exporter-otlp-proto-common # opentelemetry-exporter-otlp-proto-http opentelemetry-sdk==1.37.0 # via # opentelemetry-exporter-otlp-proto-http # semgrep opentelemetry-semantic-conventions==0.58b0 # via # opentelemetry-instrumentation # opentelemetry-instrumentation-requests # opentelemetry-sdk opentelemetry-util-http==0.58b0 # via opentelemetry-instrumentation-requests outcome==1.3.0.post0 # via # trio # trio-websocket packaging==26.0 # via # matplotlib # opentelemetry-instrumentation # pytest # requirements-parser # semgrep # sphinx # webdriver-manager peewee==3.19.0 # via semgrep pillow==12.1.1 # via matplotlib platformdirs==4.9.4 # via # python-discovery # virtualenv pluggy==1.6.0 # via pytest pre-commit==4.5.1 protobuf==6.33.5 # via # googleapis-common-protos # opentelemetry-proto psutil==7.2.2 # via memory-profiler py-spy==0.4.1 pycparser==3.0 ; (implementation_name != 'PyPy' and implementation_name != 'pypy' and os_name == 'nt') or (implementation_name != 'PyPy' and platform_python_implementation != 'PyPy') # via cffi pydantic==2.12.5 # via # mcp # pydantic-settings # rstcheck-core pydantic-core==2.41.5 # via pydantic pydantic-settings==2.13.1 # via mcp pygments==2.19.2 # via # pytest # rich # sphinx pyinstrument==5.1.2 pyjwt==2.12.1 # via # mcp # semgrep pyparsing==3.3.2 # via matplotlib pyright==1.1.408 pysocks==1.7.1 # via urllib3 pytest==9.0.2 python-dateutil==2.9.0.post0 # via matplotlib python-debian==1.1.0 # via reuse python-discovery==1.1.3 # via virtualenv python-dotenv==1.2.2 # via # pydantic-settings # webdriver-manager python-magic==0.4.27 # via reuse python-multipart==0.0.22 # via mcp pywin32==311 ; sys_platform == 'win32' # via # mcp # semgrep pyyaml==6.0.3 # via pre-commit referencing==0.37.0 # via # jsonschema # jsonschema-specifications requests==2.32.5 # via # opentelemetry-exporter-otlp-proto-http # semgrep # sphinx # webdriver-manager requirements-parser==0.13.0 reuse==6.2.0 rich==14.3.3 # via # semgrep # typer roman-numerals==4.1.0 ; python_full_version >= '3.11' # via sphinx rpds-py==0.30.0 # via # jsonschema # referencing rstcheck==6.2.5 rstcheck-core==1.2.2 # via rstcheck ruamel-yaml==0.19.1 # via semgrep ruamel-yaml-clib==0.2.14 # via semgrep ruff==0.15.6 selenium==4.41.0 semantic-version==2.10.0 # via semgrep semgrep==1.155.0 setuptools==82.0.1 shellingham==1.5.4 # via typer six==1.17.0 # via python-dateutil sniffio==1.3.1 # via trio snowballstemmer==3.0.1 # via sphinx sortedcontainers==2.4.0 # via trio sphinx==8.1.3 ; python_full_version < '3.11' # via # sphinx-rtd-theme # sphinxcontrib-jquery sphinx==9.0.4 ; python_full_version == '3.11.*' # via # sphinx-rtd-theme # sphinxcontrib-jquery sphinx==9.1.0 ; python_full_version >= '3.12' # via # sphinx-rtd-theme # sphinxcontrib-jquery sphinx-rtd-theme==3.1.0 sphinxcontrib-applehelp==2.0.0 # via sphinx sphinxcontrib-devhelp==2.0.0 # via sphinx sphinxcontrib-htmlhelp==2.1.0 # via sphinx sphinxcontrib-jquery==4.1 # via sphinx-rtd-theme sphinxcontrib-jsmath==1.0.1 # via sphinx sphinxcontrib-qthelp==2.0.0 # via sphinx sphinxcontrib-serializinghtml==2.0.0 # via sphinx sse-starlette==3.3.2 # via mcp starlette==0.52.1 # via # mcp # sse-starlette tomli==2.0.2 # via # pytest # semgrep # sphinx tomlkit==0.14.0 # via reuse trio==0.33.0 # via # selenium # trio-websocket trio-websocket==0.12.2 # via selenium typer==0.23.1 # via rstcheck typing-extensions==4.15.0 # via # anyio # cryptography # mcp # opentelemetry-api # opentelemetry-exporter-otlp-proto-http # opentelemetry-sdk # opentelemetry-semantic-conventions # pydantic # pydantic-core # pyjwt # pyright # referencing # selenium # semgrep # starlette # typing-inspection # uvicorn # virtualenv typing-inspection==0.4.2 # via # mcp # pydantic # pydantic-settings urllib3==2.6.3 # via # requests # selenium # semgrep uvicorn==0.41.0 ; sys_platform != 'emscripten' # via mcp virtualenv==21.2.0 # via pre-commit wcmatch==8.5.2 # via semgrep webdriver-manager==4.0.2 websocket-client==1.9.0 # via selenium wrapt==1.17.3 # via # opentelemetry-instrumentation # opentelemetry-instrumentation-threading wsproto==1.3.2 # via trio-websocket zipp==3.23.0 # via importlib-metadata ================================================ FILE: docker-bin.sh ================================================ #!/bin/sh /venv/bin/python3 -m glances "$@" ================================================ FILE: docker-compose/docker-compose.yml ================================================ services: glances: # See all images tags here: https://hub.docker.com/r/nicolargo/glances/tags image: nicolargo/glances:latest-full restart: always healthcheck: test: ["CMD", "curl", "-f", "http://localhost:61208/api/4/status"] interval: 30s timeout: 10s retries: 3 start_period: 40s pid: "host" network_mode: "host" read_only: true privileged: false # Uncomment next line for SATA or NVME smartctl monitoring # cap_add: # Uncomment next line for SATA smartctl monitoring # - SYS_RAWIO # Uncomment next line for NVME smartctl monitoring # - SYS_ADMIN # devices: # - "/dev/nvme0" volumes: - "/:/rootfs:ro" - "/var/run/docker.sock:/var/run/docker.sock:ro" # Uncomment for qemu/libvirt/kvm support with modular libvirt daemons # - "/var/run/libvirt/virtqemud-sock:/var/run/libvirt/libvirt-sock:ro" # OR monolithic libvirt daemon # - "/var/run/libvirt/libvirt-sock:/var/run/libvirt/libvirt-sock:ro" - "/run/user/1000/podman/podman.sock:/run/user/1000/podman/podman.sock:ro" - "./glances.conf:/glances/conf/glances.conf" # Uncomment for proper distro information in upper panel. # # Works only for distros that do have this file (most of distros do). # - "/etc/os-release:/etc/os-release:ro" tmpfs: - /tmp environment: - GLANCES_OPT=-C /glances/conf/glances.conf -w --enable-mcp --enable-plugin smart # Please set to your local timezone (or use local ${TZ} environment variable if set on your host) - TZ=Europe/Paris - PYTHONPYCACHEPREFIX=/tmp/py_caches # # Uncomment for GPU compatibility (Nvidia) inside the container # deploy: # resources: # reservations: # devices: # - driver: nvidia # count: 1 # capabilities: [gpu] # Uncomment to protect Glances WebUI by a login/password (add --password to GLANCES_OPT) # secrets: # - source: glances_password # target: /root/.config/glances/.pwd # secrets: # glances_password: # file: ./secrets/glances_password ================================================ FILE: docker-compose/glances.conf ================================================ ############################################################################## # Globals Glances parameters ############################################################################## [global] # Stats refresh rate (default is a minimum of 2 seconds) # Can be overwrite by the -t option # It is also possible to overwrite it in each plugin sections refresh=2 # Does Glances should check if a newer version is available on PyPI ? check_update=False # 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 ############################################################################## # User interface ############################################################################## [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 # # Specifics options for TUI #-------------------------- # Disable background color #disable_bg=True # # Specifics 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 False. # Set to True only when cors_origins is explicitly configured with specific origins. #cors_credentials=False # 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_password=kfp #ssl_keyfile=./glances.local+3-key.pem #ssl_certfile=./glances.local+3.pem # # JWT Authentication settings # Secret key for signing JWT tokens (generate with: openssl rand -hex 32) # If not set, a random key is generated per server instance (tokens won't survive restart) #jwt_secret_key=your-secure-secret-key-here # Token expiration time in minutes (default: 60) #jwt_expire_minutes=60 # # DNS rebinding protection for the REST API / WebUI # Restrict the HTTP Host header accepted by the web server. # Comma-separated list of hostnames or IPs. Wildcards are supported (e.g. *.example.com). # When this key is absent or commented out, no host filtering is applied (default behaviour). # Recommended for any internet-facing or multi-tenant deployment. #webui_allowed_hosts=localhost,127.0.0.1,myserver.example.com # # MCP # Overwrite the default MCP path #mcp_path=/mcp # Allowed Host headers for the MCP SSE endpoint (DNS rebinding protection). # Comma-separated list. Defaults to localhost,127.0.0.1 when not set. # Set to * to allow any host - use only behind a trusted reverse proxy. #mcp_allowed_hosts=localhost,127.0.0.1,myserver.example.com ############################################################################## # Plugins ############################################################################## [quicklook] # Set to true to disable a plugin # Note: you can also disable it from the command line (see --disable-plugin ) disable=False # Stats list (default is cpu,mem,load) # Available stats are: cpu,mem,load,swap list=cpu,mem,load # Graphical bar char used in the terminal user interface (default is |) bar_char=▪ # Define CPU, MEM and SWAP thresholds in % cpu_careful=50 cpu_warning=70 cpu_critical=90 mem_careful=50 mem_warning=70 mem_critical=90 swap_careful=50 swap_warning=70 swap_critical=90 # Source: http://blog.scoutapp.com/articles/2009/07/31/understanding-load-averages # With 1 CPU core, the load should be lower than 1.00 ~ 100% load_careful=70 load_warning=100 load_critical=500 [system] # This plugin display the first line in the Glances UI with: # Hostname / Operating system name / Architecture information # Set to true to disable a plugin disable=False # Default refresh rate is 60 seconds #refresh=60 # System information to display (a string where {key} will be replaced by the value) # Available information are: hostname, os_name, os_version, os_arch, linux_distro, platform #system_info_msg= | My {os_name} system | [cpu] disable=False # See https://scoutapm.com/blog/slow_server_flow_chart # # I/O wait percentage should be lower than 1/# (# = Logical CPU cores) # Leave commented to just use the default config: # Careful=1/#*100-20% / Warning=1/#*100-10% / Critical=1/#*100 #iowait_careful=30 #iowait_warning=40 #iowait_critical=50 # # Total % is 100 - idle total_careful=65 total_warning=75 total_critical=85 total_log=True # # Default values if not defined: 50/70/90 (except for iowait) user_careful=50 user_warning=70 user_critical=90 user_log=False #user_critical_action=echo "{{time}} User CPU {{user}} higher than {{critical}}" > /tmp/cpu.alert # system_careful=50 system_warning=70 system_critical=90 system_log=False # steal_careful=50 steal_warning=70 steal_critical=90 #steal_log=True # # Context switch limit (core / second) # Leave commented to just use the default config critical is 50000*(Logical CPU cores) #ctx_switches_careful=10000 #ctx_switches_warning=12000 #ctx_switches_critical=14000 [percpu] disable=False # Define the maximum number of CPU displayed at a time # If the number of CPU is higher than the one configured in max_cpu_display then: # - display top 'max_cpu_display' (sorted by CPU consumption) # - a last line will be added with the mean of all other CPUs max_cpu_display=4 # Define CPU thresholds in % # Default values if not defined: 50/70/90 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 [gpu] disable=False # Default GPU load thresholds in % proc_careful=50 proc_warning=70 proc_critical=90 # Default GPU memory thresholds in % mem_careful=50 mem_warning=70 mem_critical=90 # Default GPU temperature thresholds in degrees Celsus temperature_careful=60 temperature_warning=70 temperature_critical=80 [npu] disable=True # Default NPU load thresholds in % load_careful=50 load_warning=70 load_critical=90 # Default NPU frequency thresholds in % freq_careful=50 freq_warning=70 freq_critical=90 [mem] disable=False # Display available memory instead of used memory #available=True # Define RAM thresholds in % # Default values if not defined: 50/70/90 careful=50 warning=70 critical=90 #critical_action_repeat=echo "{{time}} {{percent}} higher than {{critical}}"" >> /tmp/memory.alert [memswap] disable=False # Define SWAP thresholds in % # Default values if not defined: 50/70/90 careful=50 warning=70 critical=90 #warning_action=echo "{{time}} {{percent}} higher than {{warning}}"" > /tmp/memory.alert [load] disable=False # Define LOAD thresholds # Value * number of cores # Default values if not defined: 0.7/1.0/5.0 per number of cores # Source: http://blog.scoutapp.com/articles/2009/07/31/understanding-load-averages # http://www.linuxjournal.com/article/9001 careful=0.7 warning=1.0 critical=5.0 #log=False [network] disable=False # Default bitrate thresholds in % of the network interface speed # Default values if not defined: 70/80/90 rx_careful=70 rx_warning=80 rx_critical=90 tx_careful=70 tx_warning=80 tx_critical=90 # Define the list of hidden network interfaces (comma-separated regexp) #hide=docker.*,lo # Define the list of wireless network interfaces to be show (comma-separated) #show=docker.* # Automatically hide interface not up (default is False) hide_no_up=True # Automatically hide interface with no IP address (default is False) hide_no_ip=True # Set hide_zero to True to automatically hide interface with no traffic hide_zero=False # Set hide_threshold_bytes to an integer value to automatically hide # interface with traffic less or equal than this value #hide_threshold_bytes=0 # It is possible to overwrite the bitrate thresholds per interface # WLAN 0 Default limits (in bits per second aka bps) for interface bitrate #wlan0_rx_careful=4000000 #wlan0_rx_warning=5000000 #wlan0_rx_critical=6000000 #wlan0_rx_log=True #wlan0_tx_careful=700000 #wlan0_tx_warning=900000 #wlan0_tx_critical=1000000 #wlan0_tx_log=True #wlan0_rx_critical_action=echo "{{time}} {{interface_name}} RX {{bytes_recv_rate_per_sec}}Bps" > /tmp/network.alert # Alias for network interface name #alias=wlp0s20f3:WIFI [ip] # Disable display of private IP address disable=False # Configure the online service where public IP address information will be downloaded # - public_disabled: Disable public IP address information (set to True for offline platform) # - public_refresh_interval: Refresh interval between to calls to the online service # - public_api: URL of the API (the API should return an JSON object) # - public_username: Login for the online service (if needed) # - public_password: Password for the online service (if needed) # - public_field: Field name of the public IP address in onlibe service JSON message # - public_template: Template to build the public message # # Example for IPLeak service: # public_api=https://ipv4.ipleak.net/json/ # public_field=ip # public_template={ip} {continent_name}/{country_name}/{city_name} # public_disabled=True public_refresh_interval=300 public_api=https://ipv4.ipleak.net/json/ #public_username= #public_password= public_field=ip public_template={continent_name}/{country_name}/{city_name} [connections] # Display additional information about TCP connections # This plugin is disabled by default because it consumes lots of CPU disable=True # nf_conntrack thresholds in % nf_conntrack_percent_careful=70 nf_conntrack_percent_warning=80 nf_conntrack_percent_critical=90 [wifi] disable=False # Define SIGNAL thresholds in dBm (lower is better...) # Based on: http://serverfault.com/questions/501025/industry-standard-for-minimum-wifi-signal-strength careful=-65 warning=-75 critical=-85 [diskio] disable=False # Define the list of hidden disks (comma-separated regexp) #hide=sda2,sda5,loop.* hide=loop.*,/dev/loop.* # Set hide_zero to True to automatically hide disk with no read/write hide_zero=False # Set hide_threshold_bytes to an integer value to automatically hide # interface with traffic less or equal than this value #hide_threshold_bytes=0 # Define the list of disks to be show (comma-separated) #show=sda.* # Alias for sda1 and sdb1 #alias=sda1:SystemDisk,sdb1:DataDisk # Default latency thresholds (in ms) (rx = read / tx = write) rx_latency_careful=10 rx_latency_warning=20 rx_latency_critical=50 tx_latency_careful=10 tx_latency_warning=20 tx_latency_critical=50 # Set latency thresholds (latency in ms) for a given disk name (rx = read / tx = write) # dm-0_rx_latency_careful=10 # dm-0_rx_latency_warning=20 # dm-0_rx_latency_critical=50 # dm-0_rx_latency_log=False # dm-0_tx_latency_careful=10 # dm-0_tx_latency_warning=20 # dm-0_tx_latency_critical=50 # dm-0_tx_latency_log=False # There is no default bitrate thresholds for disk (because it is not possible to know the disk speed) # Set bitrate thresholds (in bytes per second) for a given disk name (rx = read / tx = write) #dm-0_rx_careful=4000000000 #dm-0_rx_warning=5000000000 #dm-0_rx_critical=6000000000 #dm-0_rx_log=False #dm-0_tx_careful=700000000 #dm-0_tx_warning=900000000 #dm-0_tx_critical=1000000000 #dm-0_tx_log=False [fs] disable=False # Define the list of file system to hide (comma-separated regexp) hide=/boot.*,.*/snap.* # Define the list of file system to show (comma-separated regexp) #show=/,/srv # Define filesystem space thresholds in % # Default values if not defined: 50/70/90 careful=50 warning=70 critical=90 # It is also possible to define per mount point value # Example: /_careful=40 #/_careful=1 #/_warning=5 #/_critical=10 #/_critical_action=echo "{{time}} {{mnt_point}} filesystem space {{percent}}% higher than {{critical}}%" > /tmp/fs.alert # Allow additional file system types (comma-separated FS type) #allow=shm # Alias for root file system #alias=/:Root,/zfspool:ZFS [irq] # Documentation: https://glances.readthedocs.io/en/latest/aoa/irq.html # This plugin is disabled by default disable=True [folders] # Documentation: https://glances.readthedocs.io/en/latest/aoa/folders.html disable=False # Define a folder list to monitor # The list is composed of items (list_#nb <= 10) # An item is defined by: # * path: absolute path # * careful: optional careful threshold (in MB) # * warning: optional warning threshold (in MB) # * critical: optional critical threshold (in MB) # * refresh: interval in second between two refreshes #folder_1_path=/tmp #folder_1_careful=2500 #folder_1_warning=3000 #folder_1_critical=3500 #folder_1_refresh=60 #folder_2_path=/home/nicolargo/Videos #folder_2_warning=17000 #folder_2_critical=20000 #folder_3_path=/nonexisting #folder_4_path=/root [cloud] # Documentation: https://glances.readthedocs.io/en/latest/aoa/cloud.html # This plugin is disabled by default disable=True [raid] # Documentation: https://glances.readthedocs.io/en/latest/aoa/raid.html # This plugin is disabled by default disable=True [smart] # Documentation: https://glances.readthedocs.io/en/latest/aoa/smart.html # This plugin is disabled by default disable=True # Define the list of sensors to hide (comma-separated regexp) #hide=.*Hide_this_driver.* # Define the list of sensors to show (comma-separated regexp) #show=.*Drive_Temperature.* # List of attributes to hide (comma separated) #hide_attributes=Self-tests,Errors [hddtemp] disable=False # Define hddtemp server IP and port (default is 127.0.0.1 and 7634 (TCP)) host=127.0.0.1 port=7634 [sensors] # Documentation: https://glances.readthedocs.io/en/latest/aoa/sensors.html disable=False # Set the refresh multiplicator for the sensors # By default refresh every Glances refresh * 5 (increase to reduce CPU consumption) #refresh=5 # Hide some sensors (comma separated list of regexp) hide=unknown.* # Show only the following sensors (comma separated list of regexp) #show=CPU.* # Sensors core thresholds (in Celsius...) # By default values are grabbed from the system # Overwrite thresholds for a specific sensor # temperature_core_Ambient_careful=40 # temperature_core_Ambient_warning=60 # temperature_core_Ambient_critical=85 # temperature_core_Ambient_log=True # temperature_core_Ambient_critical_action=echo "{{time}} {{label}} temperature {{value}}{{unit}} higher than {{critical}}{{unit}}" > /tmp/temperature.alert # Overwrite thresholds for a specific type of sensor #temperature_core_careful=45 #temperature_core_warning=65 #temperature_core_critical=80 # Temperatures threshold in °C for hddtemp # Default values if not defined: 45/52/60 #temperature_hdd_careful=45 #temperature_hdd_warning=52 #temperature_hdd_critical=60 # Battery threshold in % # Default values if not defined: 70/80/90 #battery_careful=70 #battery_warning=80 #battery_critical=90 # Fan speed threshold in RPM #fan_speed_careful=100 # Sensors alias #alias=core 0:CPU Core 0,core 1:CPU Core 1 [processcount] disable=False # If you want to change the refresh rate of the processing list, please uncomment: #refresh=10 [processlist] disable=False # Sort key: if not defined, the sort is automatically done by Glances (recommended) # Should be one of the following: # cpu_percent, memory_percent, io_counters, name, cpu_times, username #sort_key=memory_percent # List of stats to disable (not grabed and not display) # Stats that can be disabled: cpu_percent,memory_info,memory_percent,username,cpu_times,num_threads,nice,status,io_counters,cmdline,cpu_num # Stats that can not be disable: pid,name disable_stats=cpu_num # Disable display of virtual memory #disable_virtual_memory=True # Define CPU/MEM (per process) thresholds in % # Default values if not defined: 50/70/90 cpu_careful=50 cpu_warning=70 cpu_critical=90 mem_careful=50 mem_warning=70 mem_critical=90 # # Nice priorities range from -20 to 19. # Configure nice levels using a comma-separated list. # # Nice: Example 1, non-zero is warning (default behavior) nice_warning=-20,-19,-18,-17,-16,-15,-14,-13,-12,-11,-10,-9,-8,-7,-6,-5,-4,-3,-2,-1,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19 # # Nice: Example 2, low priority processes escalate from careful to critical #nice_ok=O #nice_careful=1,2,3,4,5,6,7,8,9 #nice_warning=10,11,12,13,14 #nice_critical=15,16,17,18,19 # # Status: define threshold regarding the process status (first letter of process status) # R: Running, S: Sleeping, Z: Zombie (complete list here https://psutil.readthedocs.io/en/latest/#process-status-constants) status_ok=R,W,P,I status_critical=Z,D # Define the list of processes to export using: # a comma-separated list of Glances filter #export=.*firefox.*,pid:1234 # Define a list of process to focus on (comma-separated list of Glances filter) #focus=.*firefox.*,.*python.* [ports] disable=False # Interval in second between two scans # Ports scanner plugin configuration refresh=30 # Set the default timeout (in second) for a scan (can be overwritten in the scan list) timeout=3 # If port_default_gateway is True, add the default gateway on top of the scan list port_default_gateway=False # # Define the scan list (1 < x < 255) # port_x_host (name or IP) is mandatory # port_x_port (TCP port number) is optional (if not set, use ICMP) # port_x_description is optional (if not set, define to host:port) # port_x_timeout is optional and overwrite the default timeout value # port_x_rtt_warning is optional and defines the warning threshold in ms # #port_1_host=192.168.0.1 #port_1_port=80 #port_1_description=Home Box #port_1_timeout=1 #port_2_host=www.free.fr #port_2_description=My ISP #port_3_host=www.google.com #port_3_description=Internet ICMP #port_3_rtt_warning=1000 #port_4_description=Internet Web #port_4_host=www.google.com #port_4_port=80 #port_4_rtt_warning=1000 # # Define Web (URL) monitoring list (1 < x < 255) # web_x_url is the URL to monitor (example: http://my.site.com/folder) # web_x_description is optional (if not set, define to URL) # web_x_timeout is optional and overwrite the default timeout value # web_x_rtt_warning is optional and defines the warning respond time in ms (approximately) # #web_1_url=https://blog.nicolargo.com #web_1_description=My Blog #web_1_rtt_warning=3000 #web_2_url=https://github.com #web_3_url=http://www.google.fr #web_3_description=Google Fr #web_4_url=https://blog.nicolargo.com/nonexist #web_4_description=Intranet [vms] disable=True # Define the maximum VMs size name (default is 20 chars) max_name_size=20 # By default, Glances only display running VMs with states: # 'Running', 'Paused', 'Starting' or 'Restarting' # Set the following key to True to display all VMs regarding their states all=False [containers] disable=False # Only show specific containers (comma-separated list of container name or regular expression) # Comment this line to display all containers (default configuration) ; show=telegraf # Hide some containers (comma-separated list of container name or regular expression) # Comment this line to display all containers (default configuration) ; hide=telegraf # Define the maximum docker size name (default is 20 chars) max_name_size=20 # List of stats to disable (not display) # Following stats can be disabled: name,status,uptime,cpu,mem,diskio,networkio,ports,command disable_stats=command # Thresholds for CPU and MEM (in %) ; cpu_careful=50 ; cpu_warning=70 ; cpu_critical=90 ; mem_careful=20 ; mem_warning=50 ; mem_critical=70 # # Per container thresholds ; containername_cpu_careful=10 ; containername_cpu_warning=20 ; containername_cpu_critical=30 # # By default, Glances only display running containers # Set the following key to True to display all containers all=False # Define Podman sock ; podman_sock=unix:///run/user/1000/podman/podman.sock [amps] # AMPs configuration are defined in the bottom of this file disable=False [alert] disable=False # Maximum number of events to display (default is 10 events) ;max_events=10 # Minimum duration for an event to be taken into account (default is 6 seconds) ;min_duration=6 # Minimum time between two events of the same type (default is 6 seconds) # This is used to avoid too many alerts for the same event # Events will be merged ;min_interval=6 ############################################################################## # Browser mode - Static servers definition ############################################################################## [serverlist] # Define columns (comma separated list of ::()) to grab/display # Default is: system:hr_name,load:min5,cpu:total,mem:percent # You can also add stats with key, like sensors:value:Ambient (key is case sensitive) #columns=system:hr_name,load:min5,cpu:total,mem:percent,memswap:percent,sensors:value:Ambient,sensors:value:Composite # Define the static servers list # _protocol can be: rpc (default if not defined) or rest # List is limited to 256 servers max (1 to 256) #server_1_name=localhost #server_1_alias=Local WebUI #server_1_port=61266 #server_1_protocol=rest #server_2_name=localhost #server_2_alias=My local PC #server_2_port=61209 #server_2_protocol=rpc #server_3_name=192.168.0.17 #server_3_alias=Another PC on my network #server_3_port=61209 #server_3_protocol=rpc #server_4_name=notagooddefinition #server_4_port=61237 [passwords] # Define the passwords list related to the [serverlist] section # Syntax: host=password # Where: host is the hostname # password is the clear password # Additionally (and optionally) a default password could be defined #localhost=abc #default=defaultpassword # # Define the path of the local '.pwd' file (default is system one) #local_password_path=~/.config/glances ############################################################################## # Exports ############################################################################## [export] # Common section for all exporters # Do not export following fields (comma separated list of regex) #exclude_fields=.*_critical,.*_careful,.*_warning,.*\.key$ [graph] # Configuration for the --export graph option # Set the path where the graph (.svg files) will be created # Can be overwrite by the --graph-path command line option path=/tmp/glances # It is possible to generate the graphs automatically by setting the # generate_every to a non zero value corresponding to the seconds between # two generation. Set it to 0 to disable graph auto generation. generate_every=0 # See following configuration keys definitions in the Pygal lib documentation # http://pygal.org/en/stable/documentation/index.html width=800 height=600 style=DarkStyle [influxdb] # !!! # Will be DEPRECATED in future release. # Please have a look on the new influxdb3 export module # !!! # Configuration for the --export influxdb option # https://influxdb.com/ host=localhost port=8086 protocol=http user=root password=root db=glances # Prefix will be added for all measurement name # Ex: prefix=foo # => foo.cpu # => foo.mem # You can also use dynamic values #prefix=foo # Following tags will be added for all measurements # You can also use dynamic values. # Note: hostname and name (for process) are always added as a tag #tags=foo:bar,spam:eggs,domain:`domainname` [influxdb2] # Configuration for the --export influxdb2 option # https://influxdb.com/ host=localhost port=8086 protocol=http org=nicolargo bucket=glances token=PUT_YOUR_INFLUXDB2_TOKEN_HERE # Set the interval between two exports (in seconds) # If the interval is set to 0, the Glances refresh time is used (default behavor) #interval=0 # Prefix will be added for all measurement name # Ex: prefix=foo # => foo.cpu # => foo.mem # You can also use dynamic values #prefix=foo # Following tags will be added for all measurements # You can also use dynamic values. # Note: hostname and name (for process) are always added as a tag #tags=foo:bar,spam:eggs,domain:`domainname` [influxdb3] # Configuration for the --export influxdb3 option # https://influxdb.com/ host=http://localhost:8181 org=nicolargo database=glances token=PUT_YOUR_INFLUXDB3_TOKEN_HERE # Set the interval between two exports (in seconds) # If the interval is set to 0, the Glances refresh time is used (default behavor) #interval=0 # Prefix will be added for all measurement name # Ex: prefix=foo # => foo.cpu # => foo.mem # You can also use dynamic values #prefix=foo # Following tags will be added for all measurements # You can also use dynamic values. # Note: hostname and name (for process) are always added as a tag #tags=foo:bar,spam:eggs,domain:`domainname` [cassandra] # Configuration for the --export cassandra option # Also works for the ScyllaDB # https://influxdb.com/ or http://www.scylladb.com/ host=localhost port=9042 protocol_version=3 keyspace=glances replication_factor=2 # If not define, table name is set to host key table=localhost # If not define, username and password will not be used #username=cassandra #password=password [opentsdb] # Configuration for the --export opentsdb option # http://opentsdb.net/ host=localhost port=4242 #prefix=glances #tags=foo:bar,spam:eggs [statsd] # Configuration for the --export statsd option # https://github.com/etsy/statsd host=localhost port=8125 #prefix=glances [elasticsearch] # Configuration for the --export elasticsearch option # Data are available via the ES RESTful API. ex: URL//cpu # https://www.elastic.co scheme=http host=localhost port=9200 index=glances [riemann] # Configuration for the --export riemann option # http://riemann.io host=localhost port=5555 [rabbitmq] # Configuration for the --export rabbitmq option host=localhost port=5672 user=guest password=guest queue=glances_queue #protocol=amqps [mqtt] # Configuration for the --export mqtt option host=localhost # Overwrite device name in the topic #devicename=localhost port=8883 tls=false user=guest password=guest topic=glances topic_structure=per-metric callback_api_version=2 [couchdb] # Configuration for the --export couchdb option # https://www.couchdb.org host=localhost port=5984 db=glances user=admin password=admin [mongodb] # Configuration for the --export mongodb option # https://www.mongodb.com host=localhost port=27017 db=glances user=root password=example [kafka] # Configuration for the --export kafka option # http://kafka.apache.org/ host=localhost port=9092 topic=glances #compression=gzip # Tags will be added for all events #tags=foo:bar,spam:eggs # You can also use dynamic values #tags=hostname:`hostname -f` [zeromq] # Configuration for the --export zeromq option # http://www.zeromq.org # Use * to bind on all interfaces host=* port=5678 # Glances envelopes the stats in a publish message with two frames: # - First frame containing the following prefix (STRING) # - Second frame with the Glances plugin name (STRING) # - Third frame with the Glances plugin stats (JSON) prefix=G [prometheus] # Configuration for the --export prometheus option # https://prometheus.io # Create a Prometheus exporter listening on localhost:9091 (default configuration) # Metric are exporter using the following name: # __{labelkey:labelvalue} # Note: You should add this exporter to your Prometheus server configuration: # scrape_configs: # - job_name: 'glances_exporter' # scrape_interval: 5s # static_configs: # - targets: ['localhost:9091'] # # Labels will be added for all measurements (default is src:glances) # labels=foo:bar,spam:eggs # You can also use dynamic values # labels=system:`uname -s` # host=localhost port=9091 #prefix=glances labels=src:glances [restful] # Configuration for the --export restful option # Example, export to http://localhost:6789/ host=localhost port=6789 protocol=http path=/ [graphite] # Configuration for the --export graphite option # https://graphiteapp.org/ host=localhost port=2003 # Prefix will be added for all measurement name prefix=glances # System name added between the prefix and the stats # By default, system_name = FQDN #system_name=mycomputer [timescaledb] # Configuration for the --export timescaledb option # https://www.timescale.com/ host=localhost port=5432 db=glances user=postgres password=password # Overwrite device name (default is the FQDN) # Most of the time, you should not overwrite this value #hostname=mycomputer [nats] # Configuration for the --export nats option # https://nats.io/ # Host is a separated list of NATS nodes host=nats://localhost:4222 # Prefix for the subjects (default is 'glances') prefix=glances [duckdb] # database defines where data are stored, can be one of: # :memory: (see https://duckdb.org/docs/stable/clients/python/dbapi#in-memory-connection) # :memory:glances (see https://duckdb.org/docs/stable/clients/python/dbapi#in-memory-connection) # /path/to/glances.db (see https://duckdb.org/docs/stable/clients/python/dbapi#file-based-connection) # Or anyone else supported by the API (see https://duckdb.org/docs/stable/clients/python/dbapi) database=:memory: ############################################################################## # AMPS # * enable: Enable (true) or disable (false) the AMP # * regex: Regular expression to filter the process(es) # * refresh: The AMP is executed every refresh seconds # * one_line: (optional) Force (if true) the AMP to be displayed in one line # * command: (optional) command to execute when the process is detected (thk to the regex) # * countmin: (optional) minimal number of processes # A warning will be displayed if number of process < count # * countmax: (optional) maximum number of processes # A warning will be displayed if number of process > count # * : Others variables can be defined and used in the AMP script ############################################################################## [amp_dropbox] # Use the default AMP (no dedicated AMP Python script) # Check if the Dropbox daemon is running # Every 3 seconds, display the 'dropbox status' command line enable=false regex=.*dropbox.* refresh=3 one_line=false command=dropbox status countmin=1 [amp_python] # Use the default AMP (no dedicated AMP Python script) # Monitor all the Python scripts # Alert if more than 20 Python scripts are running enable=false regex=.*python.* refresh=3 countmax=20 [amp_conntrack] # Use && separator for multiple commands # If the regex key is not defined, the AMP will be executed every refresh second # and the process count will not be displayed (countmin and countmax will be ignore) enable=false refresh=30 one_line=false command=sysctl net.netfilter.nf_conntrack_count && sysctl net.netfilter.nf_conntrack_max [amp_nginx] # Use the NGinx AMP # Nginx status page should be enable (https://easyengine.io/tutorials/nginx/status-page/) enable=false regex=\/usr\/sbin\/nginx refresh=60 one_line=false status_url=http://localhost/nginx_status [amp_systemd] # Use the Systemd AMP enable=false regex=\/lib\/systemd\/systemd refresh=30 one_line=true systemctl_cmd=/bin/systemctl --plain [amp_systemv] # Use the Systemv AMP enable=false regex=\/sbin\/init refresh=30 one_line=true service_cmd=/usr/bin/service --status-all ================================================ FILE: docker-files/README.md ================================================ # Dockerfiles ```bash make docker ``` Then test the image with: ```bash make run-docker-alpine-dev ``` ================================================ FILE: docker-files/alpine.Dockerfile ================================================ # # Glances Dockerfile (based on Alpine) # # https://github.com/nicolargo/glances # # Note: ENV is for future running containers. ARG for building your Docker image. # WARNING: the Alpine image version and Python version should be set. # Alpine 3.18 tag is a link to the latest 3.18.x version. # Be aware that if you change the Alpine version, you may have to change the Python version. ARG IMAGE_VERSION=3.23 ARG PYTHON_VERSION=3.12 ############################################################################## # Base layer to be used for building dependencies and the release images FROM alpine:${IMAGE_VERSION} AS base # Upgrade the system RUN apk update \ && apk upgrade --no-cache # Install the minimal set of packages RUN apk add --no-cache \ python3 \ curl \ lm-sensors \ wireless-tools \ smartmontools \ iputils \ tzdata ############################################################################## # BUILD Stages ############################################################################## # BUILD: Base image shared by all build images FROM base AS build ARG PYTHON_VERSION RUN apk add --no-cache \ python3-dev \ py3-pip \ py3-wheel \ musl-dev \ linux-headers \ build-base \ libzmq \ zeromq-dev \ # Required for 'cryptography' dependency of optional requirement 'cassandra-driver' \ # Refer: https://cryptography.io/en/latest/installation/#alpine \ # `git` required to clone cargo crates (dependencies) git \ gcc \ cargo \ pkgconfig \ libffi-dev \ openssl-dev \ cmake # for cmake: Issue: https://github.com/nicolargo/glances/issues/2735 RUN python${PYTHON_VERSION} -m venv venv-build RUN /venv-build/bin/python${PYTHON_VERSION} -m pip install --upgrade pip RUN python${PYTHON_VERSION} -m venv --without-pip venv COPY pyproject.toml docker-requirements.txt all-requirements.txt ./ ############################################################################## # BUILD: Install the minimal image deps FROM build AS buildminimal ARG PYTHON_VERSION RUN /venv-build/bin/python${PYTHON_VERSION} -m pip install --target="/venv/lib/python${PYTHON_VERSION}/site-packages" \ -r docker-requirements.txt ############################################################################## # BUILD: Install all the deps FROM build AS buildfull ARG PYTHON_VERSION # Required for optional dependency cassandra-driver ARG CASS_DRIVER_NO_CYTHON=1 # See issue 2368 ARG CARGO_NET_GIT_FETCH_WITH_CLI=true RUN /venv-build/bin/python${PYTHON_VERSION} -m pip install --target="/venv/lib/python${PYTHON_VERSION}/site-packages" \ -r all-requirements.txt ############################################################################## # RELEASE Stages ############################################################################## # Base image shared by all releases FROM base AS release ARG PYTHON_VERSION # Copy source code and config file COPY ./docker-compose/glances.conf /etc/glances/glances.conf COPY ./glances/. /app/glances/ # Copy binary and update PATH COPY docker-bin.sh /usr/local/bin/glances RUN chmod a+x /usr/local/bin/glances ENV PATH="/venv/bin:$PATH" # EXPOSE PORT (XMLRPC / WebUI) EXPOSE 61209 61208 # Add glances user # RUN addgroup -g 1000 glances && \ # adduser -D -u 1000 -G glances glances && \ # chown -R glances:glances /app # Define default command. WORKDIR /app ENV PYTHON_VERSION=${PYTHON_VERSION} CMD ["/bin/sh", "-c", "/venv/bin/python${PYTHON_VERSION} -m glances ${GLANCES_OPT}"] ################################################################################ # RELEASE: minimal FROM release AS minimal COPY --from=buildminimal /venv /venv # USER glances ################################################################################ # RELEASE: full FROM release AS full RUN apk add --no-cache \ libzmq \ libvirt-client COPY --from=buildfull /venv /venv # USER glances ################################################################################ # RELEASE: dev - to be compatible with CI FROM full AS dev # Add the specific logger configuration file for Docker dev # All logs will be forwarded to stdout COPY ./docker-files/docker-logger.json /app ENV LOG_CFG=/app/docker-logger.json # USER glances WORKDIR /app ENV PYTHON_VERSION=${PYTHON_VERSION} CMD ["/bin/sh", "-c", "/venv/bin/python${PYTHON_VERSION} -m glances ${GLANCES_OPT}"] ================================================ FILE: docker-files/docker-logger.json ================================================ { "version": 1, "disable_existing_loggers": "False", "root": { "level": "INFO", "handlers": ["console"] }, "formatters": { "standard": { "format": "%(asctime)s -- %(levelname)s -- %(message)s" }, "short": { "format": "%(levelname)s -- %(message)s" }, "long": { "format": "%(asctime)s -- %(levelname)s -- %(message)s (%(funcName)s in %(filename)s)" }, "free": { "format": "%(message)s" } }, "handlers": { "console": { "class": "logging.StreamHandler", "formatter": "standard" } }, "loggers": { "debug": { "handlers": ["console"], "level": "DEBUG" }, "verbose": { "handlers": ["console"], "level": "INFO" }, "standard": { "handlers": ["console"], "level": "INFO" }, "requests": { "handlers": ["console"], "level": "ERROR" }, "elasticsearch": { "handlers": ["console"], "level": "ERROR" }, "elasticsearch.trace": { "handlers": ["console"], "level": "ERROR" } } } ================================================ FILE: docker-files/ubuntu.Dockerfile ================================================ # # Glances Dockerfile (based on Ubuntu) # # https://github.com/nicolargo/glances # # WARNING: the versions should be set. # Ex: Python 3.12 for Ubuntu 24.04 # Note: ENV is for future running containers. ARG for building your Docker image. ARG IMAGE_VERSION=24.04 ARG PYTHON_VERSION=3.12 ############################################################################## # Base layer to be used for building dependencies and the release images FROM ubuntu:${IMAGE_VERSION} AS base ARG DEBIAN_FRONTEND=noninteractive RUN apt-get update \ && apt-get install -y --no-install-recommends \ python3 \ curl \ lm-sensors \ wireless-tools \ smartmontools \ net-tools \ tzdata \ && apt-get clean \ && rm -rf /var/lib/apt/lists/* ############################################################################## # BUILD Stages ############################################################################## # BUILD: Base image shared by all build images FROM base AS build ARG PYTHON_VERSION ARG DEBIAN_FRONTEND=noninteractive # Upgrade the system RUN apt-get update \ && apt-get upgrade -y # Install build-time dependencies RUN apt-get install -y --no-install-recommends \ python3-dev \ python3-venv \ python3-pip \ python3-wheel \ libzmq5 \ musl-dev \ build-essential RUN apt-get clean \ && rm -rf /var/lib/apt/lists/* RUN python3 -m venv --without-pip venv COPY pyproject.toml docker-requirements.txt all-requirements.txt ./ ############################################################################## # BUILD: Install the minimal image deps FROM build AS buildminimal ARG PYTHON_VERSION RUN python3 -m pip install --target="/venv/lib/python${PYTHON_VERSION}/site-packages" \ -r docker-requirements.txt ############################################################################## # BUILD: Install all the deps FROM build AS buildfull ARG PYTHON_VERSION RUN python3 -m pip install --target="/venv/lib/python${PYTHON_VERSION}/site-packages" \ -r all-requirements.txt ############################################################################## # RELEASE Stages ############################################################################## # Base image shared by all releases FROM base AS release ARG PYTHON_VERSION # Copy Glances source code and config file COPY ./docker-compose/glances.conf /etc/glances/glances.conf COPY ./glances/. /app/glances/ # Copy binary and update PATH COPY docker-bin.sh /usr/local/bin/glances RUN chmod a+x /usr/local/bin/glances ENV PATH="/venv/bin:$PATH" # EXPOSE PORT (XMLRPC / WebUI) EXPOSE 61209 61208 # Add glances user # NOTE: If used, the Glances Docker plugin do not work... # UID and GUID 1000 are already configured for the ubuntu user # Create anew one with UID and GUID 1001 # RUN groupadd -g 1001 glances && \ # useradd -u 1001 -g glances glances && \ # chown -R glances:glances /app # Define default command. WORKDIR /app ENV PYTHON_VERSION=${PYTHON_VERSION} CMD ["/bin/sh", "-c", "/venv/bin/python${PYTHON_VERSION} -m glances ${GLANCES_OPT}"] ################################################################################ # RELEASE: minimal FROM release AS minimal ARG PYTHON_VERSION COPY --from=buildMinimal /venv /venv # USER glances ################################################################################ # RELEASE: full FROM release AS full ARG PYTHON_VERSION RUN apt-get update \ && apt-get install -y --no-install-recommends \ libzmq5 \ libvirt-clients \ && apt-get clean \ && rm -rf /var/lib/apt/lists/* COPY --from=buildfull /venv /venv # USER glances ################################################################################ # RELEASE: dev - to be compatible with CI FROM full AS dev ARG PYTHON_VERSION # Add the specific logger configuration file for Docker dev # All logs will be forwarded to stdout COPY ./docker-files/docker-logger.json /app ENV LOG_CFG=/app/docker-logger.json # USER glances WORKDIR /app ENV PYTHON_VERSION=${PYTHON_VERSION} CMD ["/bin/sh", "-c", "/venv/bin/python${PYTHON_VERSION} -m glances ${GLANCES_OPT}"] ================================================ FILE: docker-requirements.txt ================================================ # This file was autogenerated by uv via the following command: # uv export --no-emit-workspace --no-hashes --no-group dev --extra containers --extra web --extra mcp --output-file docker-requirements.txt annotated-doc==0.0.4 # via fastapi annotated-types==0.7.0 # via pydantic anyio==4.12.1 # via # httpx # mcp # sse-starlette # starlette attrs==25.4.0 # via # jsonschema # referencing certifi==2026.2.25 # via # httpcore # httpx # requests cffi==2.0.0 ; platform_python_implementation != 'PyPy' # via cryptography charset-normalizer==3.4.5 # via requests click==8.1.8 # via uvicorn colorama==0.4.6 ; sys_platform == 'win32' # via click cryptography==46.0.5 # via # pyjwt # pylxd # python-jose defusedxml==0.7.1 # via glances docker==7.1.0 # via glances ecdsa==0.19.1 # via python-jose exceptiongroup==1.2.2 ; python_full_version < '3.11' # via anyio fastapi==0.135.1 # via glances h11==0.16.0 # via # httpcore # uvicorn httpcore==1.0.9 # via httpx httpx==0.28.1 # via mcp httpx-sse==0.4.3 # via mcp idna==3.11 # via # anyio # httpx # requests jinja2==3.1.6 # via glances jsonschema==4.25.1 # via mcp jsonschema-specifications==2025.9.1 # via jsonschema markupsafe==3.0.3 # via jinja2 mcp==1.23.3 # via glances packaging==26.0 # via glances podman==5.7.0 # via glances psutil==7.2.2 # via glances pyasn1==0.6.2 # via # python-jose # rsa pycparser==3.0 ; implementation_name != 'PyPy' and platform_python_implementation != 'PyPy' # via cffi pydantic==2.12.5 # via # fastapi # mcp # pydantic-settings pydantic-core==2.41.5 # via pydantic pydantic-settings==2.13.1 # via mcp pyinstrument==5.1.2 # via glances pyjwt==2.12.1 # via mcp pylxd==2.3.9 # via glances python-dateutil==2.9.0.post0 # via # glances # pylxd python-dotenv==1.2.2 # via pydantic-settings python-jose==3.5.0 # via glances python-multipart==0.0.22 # via mcp pywin32==311 ; sys_platform == 'win32' # via # docker # mcp referencing==0.37.0 # via # jsonschema # jsonschema-specifications requests==2.32.5 # via # docker # glances # podman # pylxd # requests-toolbelt requests-toolbelt==1.0.0 # via pylxd rpds-py==0.30.0 # via # jsonschema # referencing rsa==4.9.1 # via python-jose shtab==1.8.0 ; sys_platform != 'win32' # via glances six==1.17.0 # via # ecdsa # glances # python-dateutil sse-starlette==3.3.2 # via mcp starlette==0.52.1 # via # fastapi # mcp # sse-starlette tomli==2.0.2 ; python_full_version < '3.11' # via podman typing-extensions==4.15.0 # via # anyio # cryptography # fastapi # mcp # pydantic # pydantic-core # pyjwt # referencing # starlette # typing-inspection # uvicorn typing-inspection==0.4.2 # via # fastapi # mcp # pydantic # pydantic-settings urllib3==2.6.3 # via # docker # podman # requests uvicorn==0.41.0 # via # glances # mcp windows-curses==2.4.1 ; sys_platform == 'win32' # via glances ws4py==0.6.0 # via pylxd ================================================ FILE: docs/Makefile ================================================ # Makefile for Sphinx documentation # # You can set these variables from the command line. SPHINXOPTS = SPHINXBUILD = ../.venv/bin/sphinx-build PAPER = BUILDDIR = _build # User-friendly check for sphinx-build ifeq ($(shell which $(SPHINXBUILD) >/dev/null 2>&1; echo $$?), 1) $(error The '$(SPHINXBUILD)' command was not found. Make sure you have Sphinx installed, then set the SPHINXBUILD environment variable to point to the full path of the '$(SPHINXBUILD)' executable. Alternatively you can add the directory with the executable to your PATH. If you don't have Sphinx installed, grab it from http://sphinx-doc.org/) endif # Internal variables. PAPEROPT_a4 = -D latex_paper_size=a4 PAPEROPT_letter = -D latex_paper_size=letter ALLSPHINXOPTS = -d $(BUILDDIR)/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) . # the i18n builder cannot share the environment and doctrees with the others I18NSPHINXOPTS = $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) . .PHONY: help help: @echo "Please use \`make ' where is one of" @echo " html to make standalone HTML files" @echo " dirhtml to make HTML files named index.html in directories" @echo " singlehtml to make a single large HTML file" @echo " pickle to make pickle files" @echo " json to make JSON files" @echo " htmlhelp to make HTML files and a HTML help project" @echo " qthelp to make HTML files and a qthelp project" @echo " applehelp to make an Apple Help Book" @echo " devhelp to make HTML files and a Devhelp project" @echo " epub to make an epub" @echo " latex to make LaTeX files, you can set PAPER=a4 or PAPER=letter" @echo " latexpdf to make LaTeX files and run them through pdflatex" @echo " latexpdfja to make LaTeX files and run them through platex/dvipdfmx" @echo " text to make text files" @echo " man to make manual pages" @echo " texinfo to make Texinfo files" @echo " info to make Texinfo files and run them through makeinfo" @echo " gettext to make PO message catalogs" @echo " changes to make an overview of all changed/added/deprecated items" @echo " xml to make Docutils-native XML files" @echo " pseudoxml to make pseudoxml-XML files for display purposes" @echo " linkcheck to check all external links for integrity" @echo " doctest to run all doctests embedded in the documentation (if enabled)" @echo " coverage to run coverage check of the documentation (if enabled)" .PHONY: clean clean: rm -rf $(BUILDDIR)/* .PHONY: html html: $(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html @echo @echo "Build finished. The HTML pages are in $(BUILDDIR)/html." .PHONY: dirhtml dirhtml: $(SPHINXBUILD) -b dirhtml $(ALLSPHINXOPTS) $(BUILDDIR)/dirhtml @echo @echo "Build finished. The HTML pages are in $(BUILDDIR)/dirhtml." .PHONY: singlehtml singlehtml: $(SPHINXBUILD) -b singlehtml $(ALLSPHINXOPTS) $(BUILDDIR)/singlehtml @echo @echo "Build finished. The HTML page is in $(BUILDDIR)/singlehtml." .PHONY: pickle pickle: $(SPHINXBUILD) -b pickle $(ALLSPHINXOPTS) $(BUILDDIR)/pickle @echo @echo "Build finished; now you can process the pickle files." .PHONY: json json: $(SPHINXBUILD) -b json $(ALLSPHINXOPTS) $(BUILDDIR)/json @echo @echo "Build finished; now you can process the JSON files." .PHONY: htmlhelp htmlhelp: $(SPHINXBUILD) -b htmlhelp $(ALLSPHINXOPTS) $(BUILDDIR)/htmlhelp @echo @echo "Build finished; now you can run HTML Help Workshop with the" \ ".hhp project file in $(BUILDDIR)/htmlhelp." .PHONY: qthelp qthelp: $(SPHINXBUILD) -b qthelp $(ALLSPHINXOPTS) $(BUILDDIR)/qthelp @echo @echo "Build finished; now you can run "qcollectiongenerator" with the" \ ".qhcp project file in $(BUILDDIR)/qthelp, like this:" @echo "# qcollectiongenerator $(BUILDDIR)/qthelp/Glances.qhcp" @echo "To view the help file:" @echo "# assistant -collectionFile $(BUILDDIR)/qthelp/Glances.qhc" .PHONY: applehelp applehelp: $(SPHINXBUILD) -b applehelp $(ALLSPHINXOPTS) $(BUILDDIR)/applehelp @echo @echo "Build finished. The help book is in $(BUILDDIR)/applehelp." @echo "N.B. You won't be able to view it unless you put it in" \ "~/Library/Documentation/Help or install it in your application" \ "bundle." .PHONY: devhelp devhelp: $(SPHINXBUILD) -b devhelp $(ALLSPHINXOPTS) $(BUILDDIR)/devhelp @echo @echo "Build finished." @echo "To view the help file:" @echo "# mkdir -p $$HOME/.local/share/devhelp/Glances" @echo "# ln -s $(BUILDDIR)/devhelp $$HOME/.local/share/devhelp/Glances" @echo "# devhelp" .PHONY: epub epub: $(SPHINXBUILD) -b epub $(ALLSPHINXOPTS) $(BUILDDIR)/epub @echo @echo "Build finished. The epub file is in $(BUILDDIR)/epub." .PHONY: latex latex: $(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex @echo @echo "Build finished; the LaTeX files are in $(BUILDDIR)/latex." @echo "Run \`make' in that directory to run these through (pdf)latex" \ "(use \`make latexpdf' here to do that automatically)." .PHONY: latexpdf latexpdf: $(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex @echo "Running LaTeX files through pdflatex..." $(MAKE) -C $(BUILDDIR)/latex all-pdf @echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex." .PHONY: latexpdfja latexpdfja: $(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex @echo "Running LaTeX files through platex and dvipdfmx..." $(MAKE) -C $(BUILDDIR)/latex all-pdf-ja @echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex." .PHONY: text text: $(SPHINXBUILD) -b text $(ALLSPHINXOPTS) $(BUILDDIR)/text @echo @echo "Build finished. The text files are in $(BUILDDIR)/text." .PHONY: man man: $(SPHINXBUILD) -b man $(ALLSPHINXOPTS) $(BUILDDIR)/man @echo @echo "Build finished. The manual pages are in $(BUILDDIR)/man." rm -f man/* cp $(BUILDDIR)/man/* man/ @echo "The manual pages have been copied in ./man." .PHONY: texinfo texinfo: $(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo @echo @echo "Build finished. The Texinfo files are in $(BUILDDIR)/texinfo." @echo "Run \`make' in that directory to run these through makeinfo" \ "(use \`make info' here to do that automatically)." .PHONY: info info: $(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo @echo "Running Texinfo files through makeinfo..." make -C $(BUILDDIR)/texinfo info @echo "makeinfo finished; the Info files are in $(BUILDDIR)/texinfo." .PHONY: gettext gettext: $(SPHINXBUILD) -b gettext $(I18NSPHINXOPTS) $(BUILDDIR)/locale @echo @echo "Build finished. The message catalogs are in $(BUILDDIR)/locale." .PHONY: changes changes: $(SPHINXBUILD) -b changes $(ALLSPHINXOPTS) $(BUILDDIR)/changes @echo @echo "The overview file is in $(BUILDDIR)/changes." .PHONY: linkcheck linkcheck: $(SPHINXBUILD) -b linkcheck $(ALLSPHINXOPTS) $(BUILDDIR)/linkcheck @echo @echo "Link check complete; look for any errors in the above output " \ "or in $(BUILDDIR)/linkcheck/output.txt." .PHONY: doctest doctest: $(SPHINXBUILD) -b doctest $(ALLSPHINXOPTS) $(BUILDDIR)/doctest @echo "Testing of doctests in the sources finished, look at the " \ "results in $(BUILDDIR)/doctest/output.txt." .PHONY: coverage coverage: $(SPHINXBUILD) -b coverage $(ALLSPHINXOPTS) $(BUILDDIR)/coverage @echo "Testing of coverage in the sources finished, look at the " \ "results in $(BUILDDIR)/coverage/python.txt." .PHONY: xml xml: $(SPHINXBUILD) -b xml $(ALLSPHINXOPTS) $(BUILDDIR)/xml @echo @echo "Build finished. The XML files are in $(BUILDDIR)/xml." .PHONY: pseudoxml pseudoxml: $(SPHINXBUILD) -b pseudoxml $(ALLSPHINXOPTS) $(BUILDDIR)/pseudoxml @echo @echo "Build finished. The pseudo-XML files are in $(BUILDDIR)/pseudoxml." ================================================ FILE: docs/README.txt ================================================ Building the docs ================= First install Sphinx and the RTD theme: make venv or update it if already installed: make venv-upgrade Go to the docs folder: cd docs Then build the HTML documentation: make html and the man page: LC_ALL=C make man ================================================ FILE: docs/_static/glances-architecture.excalidraw ================================================ { "type": "excalidraw", "version": 2, "source": "https://excalidraw.com", "elements": [ { "type": "rectangle", "version": 252, "versionNonce": 1518270375, "isDeleted": false, "id": "z3aBIxHcDX9glf-RUyasf", "fillStyle": "hachure", "strokeWidth": 2, "strokeStyle": "solid", "roughness": 0, "opacity": 100, "angle": 0, "x": 421, "y": 161, "strokeColor": "#000000", "backgroundColor": "transparent", "width": 181, "height": 121, "seed": 79658283, "groupIds": [], "roundness": { "type": 3 }, "boundElements": [ { "type": "text", "id": "du6r0JkGG0RB4vV62RPED" }, { "id": "rukQ6f7gbwCK6dMF4PqSY", "type": "arrow" } ], "updated": 1675588528733, "link": null, "locked": false }, { "type": "text", "version": 190, "versionNonce": 1462725319, "isDeleted": false, "id": "du6r0JkGG0RB4vV62RPED", "fillStyle": "hachure", "strokeWidth": 2, "strokeStyle": "solid", "roughness": 0, "opacity": 100, "angle": 0, "x": 445.5, "y": 208.5, "strokeColor": "#000000", "backgroundColor": "transparent", "width": 132, "height": 24, "seed": 257619179, "groupIds": [], "roundness": null, "boundElements": [], "updated": 1675588528733, "link": null, "locked": false, "fontSize": 20, "fontFamily": 1, "text": "__main__.py", "baseline": 17, "textAlign": "center", "verticalAlign": "middle", "containerId": "z3aBIxHcDX9glf-RUyasf", "originalText": "__main__.py" }, { "type": "rectangle", "version": 298, "versionNonce": 99010857, "isDeleted": false, "id": "dIN0jifjByOhE61mIip2q", "fillStyle": "hachure", "strokeWidth": 2, "strokeStyle": "solid", "roughness": 0, "opacity": 100, "angle": 0, "x": 641.5, "y": 163.5, "strokeColor": "#000000", "backgroundColor": "transparent", "width": 181, "height": 121, "seed": 271966315, "groupIds": [], "roundness": { "type": 3 }, "boundElements": [ { "type": "text", "id": "X93uxb5Vg-Lx2teoRVW5N" }, { "id": "I97BFsH6FvYyq9_UjRwU6", "type": "arrow" }, { "id": "rukQ6f7gbwCK6dMF4PqSY", "type": "arrow" } ], "updated": 1675588528733, "link": null, "locked": false }, { "type": "text", "version": 237, "versionNonce": 15377671, "isDeleted": false, "id": "X93uxb5Vg-Lx2teoRVW5N", "fillStyle": "hachure", "strokeWidth": 2, "strokeStyle": "solid", "roughness": 0, "opacity": 100, "angle": 0, "x": 671.5, "y": 211, "strokeColor": "#000000", "backgroundColor": "transparent", "width": 121, "height": 24, "seed": 518451141, "groupIds": [], "roundness": null, "boundElements": [], "updated": 1675588528734, "link": null, "locked": false, "fontSize": 20, "fontFamily": 1, "text": "__init__.py", "baseline": 17, "textAlign": "center", "verticalAlign": "middle", "containerId": "dIN0jifjByOhE61mIip2q", "originalText": "__init__.py" }, { "type": "diamond", "version": 609, "versionNonce": 1413698281, "isDeleted": false, "id": "VbHVhy7vaW6prJo4QFEX5", "fillStyle": "hachure", "strokeWidth": 2, "strokeStyle": "solid", "roughness": 0, "opacity": 100, "angle": 0, "x": 639, "y": 371, "strokeColor": "#0b7285", "backgroundColor": "transparent", "width": 189, "height": 179, "seed": 957302987, "groupIds": [], "roundness": { "type": 2 }, "boundElements": [ { "type": "text", "id": "TVdYovxpvasH4tY7IEceE" }, { "id": "I97BFsH6FvYyq9_UjRwU6", "type": "arrow" }, { "id": "ZCD_-KAOjwV2nBx0hUglp", "type": "arrow" } ], "updated": 1675588528734, "link": null, "locked": false }, { "type": "text", "version": 549, "versionNonce": 1007357385, "isDeleted": false, "id": "TVdYovxpvasH4tY7IEceE", "fillStyle": "hachure", "strokeWidth": 2, "strokeStyle": "solid", "roughness": 0, "opacity": 100, "angle": 0, "x": 712.5, "y": 454.25, "strokeColor": "#0b7285", "backgroundColor": "transparent", "width": 42, "height": 24, "seed": 377713765, "groupIds": [], "roundness": null, "boundElements": [], "updated": 1675588528734, "link": null, "locked": false, "fontSize": 20, "fontFamily": 1, "text": "core", "baseline": 17, "textAlign": "center", "verticalAlign": "middle", "containerId": "VbHVhy7vaW6prJo4QFEX5", "originalText": "core" }, { "id": "I97BFsH6FvYyq9_UjRwU6", "type": "arrow", "x": 732, "y": 286, "width": 0, "height": 86, "angle": 0, "strokeColor": "#000000", "backgroundColor": "transparent", "fillStyle": "hachure", "strokeWidth": 2, "strokeStyle": "solid", "roughness": 0, "opacity": 100, "groupIds": [], "roundness": { "type": 2 }, "seed": 1744777639, "version": 407, "versionNonce": 1524707975, "isDeleted": false, "boundElements": null, "updated": 1675588528805, "link": null, "locked": false, "points": [ [ 0, 0 ], [ 0, 86 ] ], "lastCommittedPoint": null, "startBinding": { "elementId": "dIN0jifjByOhE61mIip2q", "focus": 0, "gap": 1.5 }, "endBinding": { "elementId": "VbHVhy7vaW6prJo4QFEX5", "focus": -0.015873015873015872, "gap": 1 }, "startArrowhead": null, "endArrowhead": "arrow" }, { "id": "rEhm0ZMsmg2lbgHYNuUTa", "type": "text", "x": 742.5, "y": 307, "width": 41, "height": 26, "angle": 0, "strokeColor": "#000000", "backgroundColor": "transparent", "fillStyle": "hachure", "strokeWidth": 2, "strokeStyle": "solid", "roughness": 0, "opacity": 100, "groupIds": [], "roundness": null, "seed": 2115715529, "version": 149, "versionNonce": 215510185, "isDeleted": false, "boundElements": null, "updated": 1675588528734, "link": null, "locked": false, "text": "main", "fontSize": 20, "fontFamily": 1, "textAlign": "center", "verticalAlign": "top", "baseline": 18, "containerId": null, "originalText": "main" }, { "id": "rukQ6f7gbwCK6dMF4PqSY", "type": "arrow", "x": 602, "y": 221, "width": 37, "height": 0, "angle": 0, "strokeColor": "#000000", "backgroundColor": "transparent", "fillStyle": "hachure", "strokeWidth": 2, "strokeStyle": "solid", "roughness": 0, "opacity": 100, "groupIds": [], "roundness": { "type": 2 }, "seed": 669272615, "version": 400, "versionNonce": 1229408679, "isDeleted": false, "boundElements": null, "updated": 1675588528805, "link": null, "locked": false, "points": [ [ 0, 0 ], [ 37, 0 ] ], "lastCommittedPoint": null, "startBinding": { "elementId": "z3aBIxHcDX9glf-RUyasf", "focus": -0.008264462809917356, "gap": 1 }, "endBinding": { "elementId": "dIN0jifjByOhE61mIip2q", "focus": 0.04958677685950414, "gap": 2.5 }, "startArrowhead": null, "endArrowhead": "arrow" }, { "type": "rectangle", "version": 396, "versionNonce": 1582755721, "isDeleted": false, "id": "T-vzSegxNCFDy63YeUtoQ", "fillStyle": "hachure", "strokeWidth": 2, "strokeStyle": "solid", "roughness": 0, "opacity": 100, "angle": 0, "x": 884.5, "y": 160.5, "strokeColor": "#000000", "backgroundColor": "transparent", "width": 181, "height": 121, "seed": 1133526185, "groupIds": [], "roundness": { "type": 3 }, "boundElements": [ { "type": "text", "id": "oD5JS6GZ5RLxtniTQ2qPO" } ], "updated": 1675588528734, "link": null, "locked": false }, { "type": "text", "version": 341, "versionNonce": 175663495, "isDeleted": false, "id": "oD5JS6GZ5RLxtniTQ2qPO", "fillStyle": "hachure", "strokeWidth": 2, "strokeStyle": "solid", "roughness": 0, "opacity": 100, "angle": 0, "x": 942.5, "y": 208.75, "strokeColor": "#000000", "backgroundColor": "transparent", "width": 65, "height": 24, "seed": 706608743, "groupIds": [], "roundness": null, "boundElements": null, "updated": 1675588528734, "link": null, "locked": false, "fontSize": 20, "fontFamily": 1, "text": "main.py", "baseline": 17, "textAlign": "center", "verticalAlign": "middle", "containerId": "T-vzSegxNCFDy63YeUtoQ", "originalText": "main.py" }, { "type": "diamond", "version": 683, "versionNonce": 1187124841, "isDeleted": false, "id": "TPoX-fVCSz4gF9Bb7oJD4", "fillStyle": "hachure", "strokeWidth": 2, "strokeStyle": "solid", "roughness": 0, "opacity": 100, "angle": 0, "x": 880.5, "y": 370.5, "strokeColor": "#0b7285", "backgroundColor": "transparent", "width": 189, "height": 179, "seed": 451990279, "groupIds": [], "roundness": { "type": 2 }, "boundElements": [ { "type": "text", "id": "hdUnLjhzTcHH_2Xr-4f4v" } ], "updated": 1675588528734, "link": null, "locked": false }, { "type": "text", "version": 641, "versionNonce": 249536679, "isDeleted": false, "id": "hdUnLjhzTcHH_2Xr-4f4v", "fillStyle": "hachure", "strokeWidth": 2, "strokeStyle": "solid", "roughness": 0, "opacity": 100, "angle": 0, "x": 908, "y": 447.75, "strokeColor": "#0b7285", "backgroundColor": "transparent", "width": 134, "height": 24, "seed": 1736377577, "groupIds": [], "roundness": null, "boundElements": null, "updated": 1675588528734, "link": null, "locked": false, "fontSize": 20, "fontFamily": 1, "text": "GlancesMain()", "baseline": 17, "textAlign": "center", "verticalAlign": "middle", "containerId": "TPoX-fVCSz4gF9Bb7oJD4", "originalText": "GlancesMain()" }, { "id": "qmRB-3Yh035xXWyGPzRAh", "type": "line", "x": 975, "y": 374, "width": 0, "height": 93, "angle": 0, "strokeColor": "#000000", "backgroundColor": "transparent", "fillStyle": "hachure", "strokeWidth": 2, "strokeStyle": "solid", "roughness": 0, "opacity": 100, "groupIds": [], "roundness": { "type": 2 }, "seed": 1174340489, "version": 150, "versionNonce": 149250377, "isDeleted": false, "boundElements": null, "updated": 1675588528734, "link": null, "locked": false, "points": [ [ 0, 0 ], [ 0, -93 ] ], "lastCommittedPoint": null, "startBinding": null, "endBinding": null, "startArrowhead": null, "endArrowhead": null }, { "id": "yjKLIF0byoBCFlu3snqvC", "type": "line", "x": 820, "y": 458, "width": 65, "height": 1, "angle": 0, "strokeColor": "#000000", "backgroundColor": "transparent", "fillStyle": "hachure", "strokeWidth": 2, "strokeStyle": "solid", "roughness": 0, "opacity": 100, "groupIds": [], "roundness": { "type": 2 }, "seed": 117968553, "version": 148, "versionNonce": 1804792775, "isDeleted": false, "boundElements": null, "updated": 1675588528734, "link": null, "locked": false, "points": [ [ 0, 0 ], [ 65, -1 ] ], "lastCommittedPoint": null, "startBinding": null, "endBinding": null, "startArrowhead": null, "endArrowhead": null }, { "id": "iPpO1aE_0LRKjBVQ0N19d", "type": "text", "x": 847.5, "y": 427, "width": 13, "height": 26, "angle": 0, "strokeColor": "#000000", "backgroundColor": "transparent", "fillStyle": "hachure", "strokeWidth": 2, "strokeStyle": "solid", "roughness": 0, "opacity": 100, "groupIds": [], "roundness": null, "seed": 1595409129, "version": 142, "versionNonce": 35409961, "isDeleted": false, "boundElements": null, "updated": 1675588528734, "link": null, "locked": false, "text": "=", "fontSize": 20, "fontFamily": 1, "textAlign": "center", "verticalAlign": "top", "baseline": 18, "containerId": null, "originalText": "=" }, { "type": "diamond", "version": 881, "versionNonce": 524454599, "isDeleted": false, "id": "V_Q9JjPuvqh6fBfAh7P3g", "fillStyle": "hachure", "strokeWidth": 2, "strokeStyle": "solid", "roughness": 0, "opacity": 100, "angle": 0, "x": 637.5, "y": 692.5, "strokeColor": "#0b7285", "backgroundColor": "transparent", "width": 189, "height": 179, "seed": 2061438665, "groupIds": [], "roundness": { "type": 2 }, "boundElements": [ { "type": "text", "id": "SA83r_0ZTZaJPzSOsa6ai" }, { "id": "nJ0-zL6oGLjw0f7sLt3t1", "type": "arrow" } ], "updated": 1675590397112, "link": null, "locked": false }, { "type": "text", "version": 823, "versionNonce": 1616091623, "isDeleted": false, "id": "SA83r_0ZTZaJPzSOsa6ai", "fillStyle": "hachure", "strokeWidth": 2, "strokeStyle": "solid", "roughness": 0, "opacity": 100, "angle": 0, "x": 708.5, "y": 769.75, "strokeColor": "#0b7285", "backgroundColor": "transparent", "width": 47, "height": 24, "seed": 1903484487, "groupIds": [], "roundness": null, "boundElements": null, "updated": 1675590397121, "link": null, "locked": false, "fontSize": 20, "fontFamily": 1, "text": "mode", "baseline": 17, "textAlign": "center", "verticalAlign": "middle", "containerId": "V_Q9JjPuvqh6fBfAh7P3g", "originalText": "mode" }, { "id": "nJ0-zL6oGLjw0f7sLt3t1", "type": "arrow", "x": 731, "y": 543, "width": 2.1231441617119344, "height": 148.32611751283002, "angle": 0, "strokeColor": "#000000", "backgroundColor": "transparent", "fillStyle": "hachure", "strokeWidth": 2, "strokeStyle": "solid", "roughness": 0, "opacity": 100, "groupIds": [], "roundness": { "type": 2 }, "seed": 923576615, "version": 504, "versionNonce": 1410705705, "isDeleted": false, "boundElements": null, "updated": 1675590397121, "link": null, "locked": false, "points": [ [ 0, 0 ], [ 2.1231441617119344, 148.32611751283002 ] ], "lastCommittedPoint": null, "startBinding": null, "endBinding": { "elementId": "V_Q9JjPuvqh6fBfAh7P3g", "focus": 0.02561960456697391, "gap": 1.6246183338150217 }, "startArrowhead": null, "endArrowhead": "arrow" }, { "type": "text", "version": 198, "versionNonce": 1623364903, "isDeleted": false, "id": "ri2fonVaxx3URCz9V1PjJ", "fillStyle": "hachure", "strokeWidth": 2, "strokeStyle": "solid", "roughness": 0, "opacity": 100, "angle": 0, "x": 747, "y": 553, "strokeColor": "#000000", "backgroundColor": "transparent", "width": 56, "height": 26, "seed": 1733680745, "groupIds": [], "roundness": null, "boundElements": null, "updated": 1675588528734, "link": null, "locked": false, "fontSize": 20, "fontFamily": 1, "text": "start", "baseline": 18, "textAlign": "center", "verticalAlign": "top", "containerId": null, "originalText": "start" }, { "type": "rectangle", "version": 719, "versionNonce": 867736585, "isDeleted": false, "id": "So2q8hpc6F5KvtPQFTop8", "fillStyle": "hachure", "strokeWidth": 2, "strokeStyle": "solid", "roughness": 0, "opacity": 100, "angle": 0, "x": 234.5, "y": 683.5, "strokeColor": "#c92a2a", "backgroundColor": "transparent", "width": 251, "height": 34, "seed": 1945517991, "groupIds": [], "roundness": { "type": 3 }, "boundElements": [ { "type": "text", "id": "sGrQmvRDJHuYF_9i6rXob" } ], "updated": 1675590397121, "link": null, "locked": false }, { "type": "text", "version": 675, "versionNonce": 1991623943, "isDeleted": false, "id": "sGrQmvRDJHuYF_9i6rXob", "fillStyle": "hachure", "strokeWidth": 2, "strokeStyle": "solid", "roughness": 0, "opacity": 100, "angle": 0, "x": 294, "y": 688.5, "strokeColor": "#c92a2a", "backgroundColor": "transparent", "width": 132, "height": 24, "seed": 491532873, "groupIds": [], "roundness": null, "boundElements": null, "updated": 1675590397121, "link": null, "locked": false, "fontSize": 20, "fontFamily": 1, "text": "standalone.py", "baseline": 17, "textAlign": "center", "verticalAlign": "middle", "containerId": "So2q8hpc6F5KvtPQFTop8", "originalText": "standalone.py" }, { "type": "rectangle", "version": 753, "versionNonce": 1278882537, "isDeleted": false, "id": "1wtZQP7JhcQ4lwrIYtmqt", "fillStyle": "hachure", "strokeWidth": 2, "strokeStyle": "solid", "roughness": 0, "opacity": 100, "angle": 0, "x": 234.5, "y": 722, "strokeColor": "#000000", "backgroundColor": "transparent", "width": 251, "height": 34.5, "seed": 120949223, "groupIds": [], "roundness": { "type": 3 }, "boundElements": [ { "type": "text", "id": "AZjkn1SJRrYlmgfL9zSOs" } ], "updated": 1675590397122, "link": null, "locked": false }, { "type": "text", "version": 714, "versionNonce": 1373998119, "isDeleted": false, "id": "AZjkn1SJRrYlmgfL9zSOs", "fillStyle": "hachure", "strokeWidth": 2, "strokeStyle": "solid", "roughness": 0, "opacity": 100, "angle": 0, "x": 300.5, "y": 727, "strokeColor": "#000000", "backgroundColor": "transparent", "width": 119, "height": 24, "seed": 1479388169, "groupIds": [], "roundness": null, "boundElements": null, "updated": 1675590397122, "link": null, "locked": false, "fontSize": 20, "fontFamily": 1, "text": "webserver.py", "baseline": 17, "textAlign": "center", "verticalAlign": "middle", "containerId": "1wtZQP7JhcQ4lwrIYtmqt", "originalText": "webserver.py" }, { "type": "rectangle", "version": 797, "versionNonce": 1378217417, "isDeleted": false, "id": "48sa_pFKMBlEU75p47EfA", "fillStyle": "hachure", "strokeWidth": 2, "strokeStyle": "solid", "roughness": 0, "opacity": 100, "angle": 0, "x": 234.5, "y": 763, "strokeColor": "#000000", "backgroundColor": "transparent", "width": 251, "height": 34, "seed": 1398331655, "groupIds": [], "roundness": { "type": 3 }, "boundElements": [ { "type": "text", "id": "0Z2AD5xnd4bUAS3ryDS-y" } ], "updated": 1675590397122, "link": null, "locked": false }, { "type": "text", "version": 759, "versionNonce": 1037004615, "isDeleted": false, "id": "0Z2AD5xnd4bUAS3ryDS-y", "fillStyle": "hachure", "strokeWidth": 2, "strokeStyle": "solid", "roughness": 0, "opacity": 100, "angle": 0, "x": 317, "y": 768, "strokeColor": "#000000", "backgroundColor": "transparent", "width": 86, "height": 24, "seed": 1308778217, "groupIds": [], "roundness": null, "boundElements": null, "updated": 1675590397122, "link": null, "locked": false, "fontSize": 20, "fontFamily": 1, "text": "server.py", "baseline": 17, "textAlign": "center", "verticalAlign": "middle", "containerId": "48sa_pFKMBlEU75p47EfA", "originalText": "server.py" }, { "type": "rectangle", "version": 836, "versionNonce": 1553419433, "isDeleted": false, "id": "JwMl3Y2Txi0Xx4W1iwNcq", "fillStyle": "hachure", "strokeWidth": 2, "strokeStyle": "solid", "roughness": 0, "opacity": 100, "angle": 0, "x": 236.5, "y": 804, "strokeColor": "#000000", "backgroundColor": "transparent", "width": 251, "height": 34.5, "seed": 1769513959, "groupIds": [], "roundness": { "type": 3 }, "boundElements": [ { "type": "text", "id": "5waxi9faL1bP3hACWhylM" } ], "updated": 1675590397122, "link": null, "locked": false }, { "type": "text", "version": 794, "versionNonce": 1422913127, "isDeleted": false, "id": "5waxi9faL1bP3hACWhylM", "fillStyle": "hachure", "strokeWidth": 2, "strokeStyle": "solid", "roughness": 0, "opacity": 100, "angle": 0, "x": 323.5, "y": 809, "strokeColor": "#000000", "backgroundColor": "transparent", "width": 77, "height": 24, "seed": 46215689, "groupIds": [], "roundness": null, "boundElements": null, "updated": 1675590397123, "link": null, "locked": false, "fontSize": 20, "fontFamily": 1, "text": "client.py", "baseline": 17, "textAlign": "center", "verticalAlign": "middle", "containerId": "JwMl3Y2Txi0Xx4W1iwNcq", "originalText": "client.py" }, { "type": "rectangle", "version": 890, "versionNonce": 322555785, "isDeleted": false, "id": "P1bp9Rfq5SwS130g34yi7", "fillStyle": "hachure", "strokeWidth": 2, "strokeStyle": "solid", "roughness": 0, "opacity": 100, "angle": 0, "x": 235.5, "y": 844, "strokeColor": "#000000", "backgroundColor": "transparent", "width": 251, "height": 34.5, "seed": 485157865, "groupIds": [], "roundness": { "type": 3 }, "boundElements": [ { "type": "text", "id": "cYs-xqat3zotKrKiW0d8F" } ], "updated": 1675590397123, "link": null, "locked": false }, { "type": "text", "version": 855, "versionNonce": 833849735, "isDeleted": false, "id": "cYs-xqat3zotKrKiW0d8F", "fillStyle": "hachure", "strokeWidth": 2, "strokeStyle": "solid", "roughness": 0, "opacity": 100, "angle": 0, "x": 278, "y": 849, "strokeColor": "#000000", "backgroundColor": "transparent", "width": 166, "height": 24, "seed": 746119975, "groupIds": [], "roundness": null, "boundElements": null, "updated": 1675590397123, "link": null, "locked": false, "fontSize": 20, "fontFamily": 1, "text": "client_browser.py", "baseline": 17, "textAlign": "center", "verticalAlign": "middle", "containerId": "P1bp9Rfq5SwS130g34yi7", "originalText": "client_browser.py" }, { "id": "rQhOqJTXTXy1a48aIPtoK", "type": "line", "x": 504, "y": 682, "width": 1, "height": 197, "angle": 0, "strokeColor": "#000000", "backgroundColor": "transparent", "fillStyle": "hachure", "strokeWidth": 2, "strokeStyle": "solid", "roughness": 0, "opacity": 100, "groupIds": [], "roundness": { "type": 2 }, "seed": 1950842537, "version": 308, "versionNonce": 474543721, "isDeleted": false, "boundElements": null, "updated": 1675590397123, "link": null, "locked": false, "points": [ [ 0, 0 ], [ -1, 197 ] ], "lastCommittedPoint": null, "startBinding": null, "endBinding": null, "startArrowhead": null, "endArrowhead": null }, { "id": "sYMUNY_UMw9YOE9QnlXCK", "type": "line", "x": 643, "y": 783, "width": 137, "height": 0, "angle": 0, "strokeColor": "#000000", "backgroundColor": "transparent", "fillStyle": "hachure", "strokeWidth": 2, "strokeStyle": "solid", "roughness": 0, "opacity": 100, "groupIds": [], "roundness": { "type": 2 }, "seed": 1527629801, "version": 371, "versionNonce": 1639366823, "isDeleted": false, "boundElements": null, "updated": 1675590397124, "link": null, "locked": false, "points": [ [ 0, 0 ], [ -137, 0 ] ], "lastCommittedPoint": null, "startBinding": null, "endBinding": null, "startArrowhead": null, "endArrowhead": null }, { "type": "text", "version": 290, "versionNonce": 1250967881, "isDeleted": false, "id": "hxakD1P7MVGXZlrSZ4IDZ", "fillStyle": "hachure", "strokeWidth": 2, "strokeStyle": "solid", "roughness": 0, "opacity": 100, "angle": 0, "x": 574.5, "y": 756, "strokeColor": "#c92a2a", "backgroundColor": "transparent", "width": 13, "height": 26, "seed": 987379943, "groupIds": [], "roundness": null, "boundElements": null, "updated": 1675590397124, "link": null, "locked": false, "fontSize": 20, "fontFamily": 1, "text": "=", "baseline": 18, "textAlign": "center", "verticalAlign": "top", "containerId": null, "originalText": "=" }, { "type": "text", "version": 309, "versionNonce": 377885639, "isDeleted": false, "id": "eYH-l8FqVPjaI-zP9pfMb", "fillStyle": "hachure", "strokeWidth": 2, "strokeStyle": "solid", "roughness": 0, "opacity": 100, "angle": 0, "x": 548, "y": 791, "strokeColor": "#000000", "backgroundColor": "transparent", "width": 80, "height": 26, "seed": 1676833191, "groupIds": [], "roundness": null, "boundElements": null, "updated": 1675590397124, "link": null, "locked": false, "fontSize": 20, "fontFamily": 1, "text": "one of...", "baseline": 18, "textAlign": "center", "verticalAlign": "top", "containerId": null, "originalText": "one of..." }, { "type": "text", "version": 335, "versionNonce": 191574057, "isDeleted": false, "id": "mDcIG5yl_8fiGlk6dlATR", "fillStyle": "hachure", "strokeWidth": 2, "strokeStyle": "solid", "roughness": 0, "opacity": 100, "angle": 0, "x": 914, "y": 740, "strokeColor": "#c92a2a", "backgroundColor": "transparent", "width": 140, "height": 26, "seed": 933322633, "groupIds": [], "roundness": null, "boundElements": null, "updated": 1675590397124, "link": null, "locked": false, "fontSize": 20, "fontFamily": 1, "text": "serve_forever", "baseline": 18, "textAlign": "center", "verticalAlign": "top", "containerId": null, "originalText": "serve_forever" }, { "type": "line", "version": 703, "versionNonce": 1359234343, "isDeleted": false, "id": "Ubb64XWlshf6YUbdArM9v", "fillStyle": "hachure", "strokeWidth": 2, "strokeStyle": "solid", "roughness": 0, "opacity": 100, "angle": 0, "x": 1600.5, "y": 785, "strokeColor": "#000000", "backgroundColor": "transparent", "width": 778, "height": 3, "seed": 1141088295, "groupIds": [], "roundness": { "type": 2 }, "boundElements": null, "updated": 1675590439635, "link": null, "locked": false, "startBinding": null, "endBinding": null, "lastCommittedPoint": null, "startArrowhead": null, "endArrowhead": null, "points": [ [ 0, 0 ], [ -778, -3 ] ] }, { "type": "rectangle", "version": 693, "versionNonce": 1729329735, "isDeleted": false, "id": "E0Uoo4aOU-71gi3MKCZ2Y", "fillStyle": "hachure", "strokeWidth": 2, "strokeStyle": "solid", "roughness": 0, "opacity": 100, "angle": 0, "x": 1176.5, "y": 160.5, "strokeColor": "#000000", "backgroundColor": "transparent", "width": 181, "height": 121, "seed": 713789705, "groupIds": [], "roundness": { "type": 3 }, "boundElements": [ { "type": "text", "id": "ui39Vh4hwmgLPRZz4n_UZ" } ], "updated": 1675589927345, "link": null, "locked": false }, { "type": "text", "version": 644, "versionNonce": 1638756777, "isDeleted": false, "id": "ui39Vh4hwmgLPRZz4n_UZ", "fillStyle": "hachure", "strokeWidth": 2, "strokeStyle": "solid", "roughness": 0, "opacity": 100, "angle": 0, "x": 1225.5, "y": 208.75, "strokeColor": "#000000", "backgroundColor": "transparent", "width": 83, "height": 24, "seed": 1115201543, "groupIds": [], "roundness": null, "boundElements": null, "updated": 1675589927345, "link": null, "locked": false, "fontSize": 20, "fontFamily": 1, "text": "stats.py", "baseline": 17, "textAlign": "center", "verticalAlign": "middle", "containerId": "E0Uoo4aOU-71gi3MKCZ2Y", "originalText": "stats.py" }, { "type": "diamond", "version": 1049, "versionNonce": 1678958759, "isDeleted": false, "id": "-Pstud5nkYt1YM31u2x_X", "fillStyle": "hachure", "strokeWidth": 2, "strokeStyle": "solid", "roughness": 0, "opacity": 100, "angle": 0, "x": 1172.5, "y": 301.5, "strokeColor": "#0b7285", "backgroundColor": "transparent", "width": 189, "height": 179, "seed": 921077737, "groupIds": [], "roundness": { "type": 2 }, "boundElements": [ { "type": "text", "id": "_Sg0_xkkkxDFDg2nCEEbZ" } ], "updated": 1675590333864, "link": null, "locked": false }, { "type": "text", "version": 1013, "versionNonce": 1132863817, "isDeleted": false, "id": "_Sg0_xkkkxDFDg2nCEEbZ", "fillStyle": "hachure", "strokeWidth": 2, "strokeStyle": "solid", "roughness": 0, "opacity": 100, "angle": 0, "x": 1191.5, "y": 378.75, "strokeColor": "#0b7285", "backgroundColor": "transparent", "width": 151, "height": 24, "seed": 1989478183, "groupIds": [], "roundness": null, "boundElements": null, "updated": 1675590333864, "link": null, "locked": false, "fontSize": 20, "fontFamily": 1, "text": "GlancesStats()", "baseline": 17, "textAlign": "center", "verticalAlign": "middle", "containerId": "-Pstud5nkYt1YM31u2x_X", "originalText": "GlancesStats()" }, { "type": "line", "version": 468, "versionNonce": 965934473, "isDeleted": false, "id": "NqgLCJSHOwjxpOyVPlWws", "fillStyle": "hachure", "strokeWidth": 2, "strokeStyle": "solid", "roughness": 0, "opacity": 100, "angle": 0, "x": 1268, "y": 307, "strokeColor": "#000000", "backgroundColor": "transparent", "width": 0, "height": 26, "seed": 780116681, "groupIds": [], "roundness": { "type": 2 }, "boundElements": null, "updated": 1675590338064, "link": null, "locked": false, "startBinding": null, "endBinding": null, "lastCommittedPoint": null, "startArrowhead": null, "endArrowhead": null, "points": [ [ 0, 0 ], [ 0, -26 ] ] }, { "type": "diamond", "version": 859, "versionNonce": 716072489, "isDeleted": false, "id": "cDntBigSar4I0WkyhIBAZ", "fillStyle": "hachure", "strokeWidth": 2, "strokeStyle": "solid", "roughness": 0, "opacity": 100, "angle": 0, "x": 1172.5, "y": 502.5, "strokeColor": "#c92a2a", "backgroundColor": "transparent", "width": 189, "height": 179, "seed": 13687943, "groupIds": [], "roundness": { "type": 2 }, "boundElements": [ { "type": "text", "id": "AEXGY1IDMBeCvoLaKio__" }, { "id": "NpkkDItD4vnSSVIkyLR5R", "type": "arrow" }, { "id": "Lm88UtXv6wAHHUhkhFctw", "type": "arrow" } ], "updated": 1675590352966, "link": null, "locked": false }, { "type": "text", "version": 807, "versionNonce": 766048263, "isDeleted": false, "id": "AEXGY1IDMBeCvoLaKio__", "fillStyle": "hachure", "strokeWidth": 2, "strokeStyle": "solid", "roughness": 0, "opacity": 100, "angle": 0, "x": 1216.5, "y": 579.75, "strokeColor": "#c92a2a", "backgroundColor": "transparent", "width": 101, "height": 24, "seed": 1453216617, "groupIds": [], "roundness": null, "boundElements": null, "updated": 1675590352966, "link": null, "locked": false, "fontSize": 20, "fontFamily": 1, "text": "self.stats", "baseline": 17, "textAlign": "center", "verticalAlign": "middle", "containerId": "cDntBigSar4I0WkyhIBAZ", "originalText": "self.stats" }, { "id": "futrrb24VLy0LwGgivfSn", "type": "line", "x": 1269, "y": 475, "width": 1, "height": 31, "angle": 0, "strokeColor": "#000000", "backgroundColor": "transparent", "fillStyle": "hachure", "strokeWidth": 2, "strokeStyle": "solid", "roughness": 0, "opacity": 100, "groupIds": [], "roundness": { "type": 2 }, "seed": 1916753063, "version": 191, "versionNonce": 1514098121, "isDeleted": false, "boundElements": null, "updated": 1675590368062, "link": null, "locked": false, "points": [ [ 0, 0 ], [ -1, 31 ] ], "lastCommittedPoint": null, "startBinding": null, "endBinding": null, "startArrowhead": null, "endArrowhead": null }, { "type": "text", "version": 299, "versionNonce": 113418695, "isDeleted": false, "id": "7_yYXmz-cljpM3XmXnwFz", "fillStyle": "hachure", "strokeWidth": 2, "strokeStyle": "solid", "roughness": 0, "opacity": 100, "angle": 0, "x": 1276.5, "y": 475, "strokeColor": "#000000", "backgroundColor": "transparent", "width": 13, "height": 26, "seed": 171440295, "groupIds": [], "roundness": null, "boundElements": null, "updated": 1675590363270, "link": null, "locked": false, "fontSize": 20, "fontFamily": 1, "text": "=", "baseline": 18, "textAlign": "center", "verticalAlign": "top", "containerId": null, "originalText": "=" }, { "type": "rectangle", "version": 854, "versionNonce": 1282611241, "isDeleted": false, "id": "zxj5BuGRA6gmOMpuytKOs", "fillStyle": "hachure", "strokeWidth": 2, "strokeStyle": "solid", "roughness": 0, "opacity": 100, "angle": 0, "x": 1376, "y": 159.5, "strokeColor": "#000000", "backgroundColor": "transparent", "width": 208, "height": 121, "seed": 176909769, "groupIds": [], "roundness": { "type": 3 }, "boundElements": [ { "type": "text", "id": "9o5H_Z0ZXJgjf4VhEnGzw" } ], "updated": 1675590082537, "link": null, "locked": false }, { "type": "text", "version": 823, "versionNonce": 973642471, "isDeleted": false, "id": "9o5H_Z0ZXJgjf4VhEnGzw", "fillStyle": "hachure", "strokeWidth": 2, "strokeStyle": "solid", "roughness": 0, "opacity": 100, "angle": 0, "x": 1392.5, "y": 208, "strokeColor": "#000000", "backgroundColor": "transparent", "width": 175, "height": 24, "seed": 1216474951, "groupIds": [], "roundness": null, "boundElements": null, "updated": 1675590082538, "link": null, "locked": false, "fontSize": 20, "fontFamily": 1, "text": "glances_curses.py", "baseline": 17, "textAlign": "center", "verticalAlign": "middle", "containerId": "zxj5BuGRA6gmOMpuytKOs", "originalText": "glances_curses.py" }, { "type": "diamond", "version": 1194, "versionNonce": 945697735, "isDeleted": false, "id": "_VvreiuDNX6NcogCsHFMV", "fillStyle": "hachure", "strokeWidth": 2, "strokeStyle": "solid", "roughness": 0, "opacity": 100, "angle": 0, "x": 1387, "y": 300.5, "strokeColor": "#0b7285", "backgroundColor": "transparent", "width": 189, "height": 179, "seed": 1816972457, "groupIds": [], "roundness": { "type": 2 }, "boundElements": [ { "type": "text", "id": "RQnWQ-OtQLeiQKaWp6Fgp" } ], "updated": 1675590333865, "link": null, "locked": false }, { "type": "text", "version": 1163, "versionNonce": 715460649, "isDeleted": false, "id": "RQnWQ-OtQLeiQKaWp6Fgp", "fillStyle": "hachure", "strokeWidth": 2, "strokeStyle": "solid", "roughness": 0, "opacity": 100, "angle": 0, "x": 1410.5, "y": 365.5, "strokeColor": "#0b7285", "backgroundColor": "transparent", "width": 142, "height": 48, "seed": 1697803879, "groupIds": [], "roundness": null, "boundElements": null, "updated": 1675590333865, "link": null, "locked": false, "fontSize": 20, "fontFamily": 1, "text": "GlancesCurses\nStandalone()", "baseline": 41, "textAlign": "center", "verticalAlign": "middle", "containerId": "_VvreiuDNX6NcogCsHFMV", "originalText": "GlancesCurses\nStandalone()" }, { "type": "line", "version": 625, "versionNonce": 1091550985, "isDeleted": false, "id": "fBPzn8itK0-ofbaaQP3QN", "fillStyle": "hachure", "strokeWidth": 2, "strokeStyle": "solid", "roughness": 0, "opacity": 100, "angle": 0, "x": 1481.5, "y": 309, "strokeColor": "#000000", "backgroundColor": "transparent", "width": 0, "height": 29, "seed": 272584585, "groupIds": [], "roundness": { "type": 2 }, "boundElements": null, "updated": 1675590342444, "link": null, "locked": false, "startBinding": null, "endBinding": null, "lastCommittedPoint": null, "startArrowhead": null, "endArrowhead": null, "points": [ [ 0, 0 ], [ 0, -29 ] ] }, { "type": "diamond", "version": 1000, "versionNonce": 817613513, "isDeleted": false, "id": "nHjJ_PGbRP1C54xcsONnl", "fillStyle": "hachure", "strokeWidth": 2, "strokeStyle": "solid", "roughness": 0, "opacity": 100, "angle": 0, "x": 1388, "y": 500.5, "strokeColor": "#c92a2a", "backgroundColor": "transparent", "width": 189, "height": 179, "seed": 298191239, "groupIds": [], "roundness": { "type": 2 }, "boundElements": [ { "type": "text", "id": "4q18wE4O-McviQYBPBssm" } ], "updated": 1675590352966, "link": null, "locked": false }, { "type": "text", "version": 958, "versionNonce": 567403079, "isDeleted": false, "id": "4q18wE4O-McviQYBPBssm", "fillStyle": "hachure", "strokeWidth": 2, "strokeStyle": "solid", "roughness": 0, "opacity": 100, "angle": 0, "x": 1430.5, "y": 577.75, "strokeColor": "#c92a2a", "backgroundColor": "transparent", "width": 104, "height": 24, "seed": 1553888873, "groupIds": [], "roundness": null, "boundElements": null, "updated": 1675590352966, "link": null, "locked": false, "fontSize": 20, "fontFamily": 1, "text": "self.screen", "baseline": 17, "textAlign": "center", "verticalAlign": "middle", "containerId": "nHjJ_PGbRP1C54xcsONnl", "originalText": "self.screen" }, { "type": "line", "version": 341, "versionNonce": 396097287, "isDeleted": false, "id": "K2am61VoMQBdemjmaY1_X", "fillStyle": "hachure", "strokeWidth": 2, "strokeStyle": "solid", "roughness": 0, "opacity": 100, "angle": 0, "x": 1482.5, "y": 475, "strokeColor": "#000000", "backgroundColor": "transparent", "width": 0, "height": 30, "seed": 460931239, "groupIds": [], "roundness": { "type": 2 }, "boundElements": null, "updated": 1675590372353, "link": null, "locked": false, "startBinding": null, "endBinding": null, "lastCommittedPoint": null, "startArrowhead": null, "endArrowhead": null, "points": [ [ 0, 0 ], [ 0, 30 ] ] }, { "type": "text", "version": 442, "versionNonce": 898007593, "isDeleted": false, "id": "o-2dvVa3qGN-ZtEGLbbxq", "fillStyle": "hachure", "strokeWidth": 2, "strokeStyle": "solid", "roughness": 0, "opacity": 100, "angle": 0, "x": 1491, "y": 474, "strokeColor": "#000000", "backgroundColor": "transparent", "width": 13, "height": 26, "seed": 1681244489, "groupIds": [], "roundness": null, "boundElements": null, "updated": 1675590363270, "link": null, "locked": false, "fontSize": 20, "fontFamily": 1, "text": "=", "baseline": 18, "textAlign": "center", "verticalAlign": "top", "containerId": null, "originalText": "=" }, { "type": "arrow", "version": 771, "versionNonce": 1605823785, "isDeleted": false, "id": "NpkkDItD4vnSSVIkyLR5R", "fillStyle": "hachure", "strokeWidth": 2, "strokeStyle": "solid", "roughness": 0, "opacity": 100, "angle": 0, "x": 1227.536826021261, "y": 647.4036780704577, "strokeColor": "#000000", "backgroundColor": "transparent", "width": 2.2278702768758194, "height": 132.47821261660965, "seed": 2085136617, "groupIds": [], "roundness": { "type": 2 }, "boundElements": null, "updated": 1675590352992, "link": null, "locked": false, "startBinding": { "elementId": "cDntBigSar4I0WkyhIBAZ", "focus": 0.4274591641778541, "gap": 2.3806234060035365 }, "endBinding": null, "lastCommittedPoint": null, "startArrowhead": null, "endArrowhead": "arrow", "points": [ [ 0, 0 ], [ 2.2278702768758194, 132.47821261660965 ] ] }, { "type": "arrow", "version": 818, "versionNonce": 1297651175, "isDeleted": false, "id": "Lm88UtXv6wAHHUhkhFctw", "fillStyle": "hachure", "strokeWidth": 2, "strokeStyle": "solid", "roughness": 0, "opacity": 100, "angle": 0, "x": 1310.527371847451, "y": 646.8414945083808, "strokeColor": "#000000", "backgroundColor": "transparent", "width": 2.2373244506859464, "height": 133.04039617868648, "seed": 987698825, "groupIds": [], "roundness": { "type": 2 }, "boundElements": null, "updated": 1675590352992, "link": null, "locked": false, "startBinding": { "elementId": "cDntBigSar4I0WkyhIBAZ", "focus": -0.45084771412902047, "gap": 4.767145239963185 }, "endBinding": null, "lastCommittedPoint": null, "startArrowhead": null, "endArrowhead": "arrow", "points": [ [ 0, 0 ], [ 2.2373244506859464, 133.04039617868648 ] ] }, { "type": "text", "version": 361, "versionNonce": 1517286249, "isDeleted": false, "id": "3d-5XlfL-DXIG63Prnbrl", "fillStyle": "hachure", "strokeWidth": 2, "strokeStyle": "solid", "roughness": 0, "opacity": 100, "angle": 0, "x": 1145.5, "y": 696, "strokeColor": "#000000", "backgroundColor": "transparent", "width": 69, "height": 26, "seed": 1263546985, "groupIds": [], "roundness": null, "boundElements": null, "updated": 1675590352966, "link": null, "locked": false, "fontSize": 20, "fontFamily": 1, "text": "update", "baseline": 18, "textAlign": "center", "verticalAlign": "top", "containerId": null, "originalText": "update" }, { "type": "text", "version": 398, "versionNonce": 994710439, "isDeleted": false, "id": "uNMRAmQ5fFPZz6Cn-WskG", "fillStyle": "hachure", "strokeWidth": 2, "strokeStyle": "solid", "roughness": 0, "opacity": 100, "angle": 0, "x": 1325, "y": 696, "strokeColor": "#000000", "backgroundColor": "transparent", "width": 64, "height": 26, "seed": 208532489, "groupIds": [], "roundness": null, "boundElements": null, "updated": 1675590352966, "link": null, "locked": false, "fontSize": 20, "fontFamily": 1, "text": "export", "baseline": 18, "textAlign": "center", "verticalAlign": "top", "containerId": null, "originalText": "export" }, { "type": "arrow", "version": 800, "versionNonce": 80715337, "isDeleted": false, "id": "GgJ0Au16dwqt1oMD4qRft", "fillStyle": "hachure", "strokeWidth": 2, "strokeStyle": "solid", "roughness": 0, "opacity": 100, "angle": 0, "x": 1484.235303701863, "y": 674.1181093129326, "strokeColor": "#000000", "backgroundColor": "transparent", "width": 0.47060740372603505, "height": 110.76378137413474, "seed": 2080294919, "groupIds": [], "roundness": { "type": 2 }, "boundElements": null, "updated": 1675590352966, "link": null, "locked": false, "startBinding": null, "endBinding": null, "lastCommittedPoint": null, "startArrowhead": null, "endArrowhead": "arrow", "points": [ [ 0, 0 ], [ -0.47060740372603505, 110.76378137413474 ] ] }, { "type": "text", "version": 416, "versionNonce": 674694855, "isDeleted": false, "id": "Rd0PFLBfIckxgEJHI0gYv", "fillStyle": "hachure", "strokeWidth": 2, "strokeStyle": "solid", "roughness": 0, "opacity": 100, "angle": 0, "x": 1491.5, "y": 700, "strokeColor": "#000000", "backgroundColor": "transparent", "width": 69, "height": 26, "seed": 1013327143, "groupIds": [], "roundness": null, "boundElements": null, "updated": 1675590352966, "link": null, "locked": false, "fontSize": 20, "fontFamily": 1, "text": "update", "baseline": 18, "textAlign": "center", "verticalAlign": "top", "containerId": null, "originalText": "update" }, { "id": "AJrOfZ3BWcGWx-phOFTM8", "type": "ellipse", "x": 1573, "y": 769, "width": 29, "height": 29, "angle": 0, "strokeColor": "#000000", "backgroundColor": "transparent", "fillStyle": "hachure", "strokeWidth": 2, "strokeStyle": "solid", "roughness": 0, "opacity": 100, "groupIds": [], "roundness": { "type": 2 }, "seed": 1997338857, "version": 65, "versionNonce": 1498437481, "isDeleted": false, "boundElements": [], "updated": 1675590469409, "link": null, "locked": false }, { "type": "ellipse", "version": 108, "versionNonce": 1598836359, "isDeleted": false, "id": "7MgSBEIoPRZ3PGYWt6ttF", "fillStyle": "hachure", "strokeWidth": 2, "strokeStyle": "solid", "roughness": 0, "opacity": 100, "angle": 0, "x": 1113.5, "y": 767.5, "strokeColor": "#000000", "backgroundColor": "transparent", "width": 29, "height": 29, "seed": 1598347879, "groupIds": [], "roundness": { "type": 2 }, "boundElements": [ { "id": "JoP4A7A2IwEAe9b7xarHX", "type": "arrow" } ], "updated": 1675590494704, "link": null, "locked": false }, { "id": "iVLKUce4Dj1p19ez2Kmis", "type": "line", "x": 1587, "y": 797, "width": 1, "height": 41, "angle": 0, "strokeColor": "#495057", "backgroundColor": "transparent", "fillStyle": "hachure", "strokeWidth": 2, "strokeStyle": "solid", "roughness": 2, "opacity": 100, "groupIds": [], "roundness": { "type": 2 }, "seed": 1678897063, "version": 23, "versionNonce": 625487017, "isDeleted": false, "boundElements": null, "updated": 1675590505143, "link": null, "locked": false, "points": [ [ 0, 0 ], [ -1, 41 ] ], "lastCommittedPoint": null, "startBinding": null, "endBinding": null, "startArrowhead": null, "endArrowhead": null }, { "id": "jR1l0tisTaLalG3_hgJdD", "type": "line", "x": 1586, "y": 837, "width": 462, "height": 0, "angle": 0, "strokeColor": "#495057", "backgroundColor": "transparent", "fillStyle": "hachure", "strokeWidth": 2, "strokeStyle": "solid", "roughness": 2, "opacity": 100, "groupIds": [], "roundness": { "type": 2 }, "seed": 1897784839, "version": 54, "versionNonce": 1411190375, "isDeleted": false, "boundElements": null, "updated": 1675590505143, "link": null, "locked": false, "points": [ [ 0, 0 ], [ -462, 0 ] ], "lastCommittedPoint": null, "startBinding": null, "endBinding": null, "startArrowhead": null, "endArrowhead": null }, { "id": "JoP4A7A2IwEAe9b7xarHX", "type": "arrow", "x": 1125, "y": 838, "width": 1, "height": 37, "angle": 0, "strokeColor": "#495057", "backgroundColor": "transparent", "fillStyle": "hachure", "strokeWidth": 2, "strokeStyle": "solid", "roughness": 2, "opacity": 100, "groupIds": [], "roundness": { "type": 2 }, "seed": 1949962409, "version": 20, "versionNonce": 1389277065, "isDeleted": false, "boundElements": null, "updated": 1675590505144, "link": null, "locked": false, "points": [ [ 0, 0 ], [ 1, -37 ] ], "lastCommittedPoint": null, "startBinding": null, "endBinding": { "elementId": "7MgSBEIoPRZ3PGYWt6ttF", "focus": 0.10247888787140157, "gap": 4.6049731745427955 }, "startArrowhead": null, "endArrowhead": "arrow" } ], "appState": { "gridSize": null, "viewBackgroundColor": "#ffffff" }, "files": {} } ================================================ FILE: docs/_static/glances-pyinstrument.html ================================================
================================================ FILE: docs/_templates/links.html ================================================

Useful Links

================================================ FILE: docs/aoa/actions.rst ================================================ .. _actions: Actions ======= Glances can trigger actions on events for warning and critical thresholds. By ``action``, we mean all shell command line. For example, if you want to execute the ``foo.py`` script if the last 5 minutes load are critical then add the ``_action`` line to the Glances configuration file: .. code-block:: ini [load] critical=5.0 critical_action=python /path/to/foo.py All the stats are available in the command line through the use of the `Mustache`_ syntax. `Chevron`_ is required to render the mustache's template syntax. Additionaly to the stats of the current plugin, the following variables are also available: - ``{{time}}``: current time in ISO format - ``{{critical}}``: critical threshold value - ``{{warning}}``: warning threshold value - ``{{careful}}``: careful threshold value Another example would be to create a log file containing used vs total disk space if a space trigger warning is reached: .. code-block:: ini [fs] warning=70 warning_action=python /path/to/fs-warning.py {{mnt_point}} {{used}} {{size}} .. note:: For security reasons, Mustache-rendered values are sanitized: the characters ``&&``, ``|``, ``>`` and ``>>`` are replaced by spaces before execution. This prevents command injection through user-controllable data such as process names, container names or mount points. As a consequence, **shell operators (pipes, redirections, command chaining) cannot be used directly in action command lines**. If your action requires pipes, redirections or chained commands, write a shell script and call it from the action instead. For example, to create a log file containing the total user disk space usage for a device and notify by email each time a space trigger critical is reached, create a shell script ``/etc/glances/actions.d/fs-critical.sh``: .. code-block:: bash #!/bin/bash # Usage: fs-critical.sh