Pinguva: руководство для пользователей

Система поддерживает четыре типа внешних проверок:

• HTTP — проверка сайта или API по адресу;
• TCP — проверка доступности порта;
• Ping — проверка сетевой доступности хоста;
• TLS — проверка срока действия TLS-сертификата.

Для внешних проверок в интерфейсе доступны:

• текущее состояние Up, Down, Paused, Pending;
• статистика доступности;
• история результатов;
• журнал инцидентов;
• ручной запуск проверки;
• пауза и снятие с паузы;
• окно обслуживания.

Важно для облачной версии SaaS: новые внешние проверки нельзя направлять на локальные и внутренние адреса вроде 127.0.0.1, localhost или приватные IP-диапазоны. Такие цели не относятся к публичному мониторингу и должны проверяться либо снаружи, либо через серверный агент внутри своей инфраструктуры.

Агентский мониторинг нужен для наблюдения за сервером изнутри. После подключения агента Pinguva показывает:

• имя сервера;
• операционную систему;
• IP-адрес;
• загрузку процессора;
• память;
• диски;
• время непрерывной работы;
• сетевой трафик;
• отклик до сервера;
• историю метрик.

Для Linux-агентов после обновления доступны и более глубокие блоки:

• Disk I/O с чтением, записью, IOPS, I/O busy и CPU iowait;
• контроль важных сервисов с состояниями running / stopped / failed;
• отдельные предупреждения по деградации дисковой подсистемы.

Для серверных агентов можно настраивать:

• уведомления о потере связи;
• пороговые уведомления по метрикам;
• задержку перед первым уведомлением;
• повторные напоминания.

Если авторизация включена, пользователь открывает страницу входа и вводит:

• адрес электронной почты;
• пароль.

После входа открывается основной экран системы.

Если регистрация включена, новый пользователь может создать аккаунт прямо на странице входа.

Для регистрации нужно указать:

• адрес электронной почты;
• пароль;
• название рабочего пространства.

После этого Pinguva отправляет на почту шестизначный код подтверждения.

Важно:

• код действует 10 минут;
• доступно не более 5 попыток ввода;
• повторная отправка доступна через 60 секунд;
• при повторной отправке старый код становится недействительным.

Если несколько раз подряд ввести неверный пароль при входе, Pinguva на короткое время ограничит новые попытки. Это дополнительная защита аккаунта от подбора пароля.

После подтверждения система автоматически:

• создаёт новый аккаунт;
• создаёт первое рабочее пространство;
• назначает пользователя владельцем аккаунта;
• переводит новый аккаунт на тариф Free;
• сразу выполняет вход.

Это главный экран системы. Здесь пользователь видит:

• общее число проверок;
• сколько объектов работают, недоступны или поставлены на паузу;
• среднюю доступность;
• список внешних проверок;
• список серверных агентов;
• быстрые действия по управлению мониторингом.

На этом экране можно:

• создать новую проверку;
• открыть страницу состояния;
• перейти к серверным агентам;
• переключить тему оформления;
• выбрать рабочее пространство.

Это отдельный раздел для контроля доменов. Он не смешивается с инцидентами доступности.

В разделе Домены можно увидеть:

• домен и связанные рабочие пространства;
• какие хосты и сколько проверок используют домен;
• источник появления домена: из существующих проверок, вручную или из обоих источников одновременно;
• регистратора;
• срок регистрации;
• состояние DNS;
• записи NS, MX, SPF, DMARC, A, AAAA, TXT, CAA.

Какие фильтры доступны

В разделе Домены можно отфильтровать список:

• по рабочему пространству;
• по строке поиска;
• по источнику домена;
• по состоянию домена.

Что можно делать с доменом

Для домена доступны два сценария:

• он подтягивается автоматически из существующих проверок;
• его можно добавить вручную, даже если проверок пока нет.

Если домен уже есть в проверках и его добавили вручную, система объединяет эти данные в одну карточку.

В подробной карточке домена можно:

• добавить или изменить заметку;
• посмотреть связанные проверки и перейти к их редактированию;
• задать ожидаемые NS;
• задать ожидаемые MX;
• включить или выключить проверку SPF и DMARC;
• включить или выключить контроль общего DNS;
• включить или выключить контроль почтового DNS;
• задать ручную дату окончания регистрации.

В развёрнутой строке домена можно быстро посмотреть:

• NS;
• MX;
• SPF;
• DMARC;
• A;
• AAAA;
• TXT;
• CAA.

Если выключить контроль почтового DNS, предупреждения по MX, SPF и DMARC формироваться не будут. Если выключить и контроль общего DNS, и контроль почтового DNS, домен будет отслеживаться только по сроку регистрации.

Откуда берётся срок регистрации

