# Логи и диагностика ошибок в ISPmanager 6: где искать причину

> Где искать логи сайтов, панели и почты в ISPmanager 6: пути к файлам, коды ошибок Nginx и Apache, разбор PHP-ошибок и команды для диагностики проблем.

## Какие логи ведёт ISPmanager 6

Панель хранит три группы логов: логи веб-сервера по каждому сайту, логи самой панели и логи системных сервисов вроде почты и баз данных. Просмотр части логов доступен прямо в интерфейсе — раздел «Домены → сайт → Логи», но для глубокой диагностики удобнее смотреть файлы напрямую через консоль сервера.

Если ошибка возникла сразу после переключения веб-сервера, сначала проверьте связку — она описана в статье [связка Nginx и Apache в ISPmanager 6](https://www.zevshost.net/ru/kb/ispmanager6-nginx-apache/): часть ошибок 502 и 504 связана именно с настройками прокси.

## Где лежат логи сайтов на диске

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

| Лог | Путь | Что смотреть |
| --- | --- | --- |
| Access-лог Nginx | /var/www/user/data/logs/example.com.access.log | все запросы к сайту |
| Error-лог Nginx | /var/www/user/data/logs/example.com.error.log | ошибки веб-сервера |
| Error-лог PHP | /var/www/user/data/logs/example.com.php.error.log | ошибки и warning PHP |
| Лог панели | /usr/local/mgr5/var/ispmgr.log | действия администратора |

Замените example.com и user на реальные домен и логин пользователя — панель создаёт эти файлы автоматически при первом запросе к сайту.

## Как читать error-лог веб-сервера

Самый быстрый способ найти причину падения сайта — открыть последние строки error-лога сразу после воспроизведения ошибки:

```
tail -n 50 /var/www/user/data/logs/example.com.error.log
```

Чтобы следить за логом в реальном времени во время теста, используйте отслеживание с фильтром по коду ответа 500:

```
tail -f /var/www/user/data/logs/example.com.access.log | grep ' 500 '
```

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

## Частые коды ошибок и что они значат

Коды ответа веб-сервера — первая подсказка при диагностике.

- 502 Bad Gateway — Nginx не получил ответ от Apache или PHP-FPM, проверьте, запущен ли соответствующий процесс.
- 504 Gateway Timeout — бэкенд не успел ответить за отведённое время, обычно из-за долгого запроса к базе.
- 500 Internal Server Error — ошибка в коде сайта, детали смотрите в php.error.log.
- 403 Forbidden — не хватает прав на файл или запрещён доступ в конфиге веб-сервера.

## Диагностика ошибок PHP и баз данных

Если сайт отдаёт белый экран без текста ошибки, значит вывод ошибок PHP выключен в продакшене — это правильно с точки зрения безопасности, но неудобно при отладке. Временно включите вывод ошибок в тестовом окружении через настройки PHP для сайта, а не в общем php.ini сервера.

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

```
systemctl status mysql
tail -n 30 /var/log/mysql/error.log
```

## Диагностика на уровне самой панели

Если проблема не в сайте, а в самой панели ISPmanager 6 — например, интерфейс не открывается или зависает операция, — сначала проверьте лог демона панели и статус процесса:

```
systemctl status ihttpd
tail -n 100 /usr/local/mgr5/var/ispmgr.log
```

Повторяющиеся ошибки в этом логе после обновления панели — повод свериться с инструкцией [обновление ISPmanager 6: порядок и откат](https://www.zevshost.net/ru/kb/ispmanager6-obnovlenie-paneli/) и проверить, не осталась ли панель на промежуточной версии.

## Чек-лист диагностики от простого к сложному

Разбирайте проблему по шагам, не пытаясь охватить всё сразу.

1. Посмотрите код ошибки в браузере и access-лог сайта — это сузит область поиска.
2. Откройте error-лог веб-сервера и php.error.log за тот же момент времени.
3. Проверьте статус зависимых сервисов: PHP-FPM, MySQL, Apache при связке.
4. Если ошибка воспроизводится только в панели, посмотрите ispmgr.log и статус ihttpd.

Такой порядок экономит время: в девяти случаях из десяти причина видна уже на первом или втором шаге.

---

Источник: https://www.zevshost.net/ru/kb/ispmanager6-logi-diagnostika/