Работа с логами

Бэкенд-сервисы платформы Navixy всегда собирают логи во время работы. Эти логи содержат записи обо всех действиях, выполняемых Java-сервисами, а также об ошибках, возникающих в процессе работы платформы. Анализ логов является неотъемлемой частью процесса устранения неполадок.

Расположение логов

У всех трёх бэкенд Java-сервисов имеются собственные логи. Каталоги по умолчанию следующие:

Сервис	Linux	Windows
API-server	/home/java/api-server/log	C:\java\api-server\log
SMS-server	/home/java/sms-server/log	C:\java\sms-server\log
TCP-server	/home/java/tcp-server/log	C:\java\tcp-server\log

Указанные каталоги являются значениями по умолчанию, но на некоторых серверах логи могут храниться в пользовательском каталоге по запросу владельца инстанса. Для получения дополнительной информации проверьте Настройки хранения логов сервисов страницу.

Содержимое логов

Логи API-server являются первыми, которые следует анализировать при возникновении любых проблем, связанных с работой платформы в целом или отдельных функций. Если вы видите, что какой-либо API-запрос не выполняется (при интеграциях через API или в инструментах разработчика браузера), ищите в логе по заголовку или содержимому этого запроса. Если проблемы затрагивают конкретное устройство или группу устройств, выполняйте поиск по IMEI или ID этого устройства.

Логи SMS-server необходимо проверять при возникновении любых проблем с отправкой сообщений. Это относится как к SMS, так и к электронной почте (независимо от названия сервиса). Ищите проблемы по номеру телефона или адресу электронной почты.

Логи TCP-server содержат всю информацию, связанную с работой устройств, сетевыми подключениями и проверками лицензий. Здесь можно выполнять поиск по IMEI устройства, сетевому адресу или любым другим параметрам, связанным с проблемой.

Если вам известны обстоятельства, при которых происходит проблема, хорошая тактика — воспроизвести её и посмотреть, какие записи появятся в логах. Таким образом вы «поймаете» ошибку в момент её возникновения.

Полезные инструменты

Linux

Вы можете искать конкретные значения в логах с помощью команды grep . Таким образом вы увидите(те) запись(и) лога, содержащую(ие) искомое значение. Пример:

grep "12345678910" log.txt

Чтобы просматривать новые записи лога в реальном времени, используйте команду tail . Это особенно полезно, когда у вас есть возможность воспроизвести проблему.

tail -f log.txt

Чтобы просмотреть весь лог, используйте любой предпочитаемый текстовый редактор, например nano или vim.

Windows

Стандартный Блокнот в Windows не способен корректно обрабатывать большие текстовые файлы, поэтому не пытайтесь использовать его для просмотра логов — он просто зависнет. Вместо этого используйте любой сторонний продвинутый текстовый редактор.

Самые популярные редакторы для Windows:

• Notepad++

• Sublime Text

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