Provision
—— XP

Логи nginx и типовые ошибки

теория~7 минут+140 XP

В девяти случаях из десяти ответ на жалобу «сайт не работает» уже записан в логах nginx простым текстом — нужно только знать, куда смотреть. Логов два, оба в /var/log/nginx. В access.log одна строка на каждый запрос: кто пришёл, что просил, какой код получил. В error.log — только неприятности, от упавшего приложения до нехватки прав на файл.

Первый файл отвечает на вопрос «что случилось с этим запросом», второй — «почему». Чтобы разобраться с конкретной жалобой, смотрят оба, а код ответа подсказывает, в какую сторону копать. Цель урока — за пару минут понять, кто виноват: nginx, права на файлы или приложение за ним.

Строка access.log

Формат по умолчанию называется combined. Посмотрим на одну строку целиком: флаг -n 1 у tail показывает последнюю.

ubuntu@stand:~$
sudo tail -n 1 /var/log/nginx/access.log
ubuntu@stand:~$
203.0.113.7 - - [01/Oct/2026:12:04:11 +0300] "GET /api/items HTTP/1.1" 502 157 "-" "curl/8.5.0"
Что в строке
203.0.113.7
Адрес клиента.
[01/Oct/2026:12:04:11 +0300]
Время запроса с часовым поясом.
"GET /api/items HTTP/1.1"
Метод, путь и версия протокола.
502
Код ответа. Первая цифра 2 — успех, 3 — перенаправление, 4 — ошибка клиента, 5 — ошибка сервера.
157
Размер тела ответа в байтах.
"-" "curl/8.5.0"
Откуда пришёл клиент (Referer) и чем он пользуется (User-Agent).

Главное поле — код ответа. Чтобы следить за запросами в реальном времени, пока воспроизводишь ошибку, у tail есть флаг -f: он не выходит, а печатает новые строки по мере появления, остановить — Ctrl+C. А чтобы найти все ответы с ошибкой, хватает grep из раздела про Linux.

ubuntu@stand:~$
sudo grep '" 502 ' /var/log/nginx/access.log
ubuntu@stand:~$
203.0.113.7 - - [01/Oct/2026:12:04:11 +0300] "GET /api/items HTTP/1.1" 502 157 "-" "curl/8.5.0"

Кавычка и пробелы вокруг кода нужны, чтобы не поймать число 502 в размере ответа или в пути. Access.log отвечает на вопрос «что случилось», а «почему» — в соседнем файле.

error.log: причина простым текстом

В журнале ошибок одна строка на одно происшествие. Длинные строки удобнее читать по одной, снова флаг -n.

ubuntu@stand:~$
sudo tail -n 1 /var/log/nginx/error.log
ubuntu@stand:~$
2026/10/01 12:04:11 [error] 1202#1202: *31 connect() failed (111: Connection refused) while connecting to upstream, client: 203.0.113.7, server: stand.provision.internal, request: "GET /api/items HTTP/1.1", upstream: "http://127.0.0.1:8000/items"

Читать её стоит по частям. [error] — уровень важности. Дальше суть: connect() failed (111: Connection refused) — подключиться к приложению не вышло, порт никто не слушает. Потом подробности: какой клиент, какой сайт, какой запрос и, главное, upstream — точный адрес, куда nginx стучался. С таким адресом проверка занимает минуту: sudo ss -tlnp | grep 8000 покажет, слушает ли кто-нибудь порт. Без sudo колонка с процессом останется пустой.

Журнал растёт бесконечно, поэтому раз в сутки его переименовывает и сжимает системная программа logrotate: вчерашние строки лежат в access.log.1, более старые — в файлах .gz. Если в access.log пусто, загляни туда. Зная, где лежат оба журнала, остаётся научиться узнавать в них знакомые строки: у частых ошибок они повторяются слово в слово.

Типовые ошибки и где их причина

У каждого частого кода своя строка в error.log. Узнав её, ты сразу знаешь, что чинить.

