Перейти к содержимому

Добавьте первый монитор

Добавление чего угодно всегда работает одинаково: выберите тип из списка, справка справа объясняет, что подготовить на устройстве, и форма показывает только поля, важные для этого типа.

На совершенно новом инстансе обзорная страница не показывает пустую сводку: она показывает короткое руководство — добавьте первый монитор, подключите способ получать уведомления, проверьте, что сообщение доходит. Каждый шаг — это один клик, и каждый сам становится зелёным. Третий засчитывает только сообщение, которое действительно ушло из канала, поэтому создание канала без его проверки не отмечает этот шаг.

Руководство хранится на инстансе, а не в браузере: пропуск шага, или всего руководства, пропускает его в каждом браузере и для каждого пользователя. Оно навсегда исчезает, как только все три шага выполнены, и никогда не появляется на инстансе, у которого уже были мониторы и канал — обновление не вручает устоявшейся домашней лаборатории учебник.

SNMP — самый универсальный тип: почти всё сетевое оборудование говорит по нему. Коммутаторы, маршрутизаторы, NAS, ИБП и принтеры — обычные кандидаты.

  1. На устройстве включите SNMP v2c и запомните community только для чтения (public по умолчанию на многих устройствах). Если устройство фильтрует по адресу, разрешите адрес сервера DumbMonit.
  2. В DumbMonit откройте Monitors и нажмите Add a monitor (либо ++ctrl+k++ и введите «add»).
  3. Выберите SNMP device. Селектор сворачивается в одну строку, и форма показывает поля для SNMP.
  4. Введите имя, адрес (IP или имя хоста) и community. Для SNMP v3 переключите учётные данные на SNMP v3 и заполните имя пользователя и парольные фразы аутентификации и шифрования.
  5. Нажмите Add monitor.

Добавление устройства SNMP: форма слева, справка по настройке справа

Профиль сбора определяется автоматически по sysObjectID устройства, в фоне, так что форма никогда не ждёт недоступное устройство. Интерфейсы, а на серверах и NAS — CPU, память и хранилище, появляются в течение минуты.

Вместо того чтобы вводить мониторы по одному, просканируйте диапазон:

  1. На Add a monitor откройте панель Scan my network.
  2. Введите сеть в нотации CIDR, например 192.168.1.0/24 (до 4096 адресов за сканирование), и community для проверки каждого адреса (public по умолчанию).
  3. Каждый отвечающий адрес перечисляется с его sysName, описанием и профилем, который был бы применён. Мониторы, уже в DumbMonit, помечены Already added, а всё новое отмечено за вас.
  4. Снимите отметку с того, что не нужно, затем нажмите Add n monitors. Они создаются по одному, каждая строка показывает свой собственный результат, так что один отказ никогда не останавливает остальные.

Тот же поток, с учётными данными в двух полях вместо одного:

  1. В Proxmox создайте пользователя, зарезервированного для мониторинга, роль только для чтения и токен API — четыре команды pveum есть в справке рядом с формой, с кнопкой копирования для каждой, и на странице Proxmox VE. Никогда не используйте повторно учётную запись, которой вы сами входите.
  2. В DumbMonit: Add a monitor → Proxmox VE.
  3. Введите имя и адрес любого узла (порт 8006 по умолчанию).
  4. Скопируйте full-tokenid токена (dumbmonit@pve!monitor) в Token ID и его значение (UUID) в Secret. Вставили всю строку user@pve!name=secret в Token ID по ошибке? Форма разделяет её и сообщает об этом.
  5. Proxmox поставляется с самоподписанным сертификатом: отметьте Accept an unverifiable certificate в More options, если первая проверка на это жалуется.
  6. Нажмите Add monitor.

Proxmox Backup Server работает так же с proxmox-backup-manager; NAS Synology требует выделенную учётную запись DSM (имя пользователя и пароль); сервер с агентом вообще не требует учётных данных, только токен регистрации, показываемый один раз после сохранения монитора.

Каждый тип несёт собственную справку, написанную сервером и показываемую рядом с формой: пронумерованные шаги для выполнения на устройстве (создать пользователя только для чтения, создать токен API, разрешить адрес…), с точным путём в меню продукта и кнопкой копирования для каждой команды или значения, затем распространённая ошибка и ссылка на документацию производителя, когда она есть. Страницы для каждого типа в этой документации несут те же шаги слово в слово — тест на сервере держит их идентичными: SNMP, Proxmox VE, Proxmox Backup Server, Synology DSM, агент, сервисы.

Принцип, стоящий за каждой справкой: выделенная учётная запись только для чтения, никогда та, которой вы сами входите. Утёкший секрет мониторинга не должен быть способен что-либо изменить.

Независимо от типа, форма содержит:

ПолеЗначение
NameКак монитор отображается в списках и оповещениях.
AddressIP, имя хоста, host:port или URL в зависимости от типа; плейсхолдер показывает ожидаемую форму.
CredentialСемейства, которые принимает тип, каждое со своими полями: community, пользователь SNMP v3 и парольные фразы, токен Proxmox (Token ID + Secret), имя пользователя и пароль. У секретов есть глаз показать/скрыть, а вставленные значения очищаются от случайных пробелов, кавычек и разрывов строк. Хранится в зашифрованном виде, никогда не возвращается API: при редактировании пустые поля сохраняют то, что записано.
Check intervalКак часто DumbMonit читает монитор. По умолчанию 60 с, минимум 10 с.
Parent monitorЕсли родитель становится недоступен, оповещения этого монитора подавляются, а не отправляются. См. подавление по зависимости.
EnabledМонитор на паузе не проверяется и не вызывает оповещений.
TagsСвободные метки ключ/значение, копируются на каждый ряд как tag_<key>. Специфичные для типа опции тоже здесь, под More options.
  • Монитор появляется на странице Monitors как лицевая панель стойки: светодиод состояния, имя, тип, адрес, когда было замечено последний раз, и спарклайн.
  • Измерения записываются в VictoriaMetrics каждые 5 секунд (DUMBMONIT_FLUSH_INTERVAL_SECS), так что первый график появляется после первой проверки плюс несколько секунд. Probe now на странице монитора форсирует проверку и сообщает, сколько образцов и рядов она произвела: это основной инструмент диагностики.
  • Встроенные правила оповещений применяются сразу: монитор недоступен, CPU насыщен, диск почти заполнен, и так далее. Ничего настраивать не нужно.
  • Чтобы получать уведомления, добавьте канал уведомлений в Settings → Notifications & reports. Встроенные правила уведомляют каждый включённый канал.