Настройка ротации и хранения логов сервера

Задача и общий подход

Материал посвящён теме «Настройка ротации и хранения логов сервера» с акцентом на журналам, автоматизации и контролю изменений.

Журналы превращают предположения в проверяемые факты. По ним видно время запроса, код ответа, адрес клиента, задержку upstream и причину отказа службы.

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

Что должно получиться

После выполнения руководства по теме «Настройка ротации и хранения логов сервера» результат должен быть измеримым:

• зафиксировать логи и признаки успешного запуска
• сохранить резервную точку и понятный сценарий отката
• получить воспроизводимую конфигурацию, проверяемую командами
• исключить зависимость от временных правил и ручных действий

Когда применять этот порядок

Этот сценарий подходит для следующих ситуаций:

• плановое внедрение или перенос компонента категории «Логи» на новый VPS
• изменение портов, домена, сертификата, маршрута или способа публикации сервиса
• разбор инцидента, когда локальная и внешняя проверки дают разные результаты
• подготовка к обновлению пакета или восстановлению после неудачного изменения

Подготовка перед изменениями

Подготовительный этап снижает риск потерять доступ и смешать несколько причин одной неисправности.

• Проверьте свободное место, DNS и системное время.
• Подготовьте команду отката до применения изменений.
• Сохраните копии изменяемых файлов с датой и временем.
• Используйте встроенную проверку синтаксиса конфигурации.
• Зафиксируйте текущие порты, процессы и состояние службы.

Пошаговая настройка

Выполняйте блоки последовательно и после каждого шага проверяйте код возврата команды.

journalctl -u nginx --since '1 hour ago' --no-pager
journalctl -p warning..alert -n 100 --no-pager

awk '$9 ~ /^5/ {print}' /var/log/nginx/access.log | tail -n 50

awk '{print $1}' /var/log/nginx/access.log | sort | uniq -c | sort -nr | head

