Как настроить логирование ошибок PHP в ISPManager 6

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

Какие логи есть в ISPmanager 6

Логи сайтов:

1. access.log (журнал доступа) — фиксирует все запросы к сайту: IP‑адрес посетителя, время запроса, тип запроса (GET/POST), код ответа, объём переданных данных и т. д.
2. error.log (журнал ошибок) — содержит сведения об ошибках сервера и скриптов (PHP, Apache и др.): проблемные файлы, номера строк кода, описания ошибок (например, PHP Fatal error, 404 Not Found).

Логи панели управления (доступны под пользователем root):

• ispmgr.log — основной лог панели;
• backupctl-ispmgr.log — лог резервного копирования;
• longtask.log — лог длительных операций;
• pkg.log — лог установки ПО.

Где найти логи в ISPmanager 6

Логи сайтов (access.log и error.log):

1. Перейдите в раздел «Мониторинг и журналы», «Журналы WWW‑запросов».
2. Выберите нужный сайт и откройте файл двойным кликом или через контекстное меню.
3. Физически хранятся в директории /var/www/имя_пользователя/data/logs/.

Логи панели управления:

1. Откройте «Менеджер файлов» от имени root.
2. Перейдите в /usr/local/mgr5/var/
3. Основные архивы после ротации — в /usr/local/mgr5/var/logs/

Как настроить логирование

Для сохранения ошибок в полной мере первое, что нужно сделать - включить опции log_errors и вывод всех ошибок в настройках необходимой версии PHP в панели. Ошибки PHP записываются в журнал веб-сервера по пути /var/www/httpd-logs/%ИМЯ_САЙТА%.error.log. Этот журнал доступен для просмотра в разделе Сайты.

В консоли

Журналы ошибок PHP можно найти в директории конкретного обработчика, например:

1. Для PHP 7.4 в режиме модуль Apache, журнал будет расположен по пути /var/log/apache2-isp-php74/error.log
2. Для PHP 8.3 в режиме PHP-FPM, журнал будет расположен по пути /var/log/php8.3-fpm.log
3. В качестве альтернативы, возможно создать и настроить собственный журнал для ошибок PHP. 

В первую очередь создаем файл для журнала ошибок по пути /var/log/php_errors.log и и указываем корректные права для него:

touch /var/log/php_errors.log
chown www-dаta:www-data /var/log/php_errors.log
chmod 664 /var/log/php_errors.log

После этого в файле конфигурации нужной версии PHP по пути /opt/php%ВЕРСИЯ_PHP%/etc/php.ini включаем журналирование ошибок в директиве log_errors и указываем путь до журнала для директивы error_log. 

После внесения изменения, перезапустите обработчик и веб-сервер с помощью команд:

systemctl restart php%ВЕРСИЯ_PHP%
systemctl restart nginx #если PHP работает на Nginx
systemctl restart apache2 #если PHP работает на Apache

Например, для версии PHP 8.1 необходимо изменить файл по пути /opt/php81/etc/php.ini и перезагрузить обработчик следующей командой:

systemctl restart php81

Особенности работы с логами

Ротация выполняется автоматически при достижении размера 100 МБ (по умолчанию). Архив помещается в специальную папку и сжимается.

Анализ error.log позволяет:

• определить тип ошибки (например, PHP Warning или PHP Fatal);
• найти проблемный файл и строку кода;
• отследить клиентский IP и время возникновения ошибки.

Доступ к логам панели имеет только администратор (root), что повышает безопасность.

Практические советы

1. Для быстрой диагностики проблем с сайтом всегда проверяйте error.log — там будет точная причина сбоя.
2. Если лог быстро растёт, проверьте период ротации и лимит архивов, чтобы не исчерпать дисковое пространство.
3. Для детальной отладки панели управления временно установите уровень логирования 9 в debug.conf, затем верните к стандартному (обычно 5–6).

Используйте Awstats для наглядной статистики по трафику и ошибкам — он строит графики и таблицы на основе access.log.