КодЧто пишет error.logЧто чинить
403Permission denied или directory index is forbiddenПрава на файлы для www-data или нет index.html в каталоге
404open() … failed (2: No such file or directory) — или ничего, если 404 отдал try_filesПуть в root не совпадает с диском
413client intended to send too large bodyПоднять client_max_body_size, по умолчанию 1 МБ
502connect() failed (111: Connection refused)Приложение не запущено или слушает другой порт
504upstream timed out (110: Connection timed out)while reading — приложение думает дольше proxy_read_timeout; while connecting — пакеты до приложения не доходят

У 404 есть оговорка. Если путь не нашёл try_files … =404, как в нашем сайте, nginx считает это штатным ответом и в error.log ничего не пишет: запрос виден только в access.log. Строку open() failed дают только location без try_files.

Возьмём для примера строку про 403. В журнале написано open() "/var/www/provision/index.html" failed (13: Permission denied): файл есть, но пользователь www-data, от которого работают worker-процессы, не может его прочитать. Значит, чинить права на файл или на один из каталогов по пути, а не конфиг nginx. Для 403 бывает и вторая причина — directory index of "/var/www/provision/" is forbidden: в каталоге нет index.html, а показывать список файлов nginx по умолчанию не станет.

Отдельно стоит ошибка, при которой nginx вовсе не запускается: bind() to 0.0.0.0:80 failed (98: Address already in use). Порт уже занят другой программой — обычно вторым веб-сервером, например Apache. Её видно не в error.log, а в systemctl status nginx. Когда код неизвестен вовсе, помогает порядок действий.

Порядок поиска причины

Когда сайт «не открывается», не нужно гадать: проверяй снизу вверх, и каждый шаг отсекает половину вариантов. Это та же лестница, что в разделе про сети, только для nginx.

Сначала жив ли сам nginx: systemctl status nginx. Потом цел ли конфиг: sudo nginx -t. Затем слушает ли он нужный порт: sudo ss -tlnp | grep nginx (без sudo имени процесса не видно, и grep ничего не найдёт). Дальше что отвечает сайт: curl -I на адрес. И наконец почему: sudo tail -n 20 /var/log/nginx/error.log. Эти пять команд собраны в шпаргалку в последнем уроке раздела, а в практике ты сам сломаешь сайт тремя способами и найдёшь причину по ним.

Словарь урока

access.log
Журнал запросов: адрес клиента, время, запрос, код ответа, размер. ↩ к тексту
error.log
Журнал происшествий с причиной простым текстом: Connection refused, Permission denied, timed out.
код ответа
Три цифры в ответе сервера. 2xx — успех, 3xx — перенаправление, 4xx — ошибка клиента, 5xx — ошибка сервера. ↩ к тексту
logrotate
Системная программа, которая раз в сутки переименовывает и сжимает старые логи, чтобы они не заняли весь диск.

Что спросят на собеседовании

  • Сайт отдаёт 502. Ваши действия?
    Открыть error.log nginx и найти строку с upstream: там адрес приложения и причина. При Connection refused проверить, запущено ли приложение и слушает ли порт, через systemctl status и ss -tlnp.
  • Чем 502 отличается от 504?
    502 — до приложения не достучались или получили некорректный ответ. 504 — подключились, но не дождались ответа за proxy_read_timeout.
  • Откуда берётся 403 на свежем сайте?
    Обычно у www-data нет прав прочитать файлы или войти в каталог по пути, либо в каталоге нет index-файла. Причина и полный путь — в error.log.

Что дальше

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

Проверь себя+140 XPдве попытки
1
access.log
В строке access.log стоит «GET /api/items HTTP/1.1» 502 157. Что означает 502?
2
error.log
Пользователи видят 502. Где nginx пишет причину?
3
Типовые ошибки
В error.log «open() /var/www/site/index.html failed (13: Permission denied)». Какой код видит клиент?
4
Типовые ошибки
Загрузка файла на 5 МБ даёт 413. Что поправить?
ответь на все вопросы, чтобы проверить

Нашёл ошибку или непонятное место? Наведи на абзац — слева появится «+», нажми и напиши, что не так. Замечание увидит автор курса.Нашёл ошибку или непонятное место? Нажми «+» справа от заголовка раздела и напиши, что не так. Замечание увидит автор курса.