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

Система мониторинга - это централизованный контроль за состоянием приложения, автоматическое реагирование на события и техническая диагностика проблем через логи

Где находится

Раздел доступен по пути: "Система" → "События" / "Логи" / "Триггеры"

Пошаговое руководство

Шаг 1: Переход к разделу

В боковом меню выберите раздел "Система"
Внутри находятся три подраздела:
- События - просмотр и управление текущими инцидентами
- Логи - техническая диагностика и анализ проблем
- Триггеры - настройка автоматических реакций на события
Начните с раздела "События", чтобы оценить текущую ситуацию

Шаг 2: Работа с событиями

События - это инциденты, которые происходят в системе отеля: тревоги, запросы уборки, технические неисправности, мониторинг устройств

Просмотр списка событий

Выберите подраздел "События"
Откроется страница "События" ("Хронологическая лента системных событий за выбранный период") с таблицей

Столбцы таблицы:

Дата - когда произошло событие
TraceId - уникальный идентификатор для отслеживания цепочки связанных действий
Модуль - какой модуль системы отправил событие (MODBUS_SCHEDULER, FIAS и др.)
Статус - текущее состояние события:
- NEW - новое, требует внимания
- FINISHED - завершено
- CANCELED - отменено
Тип - категория события (например, ALARM, CLEANING, ZONE_CARD_POCKET)
Тип сущности - связанный объект системы
ID сущности - идентификатор связанной сущности

Просмотр деталей события

Нажмите на стрелку слева от строки нужного события
Строка развернётся, показывая подробности: точную дату с миллисекундами, сообщение события, кто создал событие (например, admin), а также повторно - статус, тип, ID

Поиск, фильтрация и обновление списка

Используйте поле "Поиск по TraceId" для быстрого поиска
Нажмите на значок фильтра (воронка) в правом верхнем углу для дополнительных фильтров: по модулю, сообщению, статусу, типу
Нажмите на шеврон рядом со значком обновления, чтобы включить "Автообновление" списка и задать интервал в секундах (например, 5 s)
Значок шестерёнки настраивает отображаемые столбцы таблицы

Шаг 3: Работа с логами системы

Логи - это технические записи для диагностики проблем, анализа ошибок и отслеживания работы системы

Просмотр логов

Выберите подраздел "Логи"
Откроется страница "Логи" ("Техническая лента записей для диагностики: уровни, модули, сообщения") с таблицей

Столбцы таблицы:

Дата - время создания лога
TraceId - уникальный идентификатор (одинаковый у связанных событий и логов)
Модуль - источник лога (например, NOTIFICATION, MB_DISCOVERY)
Статус - статус лога (обычно NEW)
Уровень - важность лога:
- ERROR - критическая ошибка
- WARN - предупреждение
- INFO - информационное сообщение
- DEBUG - отладочная информация
- TRACE - детальная трассировка
Тип сущности и ID сущности - связанные объекты

Анализ ошибок

В фильтрах выберите уровень ERROR
Проанализируйте самые частые ошибки
Используйте TraceId для поиска связанных событий и других логов
Нажмите на стрелку слева от строки, чтобы развернуть подробности, включая полное сообщение (например, EMAIL channel is unavailable: SMTP testConnection failed)

Поиск, фильтрация, автообновление и настройка столбцов работают так же, как в разделе "События"

Шаг 4: Настройка триггеров

Триггеры - это правила автоматической реакции системы на события. Когда событие определённого типа меняет статус, система проверяет триггеры и выполняет соответствующие действия

Просмотр существующих триггеров

Выберите подраздел "Триггеры"
Откроется страница "Триггеры" ("Правила автоматических реакций на события: условие → действие") с таблицей: Создан, Название, Тип, Статус, Действие, Приоритет
Используйте поиск по названию, чтобы быстро найти нужный триггер

Создание нового триггера

На странице "Триггеры" нажмите кнопку "+ Добавить триггер"
Справа откроется панель "Добавить триггер". Заполните:
- Активность: переключатель - включён по умолчанию

Шаг 1 - Базовые данные

- **Название:** введите уникальное понятное название (например, "Уведомление о тревоге") (обязательное поле)
- **Описание:** добавьте описание назначения триггера (опционально)

Шаг 2 - Когда срабатывать (условие)

