Вирішення проблем

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

Що показує діагностика

Діагностика — це найшвидший спосіб дізнатися причину несправності. Вона перевіряє:

• Чи ініціалізовано Агент.
• Чи доступний для запису файл конфігурації.
• Чи готовий клієнт шлюзу (WebSocket).
• Чи наявний і чи дійсний токен.
• Чи зареєстровано середовище підтвердження.
• Чи активна прив'язка вайтлисту.
• Чи доступні ендпоінти API та шлюзу з вашого сервера.

Щоб отримати повний звіт, виконайте:

Експорт створить файл diagnostics/latest.json у папці конфігурації плагіна. Надайте цей файл підтримці для детального розбору.

Шлюз не підключається

Симптом: Сайт показує, що Агент офлайн, або команда /leavepulse status повідомляє про помилку транспорту.

1. Перевірте звіт діагностики на наявність помилок у полях actionHint.
2. Якщо у конфігурації бракує gateway.ws_url, gateway.token або server_id, перепідключіть сервер за допомогою нового коду підключення з сайту.
3. Якщо діагностика показує помилку доступності мережі (network reachability), перевірте налаштування брандмауера (firewall) або DNS на вашому хостингу.

Токен відсутній або недійсний

Симптом: Діагностика повідомляє про missing token, malformed token, expired token або невідповідність server_id.

• Не копіюйте токен вручну з іншого сервера.
• Виконайте команду /leavepulse connect <код> ще раз, використовуючи свіжий код із налаштувань сервера на сайті.
• Якщо ви випадково поширили токен (наприклад, на скриншоті), негайно перепідключіть сервер, щоб згенерувати новий.

Конфлікт прив'язки середовища

Симптом: Команда підключення попереджає, що це середовище вже прив'язане до іншого сервера LeavePulse.

Це трапляється, якщо ви намагаєтеся використати один і той самий серверний процес для різних карток серверів на сайті. Переконайтеся, що ви підключаєте правильний сервер до правильної сторінки. Якщо ви хочете переприв'язати сервер, додайте confirm до команди підключення: