Логи Supervisor: настройка вывода программ и проверка
Supervisor пишет два вида логов: собственный журнал службы и файлы stdout/stderr каждой программы. Настройка сводится к правке файла в /etc/supervisor/conf.d/, перечитыванию конфига и проверке, что вывод попадает в файл.
01Установите Supervisor
На чистом Ubuntu 24.04 пакета нет. Установите его из репозитория и убедитесь, что служба supervisor поднялась. Версия в 24.04 это 4.2.
sudo apt update
sudo apt install -y supervisor
sudo systemctl status supervisor
02Создайте каталог для логов программы
Файл stdout_logfile открывает сам supervisord, поэтому каталог должен существовать до запуска программы. Создайте его и отдайте пользователю, от которого работает программа. Без каталога Supervisor не запустит процесс и напишет ERROR (spawn error).
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 включают ротацию, чтобы файл не рос бесконечно.
[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).
sudo supervisorctl reread
sudo supervisorctl update
sudo supervisorctl status
05Проверьте, что вывод пишется в файл
Посмотрите статус группы и хвост файла вывода. В RUNNING процессы работают, а в worker.log появляются строки от queue:work. Если статус FATAL Exited too quickly, причина лежит в этом же файле.
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 означает, что служба не запущена, и её причину ищут в этом журнале.
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 ротирует файл и хранит заданное число копий.
Ещё по теме
- Руководство · Cron crontab guru: как читать формат crontab и настроить задание Разбираем формат crontab по полям, показываем команды crontab -e и crontab -l, проверку через syslog и типичные ошибки при настройке cron на Ubuntu 24.04.
- Руководство · Cron Настройка cron для Bitrix на Ubuntu 24.04 Как настроить cron для Bitrix на Ubuntu 24.04: таблица пользователя www-data, запуск агентов и почтовой очереди, полные пути, логи и проверка выполнения.
- Руководство · Cron Как настроить cron каждые 5 минут на Ubuntu 24.04 Как настроить задание cron каждые 5 минут на Ubuntu 24.04: строка crontab, полные пути, логирование вывода и проверка запусков по syslog.
- Руководство · Cron Настройка crontab на Ubuntu 24.04: от расписания до проверки Пошаговая настройка crontab на Ubuntu 24.04: синтаксис расписания, запуск скрипта каждый час, права www-data, проверка через syslog и типичные ошибки.
- Руководство · Cron Как настроить ежедневное задание cron на Ubuntu 24.04 Пошаговая настройка ежедневного задания cron на Ubuntu 24.04: строка crontab, полные пути, логирование, проверка запуска через syslog и journalctl.
- Руководство · Cron Логи crontab на Ubuntu 24.04: где искать и как читать Где лежат логи crontab на Ubuntu 24.04: grep CRON /var/log/syslog, journalctl, вывод задач. Настройка логирования, причины молчания и решение.