К содержимому

Логи Supervisor: настройка вывода программ и проверка

Supervisor пишет два вида логов: собственный журнал службы и файлы stdout/stderr каждой программы. Настройка сводится к правке файла в /etc/supervisor/conf.d/, перечитыванию конфига и проверке, что вывод попадает в файл.

Руководство Cron 2 мин чтения

01Установите Supervisor

На чистом Ubuntu 24.04 пакета нет. Установите его из репозитория и убедитесь, что служба supervisor поднялась. Версия в 24.04 это 4.2.

bash
sudo apt update
sudo apt install -y supervisor
sudo systemctl status supervisor

02Создайте каталог для логов программы

Файл stdout_logfile открывает сам supervisord, поэтому каталог должен существовать до запуска программы. Создайте его и отдайте пользователю, от которого работает программа. Без каталога Supervisor не запустит процесс и напишет ERROR (spawn error).

bash
sudo mkdir -p /var/log/laravel-worker
sudo chown www-data:www-data /var/log/laravel-worker

03Опишите программу с перенаправлением вывода

Файл программы кладут в /etc/supervisor/conf.d/ с расширением .conf. Директивы stdout_logfile и stderr_logfile задают файлы вывода, redirect_stderr=true отправляет ошибки в тот же файл. stdout_logfile_maxbytes и stdout_logfile_backups включают ротацию, чтобы файл не рос бесконечно.

ini
[program:laravel-worker]
process_name=%(program_name)s_%(process_num)02d
command=/usr/bin/php /var/www/example.com/artisan queue:work --sleep=3 --tries=3
user=www-data
numprocs=2
redirect_stderr=true
stdout_logfile=/var/log/laravel-worker/worker.log
stdout_logfile_maxbytes=50MB
stdout_logfile_backups=5
stopwaitsecs=3600
autostart=true
autorestart=true

04Примените конфиг через supervisorctl

reread читает изменённые файлы, update запускает новые программы и перезапускает изменённые. Без этих двух команд supervisorctl status ответит ERROR (no such group).

bash
sudo supervisorctl reread
sudo supervisorctl update
sudo supervisorctl status

05Проверьте, что вывод пишется в файл

Посмотрите статус группы и хвост файла вывода. В RUNNING процессы работают, а в worker.log появляются строки от queue:work. Если статус FATAL Exited too quickly, причина лежит в этом же файле.

bash
sudo supervisorctl status laravel-worker:*
sudo tail -n 50 /var/log/laravel-worker/worker.log

06Читайте журнал самого Supervisor

Собственный журнал службы лежит в /var/log/supervisor/supervisord.log. В нём видны запуски, остановки и причины, по которым программа не поднялась. Ошибка unix:///var/run/supervisor.sock no such file означает, что служба не запущена, и её причину ищут в этом журнале.

bash
sudo tail -n 50 /var/log/supervisor/supervisord.log
sudo systemctl status supervisor

Частые ошибки

  • Supervisor отвечает unix:///var/run/supervisor.sock no such file.

    Служба не запущена. Проверьте sudo systemctl status supervisor и причину в /var/log/supervisor/supervisord.log.

  • Программа в статусе FATAL Exited too quickly (process log may have details).

    Команда падает сразу после старта. Смотрите её stdout_logfile: частые причины это неверный путь к artisan, нет записи в storage или ошибка в .env.

  • supervisorctl status выдаёт ERROR (no such group) после создания файла.

    Supervisor ещё не знает программу. Выполните sudo supervisorctl reread, затем sudo supervisorctl update.

  • Файл stdout_logfile не создаётся, процесс не стартует с ERROR (spawn error).

    Каталог для лога должен существовать до запуска. Создайте его и отдайте права пользователю из user=.

Deploykin

Как это делается в Deploykin

В Deploykin cron-задачи и демоны Supervisor создаются из панели: одиннадцать готовых расписаний или своё выражение, пресеты демонов для Horizon, очередей, планировщика и Reverb. Вывод задач пишется в лог и читается в панели.

7 дней бесплатно на тарифе Про, без привязки карты.

Вопросы и ответы

Где Supervisor хранит логи программ?

В файлах, указанных в stdout_logfile и stderr_logfile в конфиге программы. Если директивы не заданы, вывод уходит в файл по умолчанию из секции [supervisord], а при redirect_stderr=true ошибки попадают в stdout_logfile.

Чем отличается /var/log/supervisor/supervisord.log от лога программы?

supervisord.log это журнал самой службы: запуски, остановки, причины сбоев. Лог программы это её собственный вывод, который пишется в stdout_logfile.

Как перезапустить воркеры после деплоя?

php artisan queue:restart просит воркеры выйти после текущей задачи, и Supervisor поднимает их с новым кодом. Все процессы группы сразу перезапускает sudo supervisorctl restart laravel-worker:*.

Почему лог программы растёт без ограничений?

Не заданы stdout_logfile_maxbytes и stdout_logfile_backups. С ними Supervisor ротирует файл и хранит заданное число копий.

Ещё по теме

crontab: планировщик задач на сервере: все материалы темы

Мы используем cookies и сервис веб-аналитики «Яндекс Метрика» (включая Вебвизор) для улучшения работы сайта. Подробности — в политике конфиденциальности.