Подключение кассы Sigma к мониторингу — инструкция инженеру

Коротко

Ставим на кассу 2 приложения (VPN + агент мониторинга) и вписываем настройки —

касса появляется в Zabbix. Всё качается и показывается с одной страницы:

https://kassa.gruppa-alfa.ru

• ✅ Новые кассы (Android 8/13) — рабочий путь (через NetBird).
• ⏳ Старые кассы (Android 7) — пока НЕ подключаем (ждём настройку WireGuard-хаба).

Перед началом

1. Посмотреть версию Android: Настройки → О системе/О планшете.
2. Придумать имя кассы по схеме magazin<N>-kassa<M> — латиница, без пробелов.

Примеры: magazin5-kassa1, magazin6-kassa2.

Подключение (делается на самой кассе)

Шаг 1. Открыть портал. В браузере кассы зайти на https://kassa.gruppa-alfa.ru,

ввести имя кассы, выбрать версию Android, нажать «Подключить кассу».

Шаг 2. Установить 2 приложения (кнопки на странице).

• Android 7: заранее включить Настройки → Безопасность → Неизвестные источники.
• Android 13: при установке нажать «Разрешить установку из этого источника».

Шаг 3. Настроить VPN.

• Новая касса (NetBird): открыть NetBird → ввести Management URL и Setup key

со страницы → Connect → разрешить запрос на VPN-соединение.

• Старая касса (WireGuard): импортировать скачанный .conf → включить туннель.

*(пока не используется — см. «Статус».)*

Шаг 4. Настроить агент мониторинга. Открыть «Unofficial Zabbix Agent»:

• Server / ServerActive = 10.0.0.10
• Hostname = как показано на странице (sigma-<имя>)
• включить Active checks, сохранить.

Шаг 5. Снять энергосбережение для NetBird и агента:

Настройки → Батарея/Приложения → Без ограничений. На Android 13 — обязательно,

иначе приложения «засыпают» и мониторинг отваливается.

Шаг 6. Проверить на месте. В NetBird статус Connected; агент показывает,

что отправляет данные.

После подключения (делает админ)

1. Zabbix: создать хост sigma-<имя> в группе «Sigma POS» с шаблоном

«Template Sigma POS», интерфейс/тип — активный агент.

1. Через 2–5 минут: Zabbix → Monitoring → Hosts — хост зелёный, идут данные.
2. (NetBird) новая касса видна пиром в группе cashiers на https://vpn.gruppa-alfa.ru.

Если не работает

• NetBird не подключается — поставить свежий клиент из Google Play

(ссылка есть на странице портала); проверить интернет на кассе.

• Касса «оффлайн» в Zabbix — проверить, что VPN включён и не отвалился;

снять энергосбережение; Hostname в агенте должен совпадать с именем хоста

в Zabbix точь-в-точь.

• APK не ставится — включить «Неизвестные источники» (Шаг 2).
• Триггер «приложение не запущено» всегда срабатывает — уточнить имя пакета

кассового приложения (Настройки → Приложения) и передать админу (правит макрос

{$KASSA_PKG} в шаблоне).

Справочник

Что	Адрес
Портал онбординга	https://kassa.gruppa-alfa.ru
Админка портала (только админ)	https://kassa.gruppa-alfa.ru/admin?token=…
Zabbix (из сети/через VPN)	http://10.0.0.10/zabbix
Дашборд NetBird	https://vpn.gruppa-alfa.ru
Схема имени хоста	sigma-<магазин>-<касса>

Статус путей

• ✅ Android 8/13 → NetBird — готово, подключаем.
• ⏳ Android 7 → WireGuard — НЕ подключать, пока админ не настроит WG-хаб (VM100).

Страница конфиг сгенерирует, но касса не соединится.