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

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

## Які логи веде ISPmanager 6

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

Якщо помилка виникла одразу після перемикання веб-сервера, спершу перевірте зв'язку — вона описана у статті [зв'язка Nginx і Apache в ISPmanager 6](https://www.zevshost.net/uk/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/uk/kb/ispmanager6-obnovlenie-paneli/) та перевірити, чи не залишилася панель на проміжній версії.

## Чек-лист діагностики від простого до складного

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

1. Погляньте на код помилки в браузері та access-лог сайту — це звузить область пошуку.
2. Відкрийте error-лог веб-сервера і php.error.log за той самий момент часу.
3. Перевірте статус залежних сервісів: PHP-FPM, MySQL, Apache при зв'язці.
4. Якщо помилка відтворюється тільки в панелі, погляньте на ispmgr.log і статус ihttpd.

Такий порядок економить час: у дев'яти випадках із десяти причина видна вже на першому або другому кроці.

---

Джерело: https://www.zevshost.net/uk/kb/ispmanager6-logi-diagnostika/