新加坡服务器用Supervisor管理进程,如何配置自动重启并检查运行日志

发布人:A5数据发布时间:2026-11-06 09:50阅读量:57

新加坡服务器上的应用已经由 Supervisor 托管后,日常维护通常集中在三件事:进程异常退出时能否按预期拉起、服务器重启后是否自动启动,以及出问题时能否从日志判断原因。下面以 Linux 上常见的 Supervisor 配置为例,说明如何调整已有进程配置并验证结果;不涉及从零安装应用或 Supervisor。

先确认现有服务与配置位置

修改前先确认 Supervisor 正在管理哪些进程,以及当前主配置文件和服务单元名称。不同发行版的路径和 systemd 单元名可能不同,不要仅凭经验覆盖配置。

sudo supervisorctl status
sudo systemctl list-unit-files | grep -E 'supervisor|supervisord'
ps -ef | grep '[s]upervisord'

Debian、Ubuntu 环境常见主配置文件为 /etc/supervisor/supervisord.conf,RHEL 系发行版中也可能使用 /etc/supervisord.conf。可从进程启动参数或服务单元确认实际路径:

sudo systemctl status supervisor
sudo systemctl status supervisord

其中一个单元不存在属于正常情况。检查主配置文件中是否包含程序配置目录,例如:

