Эксплуатация AlertWeb

Справочник для администраторов: какие процессы крутятся на панели и KVM-нодах, где лежат конфиги, как смотреть логи и проверять здоровье системы.

Архитектура процессов

Браузер ходит только на nginx панели. Агенты на нодах подключаются к API по gRPC (mTLS) на порт 9090.

Сервисы на панели (systemd)

sudo systemctl status alertweb-api alertweb-worker nginx
sudo systemctl restart alertweb-api alertweb-worker
sudo systemctl enable --now alertweb-api alertweb-worker

Сервисы на KVM-ноде

sudo systemctl status alertweb-agent libvirtd
sudo systemctl restart alertweb-agent

Каталоги на диске

Файлы конфигурации

Панель — /etc/alertweb/api.env

Основной конфиг API. Пример production (значения замените на свои):

ALERTWEB_HTTP_ADDR=:8080
ALERTWEB_GRPC_ADDR=:9090
ALERTWEB_MYSQL_DSN=alertweb:SECRET@tcp(127.0.0.1:3306)/alertweb?parseTime=true&charset=utf8mb4
ALERTWEB_JWT_SECRET=...длинный-секрет...
ALERTWEB_MIGRATIONS_DIR=/usr/share/alertweb/migrations
ALERTWEB_ISO_STORAGE=/var/lib/alertweb/iso
ALERTWEB_GRPC_TLS_CERT=/etc/alertweb/certs/server.pem
ALERTWEB_GRPC_TLS_KEY=/etc/alertweb/certs/server-key.pem
ALERTWEB_GRPC_TLS_CA=/etc/alertweb/certs/ca.pem
ALERTWEB_HTTP_READ_TIMEOUT=2h
ALERTWEB_HTTP_WRITE_TIMEOUT=2h

Панель — /etc/alertweb/worker.env

ALERTWEB_MYSQL_DSN=...тот же DSN...
ALERTWEB_JWT_SECRET=...тот же секрет...
ALERTWEB_WORKER_ID=worker-1
ALERTWEB_CONTROL_PLANE_GRPC=127.0.0.1:9090
ALERTWEB_GRPC_TLS_CERT=/etc/alertweb/certs/client.pem
ALERTWEB_GRPC_TLS_KEY=/etc/alertweb/certs/client-key.pem
ALERTWEB_GRPC_TLS_CA=/etc/alertweb/certs/ca.pem
ALERTWEB_GRPC_TLS_SERVER_NAME=alertweb-api

Нода — /etc/alertweb/agent.env

ALERTWEB_AGENT_NODE_UUID=...
ALERTWEB_AGENT_BOOTSTRAP_TOKEN=...
ALERTWEB_CONTROL_PLANE_GRPC=203.0.113.10:9090
ALERTWEB_HYPERVISOR_DRIVER=libvirt
LIBVIRT_DEFAULT_URI=qemu:///system
ALERTWEB_VM_DISKS_DIR=/vm
ALERTWEB_GRPC_TLS_CERT=/etc/alertweb/certs/client.pem
ALERTWEB_GRPC_TLS_KEY=/etc/alertweb/certs/client-key.pem
ALERTWEB_GRPC_TLS_CA=/etc/alertweb/certs/ca.pem
ALERTWEB_GRPC_TLS_SERVER_NAME=alertweb-api

mTLS — /etc/alertweb/certs/

• ca.pem — корневой CA
• server.pem / server-key.pem — сертификат API (gRPC server)
• client.pem / client-key.pem — worker и агенты (gRPC client)

nginx — /etc/nginx/conf.d/alertweb-panel.conf

Проксирует /api/ на 127.0.0.1:8080, отдаёт UI из /var/www/alertweb-ui. Для ISO-загрузок обязательно:

client_max_body_size 8g;
proxy_read_timeout 7200s;
proxy_send_timeout 7200s;

Сгенерировать черновик конфига можно из UI: GET /api/platform/settings/security/nginx (см. API).

Переменные API (справочник)

Переменные worker

Переменные agent (нода)

Лицензирование

В production релизах проверка лицензии включена через ALERTWEB_LICENSE_ENABLED=true.

Подробнее о поведении без ключа — в разделе Установка → Лицензия.

Журналы (логи)

AlertWeb пишет в journald (stdout/stderr процессов). Отдельных файлов в /var/log/alertweb/ на панели обычно нет.

# Панель
sudo journalctl -u alertweb-api -f
sudo journalctl -u alertweb-worker -f
sudo journalctl -u alertweb-api --since "1 hour ago" -p err

# Нода
sudo journalctl -u alertweb-agent -f

# nginx (доступ / ошибки прокси)
sudo tail -f /var/log/nginx/error.log

Логи jobs в UI и API

Детальные шаги фоновых задач (создание VM, миграция, distribute) хранятся в MySQL и доступны:

• В панели: Задачи → открыть job → шаги и лог
• API: GET /jobs/{uuid}/logs, GET /jobs/{uuid}/steps

Аудит действий пользователей: GET /audit (permission platform.audit.read).

Health и метрики

curl -fsS http://127.0.0.1:8080/health
curl -fsS http://127.0.0.1:8080/health/ready

nginx и WebSocket

• REST: https://panel.example.ru/api/... → API :8080
• VNC-консоль: wss://panel.example.ru/api/console/ws?vm=...&token=...
• UI: try_files → index.html (SPA)

Быстрая диагностика

В комплекте релиза — скрипт только для чтения (не меняет firewall и сеть):

sudo bash /opt/alertweb/deploy/almalinux/diagnose-alertweb.sh