supervisor使用详解

时间：2024-12-15 17:30:51

0、介绍

supervisor 是一个用 Python 编写的客户端/服务器系统，它允许用户在类 UNIX 操作系统（如 Linux）上监控和控制进程。supervisor 并不是一个分布式调度框架，而是一个进程管理工具，它可以用来启动、停止和重启程序，并且可以自动重启崩溃的程序，确保它们保持运行状态。

以下是 Supervisor 的一些主要特点：

  1. 进程管理：Supervisor 可以管理多个子进程，确保它们按照配置文件中指定的方式运行。
  2. 自动重启：如果被监控的进程异常退出，Supervisor 可以根据设定的策略自动重启这些进程。
  3. 日志管理：它能够收集子进程的标准输出和标准错误流，并将它们写入日志文件中，方便调试和故障排查。
  4. 远程控制：通过 XML-RPC 接口，你可以从远程机器上与 Supervisor 进行交互，执行命令或获取状态信息。
  5. Web 界面：提供了一个简单的 Web 界面用于查看所有受管进程的状态以及进行基本的操作，如启动、停止或重启。
  6. 事件监听：支持事件监听机制，可以对特定事件作出反应，比如进程启动、退出等。

1、安装

安装 Supervisor 通常可以通过包管理器完成:

# Debian 或 Ubuntu 上可以使用 apt-get
sudo apt-get install supervisor
# Centos
yum install supervisor

安装完成后，你需要编辑配置文件来定义哪些程序应该由 Supervisor 管理。配置文件一般位于 /etc/supervisor/conf.d/ 目录下。每个要管理的程序都有自己的 .conf 文件。

2、使用

一个典型的配置文件可能看起来像这样：

# 样例：
[program:myapp]
command=/path/to/myapp    ; 启动命令
autostart=true            ; 在 supervisord 启动时自动启动此程序
autorestart=true          ; 当程序退出时自动重启
stderr_logfile=/var/log/myapp.err.log ; 错误日志路径
stdout_logfile=/var/log/myapp.out.log ; 标准输出日志路径
user=root              ; 使用哪个用户权限运行程序




# 正式配置：
[program:test]
command=/root/miniconda3/envs/abr/bin/python /home/kes/test.py 
autostart=true                            
autorestart=true                           
stderr_logfile=/home/kes/test.err.log      
stdout_logfile=/home/kes/test.out.log      
user=root

保存配置文件后，需要更新 Supervisor 的配置并重新加载：

sudo supervisorctl reread
sudo supervisorctl update

之后就可以使用 supervisorctl 命令行工具来管理应用程序了，例如启动、停止或重启服务。Supervisor 是一种非常有用的技术，特别是对于那些需要长时间运行的服务型应用，它可以确保即使是在非预期的情况下也能让这些服务持续可用。

3、web页面

【操作系统】Linux运维工具Supervisor（进程管理工具）_supervisor linux-****博客

在 Supervisor 的状态页面中，进程的状态（State）通常有几种不同的状态。这些状态反映了进程的当前运行状态。以下是 Supervisor 中常见的几种状态：

  1. running：进程正在运行。
  2. starting：进程正在启动过程中。
  3. stopping：进程正在停止过程中。
  4. stopped：进程已经停止。
  5. backoff：进程启动失败，并且 Supervisor 正在等待一段时间后再尝试重新启动。
  6. exit：进程已经退出。
  7. fatal：进程启动失败，并且 Supervisor 不再尝试重新启动。

在 Supervisor 的 Web 界面中，可以通过点击不同的按钮来管理进程的状态：

  • Refresh：刷新状态页面。
  • Restart All：重启所有进程。
  • Stop All：停止所有进程。

对于每个进程，可以执行以下操作：

  • Restart：重启进程。
  • Stop：停止进程。
  • Clear Log：清除日志。
  • Tail -f：实时查看日志。

4、其他命令

