supervisor安装和配置指南

Posted 2020-11-02

supervisor：是用python写的一个进程管理工具，用来启动，重启，关闭进程。
注意：Supervisor只能管理非daemon的进程，也就是说Supervisor不能管理守护进程。否则提示Exited too quickly (process log may have details)异常。好比Tomcat默认是以守护进程启动的，所以要改成了catalina.sh run，以前台进程的方式运行，关于守护进程和非daemon进程这里不做详细讲解，可自行百度。
具体关于supervisor的相关介绍可以到官网查看：http://supervisord.org/installing.html 英文不好的 可以用谷歌浏览器 对页面进行翻译查阅！本文只对supervisor安装和配置做操作！

官网下载：https://pypi.org/project/supervisor/#files //当然官网说安装有三种方式，本文用的是下载tar包解压在centos7下 执行python脚本进行安装 ：

wget https://files.pythonhosted.org/packages/44/60/698e54b4a4a9b956b2d709b4b7b676119c833d811d53ee2500f1b5e96dc3/supervisor-3.3.4.tar.gz

tar -xf supervisor-3.3.4.tar.gz -C /usr/local/ (-C参数 是解压到/usr/local/ 此路径下）

cd /usr/local/supervisor-3.3.4/ (进入解压目录 找到setup.py 脚本 执行）

python setup.py install

安装完毕...

在终端执行命令: echo_supervisord_conf
可以终端的stdout上打印一个“样本”Supervisor配置文件；
然后 执行 echo_supervisord_conf > /etc/supervisor/supervisord.conf （配置文件的路径也可以放别的地方不一定要放在etc下，但如果放别的地方，在启动服务的时候要指定要在启服务程序的 后面加参数"-c " 后接配置文件的的路径才可以，如果放在etc下系统会自动查到到配置文件的）；
有关于配置文件supervisord.conf里的详解，如下：
；分号后边表示的是注释

[unix_http_server]
file=/usr/local/supervisor-3.3.4/supervisor.sock   ;UNIX socket 文件，supervisorctl 会使用
;chmod=0700                 ;socket文件的mode，默认是0700
;chown=nobody:nogroup       ;socket文件的owner，格式：uid:gid

[inet_http_server]         ;HTTP服务器，提供web管理界面
port=0.0.0.0:9001        ;Web管理后台运行的IP和端口，如果开放到公网，需要注意安全性
username=user              ;登录管理后台的用户名
password=123               ;登录管理后台的密码

[supervisord]
logfile=/usr/local/supervisor-3.3.4/supervisord.log ;日志文件，默认是 $CWD/supervisord.log
logfile_maxbytes=50MB        ;日志文件大小，超出会rotate，默认 50MB，如果设成0，表示不限制大小
logfile_backups=10           ;日志文件保留备份数量默认10，设为0表示不备份
loglevel=info                ;日志级别，默认info，其它: debug,warn,trace
pidfile=/tmp/supervisord.pid ;pid 文件
nodaemon=false               ;是否在前台启动，默认是false，即以 daemon 的方式启动
minfds=1024                  ;可以打开的文件描述符的最小值，默认 1024
minprocs=200                 ;可以打开的进程数的最小值，默认 200

[supervisorctl]
serverurl=pidfile=/usr/local/supervisor-3.3.4/supervisord.pid ;通过UNIX socket连接supervisord，路径与unix_http_server部分的file一致
;serverurl=http://127.0.0.1:9001 ; 通过HTTP的方式连接supervisord

[program:tomcat]是被管理的进程配置参数，tomcat是进程的名称,原文用xx表示，tomcat是我要监控的对象
[program:tomcat]
command=/usr/local/tomcat/bin/catalina.sh run ; 程序启动命令
autostart=true       ; 在supervisord启动的时候也自动启动
startsecs=10         ; 启动10秒后没有异常退出，就表示进程正常启动了，默认为1秒
autorestart=true     ; 程序退出后自动重启,可选值：[unexpected,true,false]，默认为unexpected，表示进程意外杀死后才重启
startretries=3       ; 启动失败自动重试次数，默认是3
user=root          ; 用哪个用户启动进程，默认是root
priority=999         ; 进程启动优先级，默认999，值小的优先启动
redirect_stderr=true ; 把stderr重定向到stdout，默认false
stdout_logfile_maxbytes=20MB  ; stdout 日志文件大小，默认50MB
stdout_logfile_backups = 20   ; stdout 日志文件备份数，默认是10
; stdout 日志文件，需要注意当指定目录不存在时无法正常启动，所以需要手动创建目录（supervisord 会自动创建日志文件）
stdout_logfile=stdout_logfile=/usr/local/tomcat/logs/catalina.out
stopasgroup=true     ;默认为false,进程被杀死时，是否向这个进程组发送stop信号，包括子进程
killasgroup=true     ;默认为false，向进程组发送kill信号，包括子进程

;包含其它配置文件
[include]
files = /etc/supervisor/conf.d/*.conf    ;可以指定一个或多个以.conf结束的配置文件,有的是以*.ini 结尾的，这个是自定义的 不影响；

为什么要有[include ]呢 当我们要监控的程序进程比较多的时候，如果都像tomcat一样都写在此配置文件里的话，那会管理起来很不方便，也很凌乱！所以此时需要[include]来管理其他程序进程的配置文件就非常有必要了
在/etc/supervisor/下创建conf.d文件夹 然后，touch tomcat.conf
编辑tomcat.conf:

[program:tomcat]
command=/usr/local/tomcat/bin/catalina.sh run
user=root
autorstart=true
autorestart=true
startsecs=10
startretries=3
redirect_stderr=true
stdout_logfile=/usr/local/tomcat/logs/log.txt
stderr_logfile=/usr/local/tomcat/logs/err.txt
environment=LC_ALL="C.UTF-8",LANG="C.UTF-8"

cd /usr/local/supervisor-3.3.4/supervisor 可以发现 supervisord.py
这是supervisord的启动程序，bash环境下 可以直接启动 执行命令: ./supervisord.py 也可以python supervisord.py 这样启动，这两种方式不管哪种在不指定配置文件（supervisord.conf)路径的情况下都会有警告的信息：

“用户警告：监督管理是作为根运行的，它在默认位置（包括它当前的工作目录）中搜索它的配置文件;您可能想要指定一个“-c”参数，指定配置文件的绝对路径以提高安全性。
“监督”是作为根，它在搜索”
所以执行supervisord.py的时候最好加上配置文件路径: python supervisord.py -c /etc/supervisor/supervisord.conf 或者直接执行：supervisord -c /etc/supervisor/supervisord.conf 都可以

启动完后 就可以浏览器输入ip地址：9001 访问了 登陆的时候配置文件里有用户名和密码 默认配置的是用户名：user 密码123 ；

如果登陆进去看到下面的界面

tomcat是正常的 就刚配置的，后来我又单独配置了httpd和zabbix 都无法监控 查询了原因才得知是开始时说的守护进程和非daemon进程的问题！