FAQ

Я потерял пароль

Сначала спросите другого администратора: в Settings → Users, Edit на вашей учётной записи задаёт новый пароль и показывает его один раз, а Reset 2FA в той же строке сбрасывает второй фактор, который вас блокирует. Это повседневный ответ — инстансу с двумя учётными записями администратора никогда не нужен остальной раздел этой страницы.

Когда никто больше не может войти, электронной почты для восстановления нет: запустите сервер один раз с DUMBMONIT_RESET_PASSWORD=1, заданной в docker-compose.yml:

    environment:
      DUMBMONIT_RESET_PASSWORD: "1"

Затем docker compose up -d.

Каждая учётная запись и каждая сессия удаляются при запуске, и интерфейс снова показывает /setup. Создайте первого администратора, затем запустите снова без этой строки (удалите её и снова выполните docker compose up -d). Мониторы, правила, каналы и настройки единого входа не затрагиваются.

Нет данных после добавления монитора

Дайте минуту: первая проверка выполняется с интервалом монитора (по умолчанию 60 с), а записи достигают VictoriaMetrics каждые 5 секунд (DUMBMONIT_FLUSH_INTERVAL_SECS). Затем:

1. Откройте страницу монитора и нажмите Probe now. Она сообщает, сколько образцов и рядов произвела одна проверка, либо точную ошибку.
2. Misconfigured с ошибкой под адресом — это проблема конфигурации: неверное community или пароль, отклонённый сертификат (включите «Accept an unverifiable certificate»), отсутствующая возможность. Это показывается, но не уведомляется.
3. Unreachable без ошибки означает, что монитор вообще не ответил. Для SNMP неверное community выглядит точно как выключенное устройство, потому что устройство никогда на него не отвечает. Проверьте community, что SNMP включён, и что устройство разрешает адрес сервера.
4. Проверьте, что контейнер может достичь монитора: сети Docker и файрволы — обычные виновники.

Ping говорит «ошибка конфигурации»

Монитору ping нужен сокет ICMP echo. Контейнер работает без каких-либо capabilities, поэтому файл Compose разрешает эти сокеты через sysctl net.ipv4.ping_group_range в сервисе dumbmonit: убедитесь, что строки sysctls: всё ещё там, затем docker compose up -d. См. Ping ICMP без capability.

Агент не появляется

• Установщик делает тестовую отправку перед запуском службы и останавливается с явной ошибкой, если URL или токен неверны. Исправьте /etc/dumbmonit/agent.yaml и перезапустите dumbmonit-agent.
• URL в команде установки — это тот, которым ваш браузер открыл UI. С отслеживаемой машины этот URL должен достигать сервера: curl https://server:8080/api/health оттуда это покажет.
• За обратным прокси /api/ingest должен перенаправляться, а тела до 16 МБ должны быть разрешены (client_max_body_size 16m в nginx).
• journalctl -u dumbmonit-agent -f показывает каждую отклонённую отправку. Сам токен никогда не появляется в журнале.
• Отозванный токен останавливает агента при следующей отправке; запустите установщик снова с новым токеном.

См. Агент Linux, macOS, FreeBSD и Windows.

Смена порта

Контейнер слушает на 8080; порт хоста — левая часть привязки в docker-compose.yml. Измените её и выполните docker compose up -d:

    ports:
      - "8099:8080"

Чтобы изменить порт внутри контейнера, задайте DUMBMONIT_BIND, например 0.0.0.0:9000, и скорректируйте привязку порта.

Почему оповещение «Advisory», когда правило говорит «warning»?

API хранит три уровня серьёзности: info, warning, critical. Интерфейс показывает их словами метеосводки: Info, Advisory, Warning. См. Уровни серьёзности.

Оповещение «Suppressed by parent»

У монитора есть родительский монитор, который не работает (недоступен или его проверка доступности завершается ошибкой), поэтому его собственные оповещения удерживаются, а не отправляются. Исправьте родителя; оповещения потомка сами сбросятся или сработают потом, без второго уведомления. См. Подавление по зависимости.

«Нетипичная CPU» никогда не срабатывает

Это сезонная базовая линия, которая молчит первые 14 дней для каждого ряда. В это время она только показывает, что бы она сработала. См. Обучение базовой линии.

Могу ли я использовать свою собственную VictoriaMetrics?

Да: задайте DUMBMONIT_VM_URL на её адрес (http://host:8428), и встроенная VictoriaMetrics не запускается. Каждая метрика с префиксом dumbmonit_, поэтому она может делить инстанс с другими инструментами. GET /api/health сообщает victoria.embedded: false после переключения.

Нужно ли DumbMonit быть доступным из интернета?

Нет. Он обращается к мониторам и к сервисам уведомлений; никто не обращается обратно, кроме агентов, которым нужно достичь URL сервера. Держите его в своей LAN или за VPN; если вы его раскрываете, используйте обратный прокси с TLS и задайте DUMBMONIT_COOKIE_SECURE=1.

Есть ли токен API?

Да. Settings → API & assistants создаёт токены dmt_… с областью read или write; отправляйте один как Authorization: Bearer dmt_… на любой маршрут, и cookie или заголовок CSRF не нужны. Тот же токен подключает ассистента через MCP. Токены никогда не управляют учётными записями, настройками входа или другими токенами. См. справочник HTTP API.