- **Тип события:** выберите тип события из списка (обязательное поле, см. таблицу ниже)
- **Статус события:** выберите статус - `NEW`, `FINISHED` или `CANCELED` (опционально - если не указать, триггер реагирует на любой статус)
- **Приоритет:** выберите приоритет выполнения - Низкий, Нормальный (по умолчанию), Высокий, Критический

Шаг 3 - Что выполнить (действие)

- **Действие:** выберите действие из списка (обязательное поле):

    - `NOTIFY` - отправить уведомление выбранным пользователям
    - `ALERT` - показать всплывающее предупреждение в интерфейсе
    - `LOG_ONLY` - записать диагностическое сообщение в логи

Нажмите кнопку "Сохранить"

Типы событий, доступные при создании триггера:

Тип события	Описание
`ALARM`	Событие тревоги, тревожная кнопка
`TECH_ISSUE`	Ошибки оборудования, сетевые сбои
`CLEANING_REQUEST`	Запрос на уборку от администратора, по выезду, по нажатию кнопки
`CLEANING`	Начало, завершение и контроль уборки с точки зрения ModBus устройства
`ZONE_CARD_POCKET`	Вставка/извлечение карты из энергосберегающего кармана номера
`GUEST_REQ`	Заселение, выселение, вызов персонала
`MAINTENANCE`	Плановая или внеплановая техническая работа
`ACCESS_CONTROL`	Выдача и возврат карт, действия с замками
`LICENSE_MANAGEMENT`	Истечение срока, регистрация, активация лицензий
`DEVICE_MONITORING`	Потеря связи, отключение, перезапуск оборудования
`ZONE_OPERATION`	Добавление, удаление, изменение параметров зоны

Редактирование триггера и изменение активности

В таблице триггеров найдите нужный триггер
Нажмите на значок "⋮" в конце строки и выберите "Редактировать"
В открывшейся панели справа внесите изменения - в том числе переключатель "Активность", если нужно включить или отключить триггер
Нажмите "Сохранить"

Удаление триггера

В таблице триггеров найдите нужный триггер
Нажмите на значок "⋮" в конце строки и выберите "Удалить"
Подтвердите удаление в диалоговом окне

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

Пример 1: Настройка уведомления о тревоге

Сценарий: при срабатывании тревоги (ALARM) отправлять уведомление администратору

Создайте триггер с названием "Уведомление о тревоге"
Тип события: ALARM
Статус события: NEW
Действие: NOTIFY
Приоритет: Высокий

Результат: при любой тревоге в отеле администратор получит уведомление

Пример 2: Автоматическое логирование завершённых уборок

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

Создайте триггер с названием "Лог завершённой уборки"
Тип события: CLEANING
Статус события: FINISHED
Действие: LOG_ONLY
Приоритет: Нормальный

Результат: все завершённые уборки автоматически фиксируются в логах

Пример 3: Предупреждение о неисправности оборудования

Сценарий: при потере связи с устройством показывать предупреждение

Создайте триггер с названием "Потеря связи с устройством"
Тип события: DEVICE_MONITORING
Статус события: NEW
Действие: ALERT
Приоритет: Высокий

Результат: при потере связи с любым устройством в интерфейсе появится всплывающее предупреждение

Возможные проблемы и решения

"События не отображаются"

Причины:

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

Решение:

Убедитесь, что модули (ModBus и др.) настроены на отправку событий
Проверьте подключение к базе данных

"Триггеры не срабатывают"

Причины:

Триггер отключён (переключатель "Активность" выключен)
Неправильно настроены тип события или статус
Ошибка при выполнении действия триггера

Решение:

Откройте триггер на редактирование и проверьте переключатель "Активность"
Проверьте настройки типа события и статуса
Проверьте логи мониторинга на наличие ошибок выполнения

"Много событий с одинаковым TraceId"

Причины:

Одно происшествие порождает несколько связанных событий - это нормальное поведение системы

Решение:

Используйте поиск по TraceId для группировки связанных событий
Анализируйте всю цепочку событий по одному TraceId

Важная информация

Каждое событие может иметь только один активный статус в текущий момент
TraceId позволяет отслеживать всю цепочку связанных событий и логов
Изменения в триггерах применяются сразу после сохранения
Статус события при создании триггера - необязательный параметр; без него триггер реагирует на любой статус выбранного типа события
Списки во всех трёх разделах (События, Логи, Триггеры) поддерживают автообновление с настраиваемым интервалом и настройку отображаемых столбцов