EMQX

EMQX — MQTT-брокер в облаке. Все ClientService клубов держат с ним persistent MQTT-соединение. Если PC «в сети» но «не в EMQX» — это важный сигнал.

Как проверить

EMQX Dashboard (URL в 1Password) — список активных клиентов, сообщений в сек.
Фильтруй по client_id — это обычно совпадает с device.id из CRM.

Типовые кейсы

ClientService стартанул, но не подключается к EMQX

Причины:

Токен невалиден → скрипт очистки Hash/Token + переактивация (см. PC офлайн).
Сеть блочит 1883/8883 — редко, но бывает в новых клубах с корпоративным firewall.
EMQX в облаке перегружен — глянь метрики.

Клиенты в EMQX есть, но heartbeat не летит

Скорее всего публикация топика зависла — на PC нужен рестарт ClientService.

Массовые дисконнекты

Если просадка активных клиентов 30%+ — это облачный инцидент. Немедленно в #dev. В gold-периоде такой кейс был: виджет не коннектился, чинился релизом.

Связь EMQX ↔ CRM

ClientService публикует heartbeat в EMQX → CRM подписан → обновляет статус устройства.
Если EMQX не получает heartbeat, CRM покажет «Offline».
CRM отправляет команды обратно — через EMQX же, топик command/<device_id>.

Доступ

Креды — в 1Password. Чтение дашборда разрешено всем в саппорте. Публиковать в топики вручную — только Artem C++ / Anton Mamonov.