Система ищет срок регистрации в таком порядке:

1. RDAP;
2. публичный WHOIS-источник для доменов зоны .kz, если RDAP не дал результат;
3. WHOIS, если автоматический источник всё ещё не дал результат;
4. ручная дата окончания, если автоматический источник недоступен;
5. состояние Неизвестно, если срок определить не удалось.

В интерфейсе источник срока регистрации показывается явно:

• Автоматически (RDAP);
• Автоматически (публичный WHOIS);
• Автоматически (WHOIS);
• Вручную;
• Неизвестно.

Когда приходят напоминания о домене

Напоминания о скором окончании домена отправляются:

• за 60 дней;
• за 30 дней;
• за 14 дней;
• за 7 дней;
• за 3 дня;
• за 1 день;
• в день окончания.

Когда приходят уведомления по DNS

Чтобы система присылала уведомления о расхождении DNS-конфигурации, домен нужно открыть в подробной карточке и сохранить для него правила контроля.

Сейчас можно настроить:

• ожидаемые NS;
• ожидаемые MX;
• обязательность SPF;
• обязательность DMARC;
• контроль общего DNS домена;
• контроль почтового DNS.

Если правила не заданы, домен остаётся в инвентаре, но сравнение ожидаемых и фактических записей не выполняется.

Как читать состояние домена

• Исправно — срок регистрации и DNS выглядят нормально;
• Предупреждение — есть отклонения, но ситуация ещё не критична;
• Критично — срок близок к окончанию или есть серьёзное расхождение;
• Неизвестно — система не смогла получить нужные данные.

Это отдельный раздел для разовых и повторяющихся задач по дате. Он нужен там, где недостаточно только мониторинга и доменных предупреждений.

Примеры:

• оплатить почту;
• продлить домен;
• проверить резервные копии;
• согласовать работы с клиентом;
• подтвердить продление лицензии.

В напоминании можно задать:

• текст;
• заметку;
• дату и время;
• часовой пояс;
• рабочее пространство;
• правило повторения;
• за сколько дней предупредить заранее.

Какие повторы доступны

• без повтора;
• каждый день;
• каждую неделю;
• каждый месяц;
• каждый год.

Как устроен список

В верхней части страницы есть сводка:

• активные;
• на сегодня;
• просроченные;
• архив.

Сами напоминания можно отфильтровать:

• по рабочему пространству;
• по строке поиска;
• по состоянию.

Состояния:

• Запланировано;
• Сегодня;
• Просрочено;
• Архив;
• Ошибка.

Что можно делать с напоминанием

• создать новую запись;
• изменить существующую;
• завершить;
• отложить на 1 день;
• отложить на 7 дней;
• удалить.

Для раздела доступна отдельная настройка по умолчанию: за сколько дней заранее предупреждать о новой записи. Это значение подставляется при создании, но его можно поменять у каждого напоминания отдельно.

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

• разовое напоминание после выполнения уходит в архив;
• повторяющееся напоминание переносится на следующую дату;
• если отправка не удалась, запись остаётся в списке с состоянием Ошибка.

Как отправляются напоминания

Напоминания используют те же каналы доставки, которые уже включены для аккаунта и устройства:

• E-mail;
• веб-уведомления.

В этом разделе отображаются инциденты:

• когда началась проблема;
• какой сервис или агент её вызвал;
• была ли проблема уже закрыта;
• какой текст ошибки был зафиксирован.

Инциденты можно фильтровать отдельно:

• по внешним проверкам;
• по серверным агентам.

Раздел показывает журнал действий пользователей и системы. Он нужен для аудита и поддержки.

В журнал могут попадать:

• создание и удаление проверок;
• подключение и удаление агентов;
• изменения настроек;
• действия с рабочими пространствами и пользователями.

Pinguva умеет создавать внешние и внутренние страницы состояния. На них можно выводить:

• выбранные внешние проверки;
• выбранные серверные агенты;
• сервисы из одного или нескольких доступных рабочих пространств.

Страницы состояния полезны, если нужно:

• показать клиенту актуальный статус сервисов;
• сделать внутреннюю страницу состояния инфраструктуры;
• собрать отдельную страницу для критически важных сервисов.

Для тарифов Business и Enterprise доступен раздел Обслуживание.

Он нужен для ситуаций, когда сервис или сервер ожидаемо ведёт себя нестабильно, например:

• во время резервного копирования;
• во время миграции;
• во время плановых технических работ;
• во время внепланового ремонта.

В этом разделе можно настроить:

• плановое или внеплановое обслуживание;
• повторяющееся окно по дням недели;
• разовое окно с точным началом и окончанием;
• список конкретных внешних проверок и агентских серверов, для которых действует окно.

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

