ВведениеLink to Введение

В статье описана настройка мониторинга r_keeper_7 через систему Zabbix. Мониторинг позволяет отслеживать метрики и уведомлять о превышения критических значений показателей.

Система мониторинга состоит из 2 частей:

  • Сервера Zabbix
  • Агентов Zabbix

Агенты необходимо установить на каждый компьютер, на котором хотите что-либо мониторить. 

Минимальная совместимая версия r_keeper_7 — 7.06.04.

Определения и сокращенияLink to Определения и сокращения

  • Триггер — настраиваемая реакция системы на событие
  • Хост — объект мониторинга

Схема работыLink to Схема работы

Возможности системыLink to Возможности системы

В данный момент можно мониторить:

  • Версии модулей системы
  • Тип модулей системы. Может иметь значения:
    • Сервер справочников
    • Сервер отчетов
    • Станция обслуживания
  • Сетевое имя компонента

В статье описана базовая настройка взаимодействия r_keeper_7 с Zabbix.  Т.е. корректные настройки R-Keeper 7 и Zabbix должны открыть канал передачи метрик

Планируемые обновленияLink to Планируемые обновления

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

Примеры триггеров:

  • Число файлов в очереди выгрузки в БД SQL стало больше 10
  • Число файлов в очереди на отправку на сервер уровнем выше стало больше 10
  • Количество ошибок при выгрузке данных в БД SQL стало больше 0

Примеры метрик

  • Метрики по сборку данных смен / онлайн данных
  • Метрики по процессам синхронизации справочников
  • Метрики по бизнес операциям (среднее время чека / работа систем лояльности и т. д.)
  • Метрики по мониторингу доступности компонентов (основной / резервный принтеры)

Настройка ZabbixLink to Настройка Zabbix

Для мониторинга вам понадобится сервер Zabbix. Есть версии только под Linux, скачать можно здесь: https://www.zabbix.com/ru/download. Инструкции по установке находятся там же. 

Дальше по тексту подразумевается, что сервер уже установлен и работает.

Установка агентаLink to Установка агента

На каждый компьютер системы r_keeper 7 требуется установить агент Zabbix. Скачать его можно здесь: https://www.zabbix.com/ru/download_agents. Мы рассматриваем установку на Windows.

Запустите файл установки агента и следуйте указаниям. Согласитесь с лицензионным соглашением.


Укажите IP-адрес компьютера, на который устанавливаете агент в поле Host name. Укажите адрес Zabbix-сервера в поле Zabbix server и порт, который он слушает. Рекомендуем поставить галочку Add agent location to the PATH, чтобы удобнее было проверять работу агента через консоль.


Выберите путь и компоненты установки, нажмите Next и Install.


В результате агент установится и будет отсылать данные на сервер.

Настройка r_keeper 7Link to Настройка r_keeper 7

Для настройки мониторинга, необходимо настроить INI-файлы r_keeper 7. В каждом желаемом модуле отдельно.

Откройте INI-файл нужного сервера и добавьте в него записи:

[ZABBIX] 
; Имя / IP адрес сервера Zabbix (интерфейс: Zabbix Trapper) 
ZabbixAt = "172.22.10.152" 
; Собственное имя на сервере Zabbix: т. е. имя данного хоста (несколько модулей могут быть на одной машине и иметь разные имена) 
SelfName = "199995181-REP-01"
XML

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

1. Сервер справочников

[ZABBIX]
ZabbixAt = "172.22.10.152"
SelfName = "199995181-REF-00"
XML

2. Сервер отчетов

[ZABBIX]
ZabbixAt = "172.22.10.152"
SelfName = "199995181-REP-01"
XML

3. Кассовый сервер

[ZABBIX]
ZabbixAt = "172.22.10.152"
SelfName = "199995181-MID-01"
XML

4. Кассовая станция

[ZABBIX]
ZabbixAt = "172.22.10.152"
SelfName = "199995181-POS-01"
XML

Если требуется запустить службу на нестандартном порту, то в ini-файлах к IP-адресу добавьте порт с ключом "-p". Например:

