Как настроить Syslog-сервер?

Вопросы и ответы по серверу BOOCO Astra (v 2.x)

BOOCO может выступать в роли Syslog-сервера — это нужно для удаленной отладки панелей бронирования BOOCO.

Порядок настройки

Убедитесь, что порт 514 (udp) открыт на firewall сервера и не используется другими службами Linux.

Если сервер BOOCO запущен в docker-контейнере — убедитесь, что порт открыт в docker-compose.yml:

# Фрагмент docker-compose.yml
services:
  booco:
    ports:
      - '514:514' # <-- Syslog port!
      - '514/udp'

В настройках Журнала (файл debug.yml) включите настройки Syslog’а:

# Фрагмент debug.yml
syslog:
  port: 514
  enabled: true

Если порт отличается от 514, то убедитесь, что он открыт на сервере, в Docker’е и не используется другими сервисами.

На странице Журнал событий (Log) в BOOCO включите отображение отладочных сообщений. В строке поиска наберите syslog — BOOCO покажет только сообщения с этим ключевым словом.

💡

Примечание. В Linux для открытия портов меньше 1024 требуются привилегии root. BOOCO в продуктивной среде обычно запускается с привилегиями root, а в среде разработки — без них. Если у сервера недостаточно привилегий, то он выдаст ошибку Error: bind EACCES 0.0.0.0:514.

Сообщения в Журнале

Если Syslog-сервер включен и на панели бронирования включена удаленная отладка, то сообщения с панели будут отображаться в Журнале сервера с ключевым словом syslog и IP-адресом панели, с которого пришло сообщение.

Сообщения с панели выводятся с уровнем DEBUG — за исключением критических ошибок (это ошибки скриптов, которые не отображаются в Журнале самой панели).

Критические ошибки выводятся с уровнем ERROR.

Отладка Syslog-сервера

При успешном старте в Журнале выводится информационное сообщение: Syslog server bound on 514 port. При остановке сервера выводится сообщение: Syslog server stopped. Включить и выключить Syslog-сервер можно в любой момент, перезапуск сервера не требуется.

Если нужно, можете включить отладочные сообщения в debug.yml:

debug:
- syslog-server