Если у вас несколько рабочих пространств, сначала выберите нужное в верхнем фильтре. После этого Pinguva покажет именно те внешние проверки и агентские серверы, которые относятся к выбранному пространству.

Во время активного окна обслуживания:

• алерты по выбранным внешним проверкам не отправляются;
• предупреждения по TLS для этих проверок тоже не отправляются;
• алерты по выбранным агентским серверам тоже не отправляются;
• сами проверки продолжают выполняться;
• агенты продолжают передавать телеметрию;
• история проверок и инцидентов не удаляется.

Это удобно, если вы заранее знаете о работах на конкретном сервере:

• обновление системы;
• перезагрузка после изменений;
• миграция базы данных;
• обслуживание дисков или сети.

В таком случае можно временно включить окно обслуживания именно для нужного агентского сервера и не получать лишние алерты, пока идут ожидаемые работы.

На тарифах Free и Pro этот раздел открывается в режиме предпросмотра.

Раздел Профиль — это рабочий экран аккаунта. В нём можно увидеть:

• текущий тариф;
• состояние оплаты;
• рабочие пространства;
• команду;
• настройки уведомлений;
• пороговые правила по агентам;
• время отправки уведомлений;
• историю обращений в поддержку;
• запрос на изменение тарифа.

В блоке Каналы доставки можно выбрать, как аккаунт будет получать уведомления.

В зависимости от тарифа доступны такие каналы:

• E-mail;
• Telegram;
• веб-уведомления.

Telegram доступен на тарифах Pro, Business и Enterprise. На Free этот канал не используется.

Как работает оплата по счёту и окончание тарифа

Если для аккаунта используется Оплата по счёту, Pinguva показывает дату, до которой оплачен текущий тариф.

Дальше система работает так:

• заранее напоминает о близком окончании оплаченного периода;
• в день окончания тарифа отправляет отдельное письмо владельцу аккаунта;
• после этого даёт 3 дня grace period на продление;
• если оплата не поступила, автоматически переводит аккаунт на Free.

Это помогает не потерять доступ к аккаунту неожиданно и даёт небольшое окно, чтобы спокойно продлить тариф без резкого обрыва.

Если автопереход всё же произошёл, причина будет понятна:

• владелец аккаунта получит письмо;
• в журнале действий появится запись о завершении оплаченного периода;
• там же будет видно, если аккаунт был автоматически переведён на Free.

Как подключить Telegram

Telegram подключается максимально просто и не требует искать chat_id или копировать служебные команды.

1. Владелец аккаунта открывает Профиль.
2. В блоке Каналы доставки нажимает Подключить Telegram.
3. Pinguva открывает бота в Telegram.
4. В боте достаточно один раз нажать Start.
5. После этого канал считается подключённым, и в профиле можно отправить тестовое сообщение или отключить Telegram.

Сейчас Telegram в Pinguva работает как личный чат аккаунта. Это удобно для быстрого старта: всё подключается в несколько кликов и без дополнительной ручной настройки.

Как отправить обращение команде Pinguva

В нижней части Профиля есть блок Обратная связь и поддержка.

Через него можно отправить:

• обычную обратную связь;
• предложение по улучшению;
• запрос в техподдержку.

Как это работает:

1. Откройте Профиль.
2. При необходимости выберите рабочее пространство, к которому относится вопрос.
3. Выберите тип обращения.
4. Опишите ситуацию или идею и отправьте сообщение.

После этого:

• сообщение уходит команде Pinguva;
• ответ приходит на почту, указанную в аккаунте;
• последние обращения и ответы сохраняются в этом же блоке профиля.

Поля, статусы и карточки в профиле оформлены одинаково в тёмной и светлой теме, поэтому разделом удобно пользоваться и на большом экране, и на обычном ноутбуке.

Это удобно, если нужно быстро написать по конкретному рабочему пространству, не переходя в почту и не объясняя заново, к какому аккаунту относится вопрос.

Как работают веб-уведомления

1. Владелец аккаунта открывает Профиль.
2. В блоке Каналы доставки включает веб-уведомления для аккаунта.
3. После этого каждый пользователь открывает свой Профиль на нужном устройстве и нажимает Подключить это устройство.
4. Браузер или установленное веб-приложение запрашивает разрешение на уведомления.

Важно помнить:

• одного включения канала для аккаунта недостаточно;
• каждый телефон, планшет и компьютер подключается отдельно;
• если вы вошли с нового устройства, его тоже нужно подключить;
• на iPhone и iPad обычно сначала нужно добавить Pinguva на экран «Домой», а потом разрешить уведомления;
• если сервер переносили в другой центр обработки данных или разворачивали на новой площадке, администратор должен сохранить те же VAPID-ключи, иначе существующие устройства придётся подключать заново.