ZabbixAt = "192.168.15.15" "-p" "10055"

Сохраните INI-файлы и перезапустите серверы. 

Настройка ZabbixLink to Настройка Zabbix

Импорт шаблонаLink to Импорт шаблона

Скачайте файл шаблона по ссылке или из приложенных файлов.

Откройте веб-интерфейс Zabbix. По умолчанию он находится по адресу http://IP-адрес сервера/zabbix.

Зайдите в систему. 

  • Логин — Admin
  • Пароль — zabbix

Перейдите в раздел Configuration > Templates и нажмите в правом углу кнопку Import. В списке шаблонов появится Template App R-Keeper 7. 

Выберите загруженный файл и снова нажмите кнопку Import.

Рекомендуем удалить ненужные шаблоны. Для этого отметьте их галочками и нажмите кнопку Delete внизу.

Создание хостовLink to Создание хостов

Чтобы создать хост, необходимо сначала создать группу. Для создания перейдите в Configuration > Host Groups и нажмите кнопку Create host group в правом углу .
Укажите название новой группы и нажмите Add

Теперь создайте сами хосты. 
Перейдите в Configuration > Host и нажмите Create host 

Заполните поля:

  • Host name — имя хоста. Разрешена только латиница без пробелов. Обязательно должно совпадать с именем, указанным в INI-файле сервера.
  • Visible name — отображаемое имя. Может содержать пробелы и русский язык
  • Groups — группа хостов
  • Agent interfaces — адрес Zabbix-агента. Укажите здесь IP и порт с r_keeper_7, который вы хотите мониторить
  • Остальные поля заполнять не нужно. 

Перейдите на вкладку Templates, нажмите Add и выберите в списке шаблон Template App R-Keeper 7, установленный ранее. Это действие можно сделать позже в массовом порядке.

Нажмите Select. Шаблон добавится к хосту. Нажмите кнопку Add, чтобы сохранить настройки хоста.

Хост появится в списке. Повторите действия для всех нужных хостов.

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

На этом настройка завершена, можно переходить к наблюдению. 

МониторингLink to Мониторинг

Перейдите в раздел Monitoring > Latest data. Укажите группу в поле Host groups и нажмите Apply. В списке ниже появятся данные мониторинга. В данный момент доступна только передача версий. В будуем количество метрик будет увеличено. 

Если нет данных в столбцах Last check и Last value, то значит, данные не приходят.

Решение проблемLink to Решение проблем

Для проверки передачи данных на сервер Zabbix следует использовать ручной запуск консольной утилиты zabbix_sender.exe, которая устанавливается вместе с агентом. Утилита отправляет заданные данные на сервер и вы можете их увидеть в мониторинге.
Откройте командную строку и запустите утилиту zabbix_sender:

C:\Program Files\Zabbix Agent\zabbix_sender.exe\zabbix_sender.exe -IP_сервера -s имя_хоста -k имя_метрики -o значение_метрики
XML

Значения ключей:

  • -z — IP-адрес сервера Zabbix
  • -s — имя хоста
  • -k — имя метрики
  • -o — значение метрики

В случае успешной передачи появится надпись processed: 1; failed: 0. В случае ошибок будет наоборот.

И отправленное значение метрики появится на странице мониторинга.

Описание метрикLink to Описание метрик

  • rk7.app.version: версия
    • Версия компонента, например:
      • 7.6.4.212
      • 7.6.5.113
  • rk7.app.appkind: тип ПО
    • Тип компонента, например:
      • Сервер справочников ({A0AB2F9D-BC5A-4B6F-8E31-F08EF59E2A31})
      • Станция обслуживания (POS) ({DA5D57BC-21C9-4DBD-B86F-F01B23B9862C})
  • rk7.app.netname: сетевое имя
    • Сетевое имя компонента в инфраструктуре r_keeper_7, например:
      • OA-02-MIDS-001
      • OA-02-CASH-001


Скачать шаблон для Заббикса:
zbx.templates.ru_.rk7_.basic_.xml