CLI
Справочник команд monitor
Утилита monitor — единая точка управления установкой. Большинство lifecycle-команд требуют root (sudo).
Редакция от 15 июля 2026
monitor <command> monitor --help
CLI установлен в /usr/local/bin/monitor, читает конфиг из /opt/monitor/.env и compose из /opt/monitor/docker-compose.yml. Переопределить каталог: MONITOR_INSTALL_DIR=/path monitor status.
Diagnose — диагностика и информация
| Команда | Описание |
|---|---|
| status | Статус контейнеров (docker compose ps), URL, версия. Команда по умолчанию. |
| doctor | Полная самопроверка: Docker, .env, контейнеры, HTTP на портах, лицензия, диск, память, systemd. Exit code 1 при проблемах. |
| health | Быстрый probe для cron/мониторинга: контейнеры + HTTP. Exit 0 только если всё healthy. |
| stats | Live CPU / memory / network / IO по контейнерам monitor-* (docker stats). |
| info | Версия, каталог, порты, admin email, systemd, образы и размеры томов. |
| license | Состояние лицензии: customer, edition, expiry, fingerprint (из backend). |
| fingerprint | Отпечаток хоста для запроса ключа у вендора. |
| config | Печать .env с замаскированными секретами (PASSWORD, SECRET, TOKEN, KEY). |
| logs [service] [-f] | Логи (последние 200 строк). Без аргумента — все сервисы. Пример: monitor logs backend -f |
| support | Собрать tar.gz для поддержки: docker info, inspect, логи, doctor, masked .env. |
Poke around — отладка внутри контейнеров
| Команда | Описание |
|---|---|
| shell [service] | Интерактивная shell в контейнере (по умолчанию backend). |
| dbshell | psql в Postgres (POSTGRES_USER / POSTGRES_DB из .env). |
| redis | redis-cli в контейнере Redis. |
Data — резервное копирование
| Команда | Описание |
|---|---|
| backup [file] | pg_dump в gzip. Имя по умолчанию: monitor-db-YYYYMMDD-HHMMSS.sql.gz. Лицензия в отдельном томе — при переустановке на том же хосте ключ тот же. |
| restore <file> | Восстановление дампа (DESTRUCTIVE). Требует root и подтверждение yes. Перезапускает backend. |
Lifecycle — жизненный цикл
| Команда | Описание |
|---|---|
| start | docker compose up -d (sudo). |
| stop | docker compose down (sudo). |
| restart | down + up -d (sudo). После правок .env. |
| update <bundle.tar.gz> | Апгрейд на месте: проверка .sha256, распаковка, повторный install.sh. .env и тома сохраняются. |
| prune | Удалить образы MoniTOR от предыдущих версий + dangling layers. |
| version | Установленная версия из /opt/monitor/VERSION. |
| uninstall [--purge] | Удалить MoniTOR. Без --purge тома с данными остаются. С --purge — удаляется БД (необратимо, нужен backup). |
Примеры
sudo monitor start monitor status monitor logs backend -f monitor doctor monitor health && echo OK || echo FAIL monitor backup /var/backups/monitor-$(date +%F).sql.gz sudo monitor update ./monitor-bundle-1.1.0.tar.gz sudo monitor restart monitor support # → monitor-support-YYYYMMDD-HHMMSS.tar.gz
Cron: проверка здоровья
# /etc/cron.d/monitor-health — алерт если health != 0 */5 * * * * root /usr/local/bin/monitor health >/dev/null || logger -t monitor "health check failed"