Логи Webasyst: как найти причину ошибки в магазине без FTP и программиста

Покупатель пишет, что не пришло письмо о заказе. Оплата прошла, а заказ висит неоплаченным. Выгрузка в Маркет перестала обновляться. В каждом из этих случаев ответ уже лежит на сервере, в логах. Но чтобы их открыть, обычно нужен FTP, доступ к хостингу и человек, который знает, где искать.

Бесплатное приложение «Логи» показывает все лог-файлы Webasyst прямо в бэкенде. Их можно открыть, найти нужную строку, скачать, отправить разработчику по защищённой ссылке и удалить лишнее. Ниже разберём приложение по шагам на примере магазина сумок и рюкзаков.

Что такое логи и зачем их смотреть

Логи представляют собой текстовые файлы, куда Webasyst, приложения и плагины записывают ошибки и важные события. Они лежат в папке wa-log на сервере. Каждая запись начинается с даты, времени и IP-адреса, дальше идёт текст ошибки.

Что обычно можно найти в логах магазина:

• Ошибки сайта. Необработанные исключения, «белые страницы», проблемы темы дизайна.
• Ошибки PHP. Предупреждения из плагинов и темы, если включено их логирование.
• Почта. Письма, которые не удалось отправить, и причина отказа.
• Задания по расписанию. Результаты запуска cron: выгрузки, рассылки, обслуживание.
• Оплата и доставка. Ответы платёжных и доставочных сервисов, если модуль ведёт свой лог.
• Плагины. Многие плагины пишут собственные логи, например выгрузка в Маркет или импорт.

Список лог-файлов

Главный экран показывает все лог-файлы. Для каждого указаны путь, размер и время последнего изменения. Справа вверху видно, сколько места занимают все логи вместе.

wa-magazin.ru

Список можно упорядочить тремя способами:

• По времени изменения. Свежие файлы сверху. Удобно, когда проблема случилась только что.
• По размеру. Самые тяжёлые файлы сверху. Удобно, когда логи начали занимать много места.
• По директориям. Файлы разложены по папкам, как на сервере.

wa-magazin.ru

В режиме «По директориям» первым пунктом идёт раздел «Действия пользователей». О нём ниже.

wa-magazin.ru

Как читать лог-файл

Кликните по файлу, и он откроется прямо в браузере. Записи подсвечиваются: дата, IP, тип ошибки и путь к файлу видны сразу. Большие файлы разбиты на страницы, а просмотр начинается с конца, где лежат самые свежие записи.

wa-magazin.ru

На панели над файлом собраны действия:

• скачать файл;
• переименовать;
• удалить;
• найти текст в этом файле;
• включить отслеживание изменений;
• создать публичную ссылку.

Поиск по файлу

Кнопка с лупой открывает поиск. Введите название плагина, номер заказа или адрес почты, и приложение подсветит все совпадения. Стрелки рядом с полем переключают между ними.

wa-magazin.ru

Разбор на примере: не уходят письма

Покупатели жалуются, что не получают письма о заказе. Открываем mail.log и видим одну и ту же ошибку: не удалось подключиться к почтовому серверу по порту 465.

wa-magazin.ru

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

По тому же принципу:

• Заказ не отметился оплаченным. Смотрите лог платёжного модуля: пришло ли уведомление от банка и приняла ли его система.
• Не считается доставка. В логе модуля доставки обычно видна ошибка ответа сервиса, например неверный ключ.
• Выгрузка или импорт работают не так. Откройте лог плагина: там часто перечислены пропущенные товары и причина.
• Белая страница или ошибка 500. Начните с error.log и php.log за нужное время.

Неудачные попытки входа

В разделе «Действия пользователей» есть журнал «войти не удалось». Для каждой попытки показаны дата, где пытались войти (бэкенд или сайт), логин, IP-адрес и приложение.

wa-magazin.ru

Если видите серию попыток войти в бэкенд под логином admin с одного адреса, это подбор пароля. Смените пароль, включите двухфакторную авторизацию и ограничьте доступ к бэкенду по IP.

Отправить лог разработчику

Разработчику плагина или поддержке часто нужен сам лог. Не обязательно скачивать и пересылать файл: кнопка с глобусом создаёт публичную ссылку. По умолчанию ссылка защищена паролем, его можно сменить или убрать.

wa-magazin.ru

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

Похожим образом можно поделиться конфигурацией PHP. Иконка «i» открывает её для просмотра и тоже позволяет включить публичную ссылку.

wa-magazin.ru

Отслеживание изменений

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

wa-magazin.ru

Настройки

В настройках приложения задаются полезные мелочи.

wa-magazin.ru

• Уведомление о большом размере. Когда все логи вместе превысят 1 ГБ, у иконки приложения появится красный индикатор.
• Логирование ошибок PHP. Ошибки пишутся в php.log. Чтобы не забить диск, логирование работает 1 час, потом его нужно включить снова. Если в системных настройках включён режим отладки, ограничения нет.
• Относительные пути и скрытие IP. Отдельно для опубликованных файлов и для бэкенда.

wa-magazin.ru

Логи и Логи+

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

Платная лицензия «Логи+» добавляет:

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

Для небольшого магазина обычно хватает бесплатной версии. Логи+ пригодится, когда плагинов много и логов десятки.

Как пользоваться логами без стресса

1. Поставьте приложение заранее, а не в день аварии.
2. Когда что-то сломалось, отсортируйте список по времени и откройте свежие файлы.
3. Ищите по номеру заказа, адресу почты или названию плагина.
4. Нашли ошибку, но не понимаете её? Отправьте разработчику публичную ссылку с паролем.
5. После разбора выключите ссылку и удалите старые большие логи.
6. Раз в месяц проверяйте общий размер логов и журнал неудачных входов.

На что обратить внимание

• Логи растут. Лог выгрузки или импорта может разрастись до сотен мегабайт. Удаляйте старые файлы, при следующей записи система создаст файл заново.
• В логах бывают личные данные. Адреса почты, IP, номера заказов. Не публикуйте ссылки без пароля и включите скрытие IP для опубликованных файлов.
• Режим отладки не для рабочего сайта. Он пишет в логи всё подряд и показывает технические ошибки. Включайте его только на время поиска проблемы.
• Пустой лог не всегда значит «всё хорошо». Некоторые модули ведут логи, только если в их настройках включена отладка.
• Удаление необратимо. Скачайте файл перед удалением, если он может понадобиться разработчику.

Частые вопросы

Приложение платное? Нет, «Логи» бесплатны. Платная только расширенная лицензия «Логи+».

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

Где смотреть, почему не уходят письма? В mail.log. Там видна причина отказа, например недоступный почтовый сервер или неверный пароль.

Как показать лог разработчику, не давая доступ к серверу? Создайте публичную ссылку с паролем и выключите её после разбора.

Как понять, что кто-то подбирает пароль? Откройте «Действия пользователей», журнал «войти не удалось». Много попыток с одного IP подряд явно говорят о подборе.

Итог

«Логи» дают администратору магазина то, что раньше было доступно только через FTP: все ошибки сайта, почты, оплаты, доставки и плагинов в одном окне бэкенда. Поиск по файлу, публичные ссылки с паролем и журнал неудачных входов помогают быстро найти причину проблемы и передать её тому, кто исправит. Поставьте приложение сейчас, чтобы в день аварии не искать доступы к хостингу.

Установить «Логи»

Нашли в логах ошибку, но не знаете, что с ней делать? Напишите нам в поддержку, разберёмся и исправим.