Pinguva можно открыть на телефоне как обычную страницу в браузере или установить как веб-приложение на домашний экран.

В мобильной версии интерфейс упрощён:

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

Мобильная версия подходит для быстрого контроля состояния сервисов и просмотра статусов. Для глубокой работы с агентскими метриками лучше использовать версию для ПК.

Подходит для сайтов и API. Проверяет:

• доступность адреса;
• код ответа;
• при необходимости — наличие ключевого слова в ответе.

Подходит для проверки доступности порта, например host:5432 или host:22.

Проверяет, отвечает ли хост по сети.

Проверяет срок действия TLS-сертификата и предупреждает, если он скоро закончится.

У TLS-проверки есть два разных типа событий:

• предупреждение о скором окончании сертификата;
• полноценный инцидент, если сама проверка ушла в Down и потом восстановилась.

Для Linux Pinguva может сгенерировать готовую команду установки. Обычно достаточно:

1. Скопировать команду.
2. Выполнить её на сервере.
3. Дождаться, пока сервер появится в списке агентов.

Для Windows основной сценарий установки — через готовую команду PowerShell.

Она:

• скачивает архив с агентом;
• распаковывает его;
• запускает установку;
• регистрирует службу Windows;
• запускает агент.

Обычно пользователю нужно:

1. Открыть PowerShell от имени администратора.
2. Вставить сгенерированную команду.
3. Дождаться завершения установки.

После этого агент появляется в списке серверов и начинает отправлять метрики.

Для Linux система показывает команду удаления в оболочке.

Для Windows система показывает команду PowerShell, которая запускает uninstall.ps1 из каталога установки агента.

Для внешних проверок Pinguva может:

• отправлять письма при переходе в Down;
• отправлять письмо после восстановления;
• отдельно отправлять предупреждения о скором окончании TLS-сертификата.

Первое уведомление по внешней проверке отправляется не мгновенно. Базовая пауза перед первой рассылкой составляет 30 секунд, чтобы слишком короткие сбои не превращались в лишний шум.

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

Эта логика касается всех обычных каналов доставки аккаунта, включая E-mail, Telegram и веб-уведомления.

Если у самой платформы возникает общая проблема со связью и одновременно замолкают сигналы от агентов и внешних проверок, Pinguva временно подавляет массовую клиентскую рассылку. Когда нормальный обмен восстанавливается, уведомления возвращаются к обычному режиму.

Для агентов есть два основных контура уведомлений:

• потеря связи по служебным сигналам агента;
• пороговые уведомления, если метрики превышают заданные значения.

Для Linux-агентов после обновления появляются и дополнительные сценарии:

• alerts по важным сервисам;
• alerts по Disk I/O, если дисковая подсистема ведёт себя необычно или становится узким местом.

Потеря связи определяется по отдельному таймауту. Системное значение по умолчанию — 120 секунд без телеметрии. На Free и Pro действует фиксированное значение 120 секунд, а на Business и Enterprise его можно настраивать на уровне аккаунта.

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

Пороговые уведомления по агентам работают так:

• первое письмо отправляется не мгновенно, а после заданного времени удержания;
• если проблема сохраняется, напоминания могут приходить повторно;
• после восстановления приходит отдельное письмо о нормализации состояния.

Для Linux-агентов после обновления Pinguva может открывать ещё несколько типов событий:

• если важный сервис переходит в stopped или failed;
• если сервис потом возвращается в running;
• если зафиксирована аномальная активность диска;
• если I/O busy или CPU iowait держатся высокими и диск становится узким местом.

Такие события:

• появляются на карточке агента;
• записываются в журнал агента;
• попадают на страницу Инциденты;
• отправляются через обычные каналы уведомлений аккаунта.

Если настроен WEBHOOK_URL, приложение может отправлять уведомления во внешний адрес-приёмник.

• просматривать мониторинг;
• открывать инциденты;
• смотреть страницы состояния и серверные агенты;
• работать только в тех рабочих пространствах, к которым есть доступ.

• создавать и редактировать проверки;
• работать с агентами;
• создавать страницы состояния;
• управлять объектами назначенных рабочих пространств.

• управлять рабочими пространствами своего аккаунта;
• управлять пользователями команды;
• видеть оплату и профиль аккаунта;
• настраивать уведомления и лимиты, если это разрешает тариф.

Сейчас Pinguva ориентирована на облачный формат SaaS.

Для пользователей это означает:

• единый веб-интерфейс без отдельной локальной установки;
• готовую авторизацию, роли и рабочие пространства;
• подключение серверных агентов и работу с уведомлениями в рамках сервиса.

Если вашей компании нужен отдельный контур у себя, вариант on-premise / in-house можно обсудить отдельно по запросу.