sudo du -sh /var/log/* 2>/dev/null | sort -h | tail
sudo journalctl --disk-usage

sudo logrotate -d /etc/logrotate.conf
sudo logrotate -f /etc/logrotate.d/nginx

Имена доменов, адреса, порты и пути в примерах условные. Перед выполнением замените их фактическими значениями.

Проверка результата

Проверка должна охватывать конфигурацию, процесс, listener и реальный запрос.

• время и юнит видны
• формат лога понятен
• logrotate без ошибок
• диск имеет запас
• новые записи идут в новый файл

systemctl is-active SERVICE
systemctl status SERVICE --no-pager
journalctl -u SERVICE -n 80 --no-pager
ss -lntup

Диагностика, если не заработало

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

1. Подтвердите симптом точной командой и запишите время.
2. Проверьте конфигурацию штатным тестом.
3. Проверьте процесс и последние записи журнала.
4. Убедитесь, что нужный адрес и порт слушаются.
5. Сравните локальный запрос с запросом извне.
6. Только затем проверяйте firewall, DNS и маршрут.
7. Меняйте одну переменную и повторяйте тот же тест.

Для темы «Настройка ротации и хранения логов сервера» важно не путать открытый firewall с запущенным сервисом: правило доступа не создаёт listener, а активный процесс не гарантирует доступность извне.

Как устроена схема

systemd-journald хранит сообщения юнитов, а приложения могут писать access- и error-файлы. Ротация должна корректно уведомить процесс, иначе он продолжит писать в старый inode.

Важно разделять конфигурацию, процесс, сетевой сокет и внешний запрос. Успех на одном уровне не доказывает исправность следующего.

Безопасность

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

• используйте принцип минимально необходимых прав
• закрывайте временные порты после завершения теста
• выдавайте файлам конфигурации минимальные права
• ограничивайте административный доступ доверенными IP или VPN
• не храните секреты в публикуемых конфигурациях и журналах

Дальнейшее сопровождение

Рабочая конфигурация со временем устаревает и требует контроля.

• документируйте нестандартные пути и зависимости
• периодически выполняйте тестовое восстановление
• храните резервную копию вне VPS
• после обновления повторяйте тест конфигурации и портов
• контролируйте таймеры, сертификаты и автоматические задания

Типичные ошибки

Чаще всего восстановление усложняют следующие действия:

• проверка только локального подключения без внешнего теста
• изменение нескольких компонентов одной командой без промежуточных тестов
• игнорирование различий правил IPv4 и IPv6
• открытие административного порта для всего интернета
• перезапуск службы до проверки синтаксиса
• использование устаревшей команды без проверки версии пакета

Откат изменений

Откат выполняется в обратном порядке и с теми же проверками, что использовались после настройки.

1. вернуть прежний log_format
2. проверить nginx -t
3. перезагрузить конфигурацию
4. не удалять активный лог вслепую

Не удаляйте неудачную конфигурацию до выяснения причины: она полезна для diff и разбора инцидента.

Контрольный список

Перед тем как считать тему «Настройка ротации и хранения логов сервера» закрытой, пройдите список:

Что дополнительно сверить в документации

При подготовке материала были сопоставлены разделы русскоязычной документации. Для углублённой проверки полезно изучить:

• Модуль ngx_http_log_module

Побочные эффекты и соседние компоненты

Изменение по теме «Настройка ротации и хранения логов сервера» может затронуть соседние части схемы: права файлов, DNS, firewall, reverse proxy, сертификаты, автоматические задания или порядок запуска. До работы перечислите эти связи и выберите по одной короткой проверке для каждой критичной зависимости.

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

Результаты регрессионной проверки записывайте теми же командами, которые использовались до изменения. Это делает сравнение объективным и помогает быстро доказать, что соседний компонент не пострадал.

• основной сервис отвечает тем же способом, что и до изменения
• административный доступ и аварийная консоль остаются доступны
• временные listeners и правила не заняли рабочие порты
• журналы не показывают новые повторяющиеся ошибки

Проверка синтаксиса и мягкое применение

Используйте встроенную команду проверки до reload или restart. Мягкое перечитывание предпочтительно, когда программа его поддерживает и изменение не требует полного перезапуска.

Сразу после применения проверяйте журнал и реальный запрос, а не только код возврата systemctl.

Изменяемый файл и итоговая конфигурация

Определите, какой файл действительно читает процесс и какие include или переменные дополняют его. Редактирование похожего, но неактивного файла создаёт ложное ощущение применения.

Сохраните diff и владельца файла. После автоматического обновления пакет может заменить шаблон или создать новый вариант рядом.

Границы задачи: Настройка ротации и хранения логов сервера

В этой статье рассматривается именно задача «Настройка ротации и хранения логов сервера», а не полная установка всех компонентов категории «Логи». Перед началом перечислите файлы, процессы, порты и внешние зависимости, которые реально входят в изменение.

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

Критерий отката для текущей задачи

Для темы «Настройка ротации и хранения логов сервера» заранее определите признаки неудачи: штатная проверка не проходит, процесс не запускается, ожидаемый listener исчез, внешний клиент получает неверный ответ или в журнале растёт число ошибок. После достижения лимита времени выполняйте откат, а не продолжайте добавлять неподтверждённые изменения.

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

• вернуть прежний log_format
• проверить nginx -t
• перезагрузить конфигурацию
• не удалять активный лог вслепую

Поэтапное применение обновления

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

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

Постоянство настройки после перезагрузки

Убедитесь, что параметр записан в постоянный файл, служба enabled, а временная команда shell не является единственным источником рабочего состояния.

Плановый reboot проводят только после создания резервной точки и подтверждения независимого административного доступа.

Анализ кодов и задержек веб-сервера

Для веб-сервиса полезно разделять код ответа Nginx и код upstream, а также полное время запроса и время ответа backend. Это позволяет отличить медленный клиент, прокси и приложение.

Создавайте отдельный расширенный log_format для диагностики, а после инцидента решите, нужен ли он постоянно: подробные журналы занимают больше места и могут содержать чувствительные URI.

awk '$9 ~ /^5/ {print $1, $7, $9}' /var/log/nginx/access.log | tail -n 50
grep -E 'upstream|timed out|permission denied' /var/log/nginx/error.log | tail -n 50

Источники и документация

Источники использованы для выбора терминов, контрольных вопросов и команд. Полные абзацы чужих публикаций не копируются.

• Модуль ngx_http_log_module