[include]
files = /etc/supervisor/conf.d/*.conf

也可能是其他目录或匹配规则。后续新增、修改程序配置时,应放在实际被包含的路径下。先备份将要编辑的文件;如果已有同名程序段,先检查其 command、运行用户和日志路径,避免重复定义。

sudo cp -a /etc/supervisor/conf.d/worker.conf \
  /etc/supervisor/conf.d/worker.conf.bak

若文件名或目录不同,按实际路径替换。备份只针对配置文件,不会保存应用数据或运行日志。

配置自动启动、异常重启和日志

以下示例适用于由 Python 启动的常驻任务进程。路径、用户名和程序入口需替换为服务器上的实际值。

[program:worker]
directory=/srv/app/current
command=/srv/app/current/venv/bin/python /srv/app/current/worker.py
user=app
autostart=true
autorestart=unexpected
exitcodes=0
startsecs=5
startretries=3
stopsignal=TERM
stopwaitsecs=20
stopasgroup=true
killasgroup=true
redirect_stderr=true
stdout_logfile=/var/log/myapp/worker.log
stdout_logfile_maxbytes=50MB
stdout_logfile_backups=5

关键配置的含义如下:

配置项作用与选择依据
autostart=trueSupervisor 启动时自动启动该程序。要让它随服务器开机运行,Supervisor 对应的 systemd 服务本身也必须设为开机启动。
autorestart=unexpected程序以非预期状态退出时尝试重启。搭配 exitcodes=0,正常退出码 0 不会被当成异常重启。
autorestart=true无论退出码是否正常都重启。适合必须持续运行的进程,但不适合执行完就应退出的批处理,否则可能反复运行。
startsecs=5进程启动后至少持续 5 秒才视为成功启动。若进程在此之前退出,Supervisor 会按启动失败处理。
startretries=3启动失败时的重试次数。持续失败后,状态可能变为 FATAL,需要检查原因并手动恢复。
stopasgroup、killasgroup停止程序时将信号发送给进程组,降低子进程遗留的可能性。适用于会派生子进程的程序。
redirect_stderr=true将标准错误合并到标准输出日志。启用后通常只需查看 stdout_logfile。

command 尽量使用绝对路径。Supervisor 不会自动执行交互式登录 shell,也不能依赖用户终端中的环境变量、虚拟环境激活脚本或别名。需要额外环境变量时,可在程序段中明确配置,例如:

environment=APP_ENV="production",LOG_LEVEL="info"

如果日志目录尚不存在,先创建目录并确认运行用户可写。只对应用日志目录授予所需权限,不要为了省事将整个应用目录改为所有用户可写。

sudo install -d -o app -g app -m 0750 /var/log/myapp
sudo -u app test -w /var/log/myapp && echo "日志目录可写"

stdout_logfile_maxbytes 和 stdout_logfile_backups 用于限制单个日志文件大小及保留的轮转副本数量。示例中单个文件达到 50MB 后轮转,并保留 5 份备份;这不是日志容量上限的精确承诺,实际磁盘占用还受轮转过程和其他日志影响。若程序日志量较大,应结合磁盘空间调整参数并定期检查磁盘使用情况。

应用配置并确认状态

先检查配置语法,再让 Supervisor 重新读取配置。不要直接重启整个 Supervisor 服务来应用单个程序变更,因为重启守护进程可能影响其管理的其他程序。

sudo supervisord -t -c /etc/supervisor/supervisord.conf

如果主配置文件路径不同,替换 -c 后的路径。语法检查通过后执行:

sudo supervisorctl reread
sudo supervisorctl update
sudo supervisorctl status worker

reread 会检查配置变化;update 会应用新增、删除或修改的程序配置。修改已有程序的配置后,Supervisor 可能停止并重新启动该程序,因此应在确认业务允许短暂中断时执行。操作前记录当前状态,并保留旧配置备份;如果更新后异常,可恢复备份,再执行 reread 和 update。

状态为 RUNNING 通常表示进程已持续运行超过 startsecs。若显示 STARTING,可稍等后再次检查;若显示 BACKOFF 或 FATAL,说明启动过程反复失败或超过重试次数,继续检查日志和程序依赖,而不是不断执行 restart。

还要检查 Supervisor 的 systemd 服务是否设为开机启动。先按实际存在的单元名核对:

sudo systemctl is-enabled supervisor
sudo systemctl is-enabled supervisord

如果对应服务已经启用,无需重复操作。若确认存在正确的单元但尚未启用,可执行:

sudo systemctl enable supervisor

在部分系统上单元名是 supervisord,应使用实际名称。该操作影响的是 Supervisor 守护进程的开机启动设置,不等同于立即重启应用。不要在未核对单元名称时执行。

检查运行日志与自动重启效果

先查看进程状态和最近的程序日志。以下命令中的 worker 必须与配置段 [program:worker] 的名称一致。

sudo supervisorctl status worker
sudo supervisorctl tail -100 worker
sudo supervisorctl tail -f worker

tail -100 查看最近内容,tail -f 持续跟踪输出,按 Ctrl+C 退出跟踪,不会停止被管理的进程。由于示例设置了 redirect_stderr=true,标准输出和标准错误会合并到 worker.log。如果没有合并,则需要分别查看输出与错误日志:

sudo supervisorctl tail -100 worker stdout
sudo supervisorctl tail -100 worker stderr

也可以直接检查配置中指定的日志文件:

sudo tail -n 100 /var/log/myapp/worker.log
sudo tail -f /var/log/myapp/worker.log

判断自动重启是否生效时,不要只看一次 RUNNING。应确认进程在超过 startsecs 后仍为运行状态,并结合日志检查应用是否完成初始化、是否持续输出错误。生产环境不建议用强制杀进程来验证自动重启;如果确有测试需要,应在维护窗口进行,并先确认该进程可以安全重启。测试结束后检查状态、日志和业务健康检查结果。

Supervisor 自身的服务日志可通过 systemd 查询,单元名按服务器实际情况替换:

sudo journalctl -u supervisor --since "30 minutes ago"
sudo journalctl -u supervisord --since "30 minutes ago"

程序日志用于判断应用内部错误;Supervisor 日志则更适合检查配置读取、启动失败、权限问题和进程状态变化。两者不要混为一谈。

检查运行日志与自动重启效果配图

A5idc数据提供新加坡物理服务器,涵盖不同CPU、存储及线路配置,可为常驻应用、接口服务和后台任务提供计算、磁盘与网络资源。对于由Supervisor管理的业务进程,服务器存储可承载程序运行日志;新加坡节点也为面向当地及周边地区的业务部署提供了资源选择。

常见异常与恢复方法

配置更新后显示 FATAL 或 BACKOFF

先查看进程日志及 Supervisor 状态,再核对命令路径、运行用户、工作目录和依赖文件是否存在:

sudo supervisorctl status worker
sudo supervisorctl tail -100 worker
sudo -u app test -x /srv/app/current/venv/bin/python
sudo -u app test -r /srv/app/current/worker.py

执行用户与配置中的 user 一致。若程序依赖环境变量,确认其已写入 environment;若依赖相对路径,确认 directory 指向预期目录。修正后重新读取并应用配置:

sudo supervisorctl reread
sudo supervisorctl update
sudo supervisorctl status worker

如果应用启动后立即退出,autorestart=true 可能造成持续重启;先根据退出日志修复程序问题,必要时将策略改为 unexpected,避免正常退出的任务被无限重复执行。

日志没有内容或无法写入

检查日志路径是否与配置一致、目录是否存在,以及运行用户是否有写入权限:

sudo namei -l /var/log/myapp/worker.log
sudo -u app test -w /var/log/myapp && echo "目录可写"

如果权限不足,只调整应用日志目录的所有者或权限,并确认调整范围不包含系统目录。若修改了权限,应记录原有权限,恢复时按备份记录还原;不要用递归方式放宽整个 /var/log 的权限。

若日志文件持续增长,查看轮转参数和磁盘空间:

df -h /var/log
sudo du -sh /var/log/myapp

轮转配置只约束 Supervisor 管理的对应日志文件,不会自动限制应用写入其他位置的日志。磁盘空间紧张时,应先确认哪些文件可以安全清理,再按应用的日志保留要求处理,避免删除仍在被写入或用于审计的文件。

配置更新影响了不该重启的程序

supervisorctl update 会处理发生变化的程序配置;执行前应检查 reread 输出,确认变更范围只包含预期程序。若更新后影响超出预期,恢复此前备份的配置文件,再重新执行语法检查、reread 和 update。恢复配置也可能触发进程停止或重启,需确认业务允许后操作。

上线与验收检查清单

  • [ ] 程序配置位于 Supervisor 实际读取的目录,程序名没有重复。
  • [ ] command、directory、运行用户及所需环境变量均已核实。
  • [ ] autostart 与 autorestart 符合进程类型,常驻服务和一次性任务未混用重启策略。
  • [ ] 日志目录存在且运行用户可写,轮转大小和保留数量符合磁盘管理要求。
  • [ ] 配置语法检查通过,reread 与 update 只应用了预期变更。
  • [ ] supervisorctl status 显示预期状态,日志中没有持续启动错误。
  • [ ] Supervisor 对应 systemd 服务已启用开机启动,且单元名称与系统实际配置一致。
  • [ ] 原配置备份路径、恢复步骤和变更影响范围已记录。

本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/7789.html

相关推荐