# 设置开机自启
systemctl enable supervisord

# 取消开机自启
systemctl disable supervisord

# 检查是否开机自启
systemctl is-enabled supervisord

# 立即启动 supervisord
systemctl start supervisord

# 检查状态
systemctl status supervisord

# 停止服务
systemctl stop supervisord

# 重新加载服务配置
systemctl reload supervisord


#进入子任务配置文件目录
cd /etc/supervisor/conf.d

#创建子任务配置文件
touch test.ini

#编辑配置文件
vi test.ini

重新读取配置文件并应用更改
方式一：
supervisorctl reload：重新读取配置文件
supervisorctl update：更新运行中的程序以反映配置文件中的更改
supervisorctl start test：启动test程序
supervisorctl status test：检查程序的状态以确保它已经成功启动
方式二：
systemctl restart supervisord：停止并再次启动supervisord服务


其他命令：
supervisorctl stop test：停止特定服务
supervisorctl stop all：停止所有服务

(base) [root@VM-16-6-centos ~]#  systemctl status supervisord
● supervisord.service - Process Monitoring and Control Daemon
   Loaded: loaded (/usr/lib/systemd/system/supervisord.service; enabled; vendor preset: disabled)
   Active: active (running) since Sat 2024-12-14 23:06:15 CST; 1h 19min ago
  Process: 4696 ExecStart=/usr/bin/supervisord -c /etc/supervisord.conf (code=exited, status=0/SUCCESS)
 Main PID: 4699 (supervisord)
    Tasks: 5
   Memory: 395.1M
   CGroup: /system.slice/supervisord.service
           ├─ 4699 /usr/bin/python /usr/bin/supervisord -c /etc/supervisord.conf
           ├─24036 /root/miniconda3/envs/abr/bin/python /home/kes/test.py
           ├─24118 /root/miniconda3/envs/abr/bin/python -c from multiprocessing.resource_tracker import ...
           └─24119 /root/miniconda3/envs/abr/bin/python -c from multiprocessing.spawn import spawn_main;...

Dec 14 23:06:15 VM-16-6-centos systemd[1]: Stopped Process Monitoring and Control Daemon.
Dec 14 23:06:15 VM-16-6-centos systemd[1]: Starting Process Monitoring and Control Daemon...
Dec 14 23:06:15 VM-16-6-centos systemd[1]: Started Process Monitoring and Control Daemon.

根据提供的 systemctl status supervisord 输出，可以总结出以下信息：

  • Loaded: 表明 supervisord.service 的单元文件已经被正确加载，并且它位于 /usr/lib/systemd/system/supervisord.service。该服务被设置为开机启动（enabled），但默认情况下供应商预设是禁用的（vendor preset: disabled）。

  • Active (running): 这表示 supervisord 服务当前正在运行，自 2024 年 12 月 14 日 23:06:15 CST 开始已经持续运行了大约 1 小时 19 分钟。

  • Process: 显示了启动 supervisord 服务的命令以及它的退出状态码（code=exited, status=0/SUCCESS），意味着启动过程成功完成。

  • Main PID: 主进程 ID 是 4699，对应于运行中的 supervisord 守护进程。

  • Tasks: 当前由 supervisord 管理的任务数量为 5 个。

  • Memory: 服务占用的内存总量为 395.1 MB。

  • CGroup: 列出了属于 supervisord 服务控制组的所有子进程。从输出中可以看到：

    • PID 4699 是主 supervisord 进程。
    • PID 24036 是您的 Python 脚本 /home/kes/test.py，它正在使用 Miniconda 环境中的 Python 解释器。
    • PIDs 24118 和 24119 看起来像是与 Python 的多处理模块相关的辅助进程，用于资源跟踪和进程生成。

  • 日志条目: 最后几行显示了 systemd 日志，记录了 supervisord 服务的停止、启动和再次启动的时间戳。

相关文章