python進程管理工具Supervisor


一、Supervisor簡單介紹

supervisor是一個 Client/Server模式的系統,允許用戶在類unix操作系統上監視和控制多個進程,或者可以說是多個程序。supervisor與launchd,daemontools,runit等程序有着相同的功能。

與其中某些程序不同的是,它並不作為“id 為 1的進程”而替代init。相反,它用於控制應用程序,像啟動其它程序一樣。通俗理解就是,把Supervisor服務管理的進程程序,它們作為supervisor的子進程來運行,而supervisor是父進程。supervisor來監控管理子進程的啟動關閉和異常退出后的自動啟動。

至於為什么要用supervisor來管理進程,是因為相對於linux傳統的進程管理(即系統自帶的init 進程管理)方式來說,它有很多的優勢:

1) 簡單方便
通常管理linux進程的時候,一般來說都需要自己編寫一個能夠實現進程start/stop/restart/reload功能的腳本,然后丟到/etc/init.d/下面。其實這么做有很多不好的地方:
a) 編寫這個腳本,耗時耗力。
b) 當這個進程掛掉的時候,linux不會自動重啟它的,想要自動重啟的話,還要自己另外寫一個監控重啟腳本。

supervisor則可以完美的解決上面這那兩個問題! 那么supervisor怎么解決呢?
a) supervisor管理進程,就是通過fork/exec的方式把這些被管理的進程,當作supervisor的子進程來啟動。這樣的話,只要在supervisor的配置文件中,把要管理的進程的可執行文件的路徑寫進去就OK了。這樣就省下了自己寫腳本管理linux進程的麻煩了。
b) 被管理進程作為supervisor的子進程,當子進程掛掉的時候,父進程可以准確獲取子進程掛掉的信息的,所以也就可以對掛掉的子進程進行自動重啟了, 至於重啟還是不重啟,也要看配置文件里面有沒有設置autostart=true。

2) 精確
linux對進程狀態的反饋有時候不太准確, 也就是說linux進程通常很難獲得准確的up/down狀態, Pidfiles經常說謊!  而supervisor監控子進程,得到的子進程狀態無疑是准確的。supervisord將進程作為子進程啟動,所以它總是知道其子進程的正確的up/down狀態,可以方便的對這些數據進行查詢. 

3) 進程分組
進程支持分組啟動和停止,也支持啟動順序,即‘優先級’,supervisor允許為進程分配優先級,並允許用戶通過supervisorctl客戶端發出命令,如“全部啟動”和”重新啟動所有“,它們以預先分配的優先級順序啟動。還可以將進程分為”進程組“,一組邏輯關聯的進程可以作為一個單元停止或啟動。進程組supervisor可以對進程組統一管理,也就是說我們可以把需要管理的進程寫到一個組里面,然后把這個組作為一個對象進行管理,如啟動,停止,重啟等等操作。而linux系統則是沒有這種功能的,想要停止一個進程,只能一個一個的去停止,要么就自己寫個腳本去批量停止。

4) 集中式管理
supervisor管理的進程,進程組信息,全部都寫在一個ini格式的文件里就OK了。管理supervisor時, 可以在本地進行管理,也可以遠程管理,而且supervisor提供了一個web界面,可以在web界面上監控,管理進程。 當然了,本地,遠程和web管理的時候,需要調用supervisor的xml_rpc接口。

5) 可擴展性
supervisor有一個簡單的事件(event)通知協議,還有一個用於控制的XML-RPC接口,可以用Python開發人員來擴展構建。

6) 權限
總所周知, linux的進程特別是偵聽在1024端口之下的進程,一般用戶大多數情況下,是不能對其進行控制的。想要控制的話,必須要有root權限。然而supervisor提供了一個功能,可以為supervisord或者每個子進程,設置一個非root的user,這個user就可以管理它對應的進程了。

7) 兼容性,穩定性
supervisor由Python編寫,在除Windows操作系統以外基本都支持,如linux,Mac OS x,solaris,FreeBSD系統

二、Supervisor組成部分

1)supervisord: 服務守護進程
supervisor服務器的進程名是supervisord。它主要負責在自己的調用中啟動子程序,響應客戶端的命令,重新啟動崩潰或退出的進程,記錄其子進程stdout和stderr的輸出,以及生成和處理對應於子進程生命周期中的"event"服務器進程使用的配置文件,通常路徑存放在/etc/supervisord.confa中。此配置文件是INI格式的配置文件。
2) supervisorctl:命令行客戶端
supervisor命令行的客戶端名稱是supervisorctl。它為supervisord提供了一個類似於shell的交互界面。使用supervisorctl,用戶可以查看不同的supervisord進程列表,獲取控制子進程的狀態,如停止和啟動子進程
3) Web Server:提供與supervisorctl功能相當的WEB操作界面
一個可以通過Web界面來查看和控制進程的狀態,默認監聽在9091上。
4) XML-RPC Interface:XML-RPC接口
supervisor用於控制的XML-RPC接口

三、Supervisor安裝 (YUM安裝)

centos系統下可以直接yum安裝, 前提是需要下載epel源, 下載地址: http://dl.fedoraproject.org/pub/epel/

centos6系統

========centos6版本系統==================
[root@localhost ~]# rpm -ivh epel-release-latest-6.noarch.rpm --force
[root@localhost ~]# yum install -y supervisor
 
開機啟動
[root@localhost ~]# chkconfig supervisord on
 
啟動/關閉/重啟等操作
[root@localhost ~]# /etc/init.d/supervisord {start|stop|status|restart|reload|force-reload|condrestart}

centos7系統

 ======centos7版本系統==================
[root@localhost ~]# rpm -ivh epel-release-latest-7.noarch.rpm --force
[root@localhost ~]# yum install -7 supervisor
 
開機啟動
[root@localhost ~]# systemctl enable supervisord
 
啟動/關閉/重啟等操作
[root@localhost ~]# systemctl start/stop/restart supervisord

  特別注意另一種安裝方式: 除了yum安裝方式以外, 我們通過會選用pip或easy_install方式安裝supervisor.  

centos7下安裝
[root@localhost ~]# yum install -y python-setuptools
[root@localhost ~]# easy_install supervisor    或者 "pip install supervisor"
 
配置文件, 將默認配置保存在/etc/supervisord.conf中
[root@localhost ~]# echo_supervisord_conf > /etc/supervisord.conf     
 
啟動
[root@localhost ~]# supervisord -c /etc/supervisord.conf
[root@localhost ~]# ps -ef|grep /etc/supervisord
root     26586     1  0 02:02 ?        00:00:00 /usr/bin/python /usr/bin/supervisord -c /etc/supervisord.conf
root     26588 26184  0 02:02 pts/0    00:00:00 grep --color=auto /etc/supervisord
 
[root@localhost ~]# which supervisord
/usr/bin/supervisord
[root@localhost ~]# which supervisorctl
/usr/bin/supervisorctl
如果沒有下面文件, 就手動創建
[root@localhost ~]# vim /usr/lib/systemd/system/supervisord.service
[Unit]
Description=Process Monitoring and Control Daemon
After=rc-local.service nss-user-lookup.target
    
[Service]
Type=forking
ExecStart=/usr/bin/supervisord -c /etc/supervisord.conf
ExecReload=/usr/bin/supervisorctl reload   
ExecStop=/usr/bin/supervisorctl shutdown  
    
[Install]
WantedBy=multi-user.target
 
設置755權限
[root@localhost ~]# chmod 755 /usr/lib/systemd/system/supervisord.service
 
重啟服務(多測試幾次)
[root@localhost ~]# ps -ef|grep /etc/supervisord
root     26586     1  0 02:02 ?        00:00:00 /usr/bin/python /usr/bin/supervisord -c /etc/supervisord.conf
root     26933 26184  0 02:08 pts/0    00:00:00 grep --color=auto /etc/supervisord
[root@localhost ~]# /usr/bin/supervisorctl shutdown
Shut down
[root@localhost ~]# ps -ef|grep /etc/supervisord                  
root     26940 26184  0 02:08 pts/0    00:00:00 grep --color=auto /etc/supervisord
 
由於上面的supervisord進程是使用配置文件手動啟動的, 首次要使用下面的命令關閉,然后使用"systemctl start/stop supervisord" 才會生效!
如果第一次不使用下面命令關閉, 而首次就使用"systemctl stop supervisord" 則關閉不了.
[root@localhost ~]# systemctl start supervisord
[root@localhost ~]# ps -ef|grep /etc/supervisord
root     27049     1  0 02:09 ?        00:00:00 /usr/bin/python /usr/bin/supervisord -c /etc/supervisord.conf
root     27052 26184  0 02:09 pts/0    00:00:00 grep --color=auto /etc/supervisord
 
[root@localhost ~]# systemctl stop supervisord 
[root@localhost ~]# ps -ef|grep /etc/supervisord
root     27068 26184  0 02:09 pts/0    00:00:00 grep --color=auto /etc/supervisord
 
[root@localhost ~]# systemctl start supervisord
[root@localhost ~]# systemctl restart supervisord
[root@localhost ~]# systemctl reload supervisord
[root@localhost ~]# ps -ef|grep /etc/supervisord
root     27097     1  0 02:09 ?        00:00:00 /usr/bin/python /usr/bin/supervisord -c /etc/supervisord.conf
root     27100 26184  0 02:09 pts/0    00:00:00 grep --color=auto /etc/supervisord
 
開機啟動
[root@localhost ~]# systemctl enable supervisord
Created symlink from /etc/systemd/system/multi-user.target.wants/supervisord.service to /usr/lib/systemd/system/superviso
#supervisord服務本身模式配置項

#vim /etc/supervisord.conf
#  不采用sock連接方式
;[unix_http_server]
;file=/tmp/supervisor.sock   ; the path to the socket file
;chmod=0700                 ; socket file mode (default 0700)
;chown=nobody:nogroup       ; socket file uid:gid owner
;username=user              ; default is no username (open server)
;password=123               ; default is no password (open server)
 
#采用http連接方式, 並設置登錄驗證信息
[inet_http_server]         ; inet (TCP) server disabled by default
port=192.168.10.10:9001        ; ip_address:port specifier, *:port for all iface
username=user              ; default is no username (open server)
password=123               ; default is no password (open server)

# 添加被監控程序,被監控程序自身非后台運行

(/etc/supervisord.conf 中配置了:[include]  files = supervisord.d/*.ini)

[group:tornado_handover_system_services]
programs=handover_8081,handover_8082,handover_8083,handover_8084

[program:handover_8081]
command=/root/anaconda3/bin/python /opt/handover_system/tornado1/handover.py --port=8081
directory=/opt/handover_system/tornado1/
autostart=true
autorestart=true
startsecs=2
redirect_stderr=true
stdout_logfile=/opt/zmd/tornado_log/handover_8081.log

[program:handover_8082]
command=/root/anaconda3/bin/python /opt/handover_system/tornado1/handover.py --port=8082
directory=/opt/handover_system/tornado1/
autostart=true
autorestart=true
startsecs=2
redirect_stderr=true
stdout_logfile=/opt/zmd/tornado_log/handover_8082.log

[program:handover_8083]
command=/root/anaconda3/bin/python /opt/handover_system/tornado1/handover.py --port=8083
directory=/opt/handover_system/tornado1/
autostart=true
autorestart=true
startsecs=2
redirect_stderr=true
stdout_logfile=/opt/zmd/tornado_log/handover_8083.log

[program:handover_8084]
command=/root/anaconda3/bin/python /opt/handover_system/tornado1/handover.py --port=8084
directory=/opt/handover_system/tornado1/
autostart=true
autorestart=true
startsecs=2
redirect_stderr=true
stdout_logfile=/opt/zmd/tornado_log/handover_8084.log
/etc/supervisord.d/tornado_handover.ini

使配置生效

[root@localhost ~]# systemctl reload supervisord
supervisor日志文件: /var/log/supervisor/supervisord.log
supervisor配置文件: /etc/supervisord.conf
supervisor連接方式: http和sock 兩種

Supervisord安裝完成后有兩個可用的命令行: supervisor和supervisorctl

常見的命令如下:
supervisord        初始啟動Supervisord,啟動、管理配置中設置的進程
supervisorctl stop programxxx        停止某一個進程(programxxx),programxxx為[program:chatdemon]里配置的值,這個示例就是chatdemon
supervisorctl start programxxx        啟動某個進程
supervisorctl restart programxxx     重啟某個進程
supervisorctl stop groupworker       重啟所有屬於名為groupworker這個分組的進程(start,restart同理)
supervisorctl stop all     停止全部進程,注:start、restart、stop都不會載入最新的配置文件
supervisorctl reload      載入最新的配置文件,停止原有進程並按新的配置啟動、管理所有進程
supervisorctl update     根據最新的配置文件,啟動新配置或有改動的進程,配置沒有改動的進程不會受影響而重啟。注意:顯示用stop停止掉的進程,用reload或者update都不會自動重啟

supervisorctl tail programname       //查看programname的日志
supervisorctl tail redis        //查看日志

supervisor事件監聽及通知機制
-  supervisor向listeners發送和子進程或自身有關的notification。對於同一pool內的listeners,supervisor會選取任一可用的進行通知。
-  配置被監控進程[program:x]的日志Capture Mode,被監控進程可向stdout輸出業務數據,由supervisod捕獲這些數據,發給listener。
-  配置event-listener:監聽PROCESS_COMMUNICATION_STDOUT事件
-  envent-listener模塊開發:使用python的supervisor.childutils模塊。該模塊可作為監控代理模塊,和進程及網管服務通信。與網管服務可采用redis的list實現。

supervisor監控管理-web界面

1) web界面管理
為了更方便的遠程管理 Supervisor ,我們還可以開啟其自帶的 web 控制台。打開 /supervisord.conf ,在文件末尾增加以下內容:
[root@kevin ~]# vim /etc/supervisord.conf
......
[inet_http_server]
port=*:5000
username=user
password=123456
 
配置說明:
port 為監聽端口,username 和 password 分別為帳號和密碼。
保存文件后需要重啟supervisor
然后訪問"http://ip:5000" , 輸入上面設置的用戶名和密碼即可打開supervisor的web 控制台了。
 
2) 客戶端命令行操作
[root@170~ ~]# supervisorctl -s http://ip:port -u user -p passwd command
 
3) 通過shell來管理supervisor ,可以使用以下命令:
supervisorctl start appname      #啟動特定程序
supervisorctl stop appname       #停止特定程序
supervisorctl restart appname    #重啟特定程序
supervisorctl start all      #啟動所有程序
supervisorctl stop all       #停止所有程序
supervisorctl restart all    #重啟所有程序
 
最后需要注意的是:
如果使用 Supervisor 監控 shell 腳本,不能在腳本中完全使用 nohup, setsid 等后台運行命令,否則 supervisor 會誤認為程序自動退出而不斷重啟腳本。

 

配置文件解析

program 配置

[program:app] ; 程序名稱,在 supervisorctl 中通過這個值來對程序進行一系列的操作
autorestart=True      ; 程序異常退出后自動重啟
autostart=True        ; 在 supervisord 啟動的時候也自動啟動
redirect_stderr=True  ; 把 stderr 重定向到 stdout,默認 false
environment=PATH="/home/app_env/bin"  ; 可以通過 environment 來添加需要的環境變量,一種常見的用法是使用指定的 virtualenv 環境
command=python server.py  ; 啟動命令,與手動在命令行啟動的命令是一樣的
user=ubuntu           ; 用哪個用戶啟動
directory=/home/app/  ; 程序的啟動目錄
stdout_logfile_maxbytes = 20MB  ; stdout 日志文件大小,默認 50MB
stdout_logfile_backups = 20     ; stdout 日志文件備份數
; stdout 日志文件,需要注意當指定目錄不存在時無法正常啟動,所以需要手動創建目錄(supervisord 會自動創建日志文件)
stdout_logfile = /data/logs/usercenter_stdout.log

Supervisor配置文件說明 

[unix_http_server]          
file=/tmp/supervisor.sock   ; socket文件的路徑,supervisorctl用XML_RPC和supervisord通信就是通過它進行
                              的。如果不設置的話,supervisorctl也就不能用了
                              不設置的話,默認為none。 非必須設置      
;chmod=0700                 ; 這個簡單,就是修改上面的那個socket文件的權限為0700
                              不設置的話,默認為0700。 非必須設置
;chown=nobody:nogroup       ; 這個一樣,修改上面的那個socket文件的屬組為user.group
                              不設置的話,默認為啟動supervisord進程的用戶及屬組。非必須設置
;username=user              ; 使用supervisorctl連接的時候,認證的用戶
                               不設置的話,默認為不需要用戶。 非必須設置
;password=123               ; 和上面的用戶名對應的密碼,可以直接使用明碼,也可以使用SHA加密
                              如:{SHA}82ab876d1387bfafe46cc1c8a2ef074eae50cb1d
                              默認不設置。。。非必須設置
  
;[inet_http_server]         ; 偵聽在TCP上的socket,Web Server和遠程的supervisorctl都要用到他
                              不設置的話,默認為不開啟。非必須設置
;port=127.0.0.1:9001        ; 這個是偵聽的IP和端口,偵聽所有IP用 :9001或*:9001。
                              這個必須設置,只要上面的[inet_http_server]開啟了,就必須設置它
;username=user              ; 這個和上面的uinx_http_server一個樣。非必須設置
;password=123               ; 這個也一個樣。非必須設置
  
[supervisord]                ;這個主要是定義supervisord這個服務端進程的一些參數的
                              這個必須設置,不設置,supervisor就不用干活了
logfile=/tmp/supervisord.log ; 這個是supervisord這個主進程的日志路徑,注意和子進程的日志不搭嘎。
                               默認路徑$CWD/supervisord.log,$CWD是當前目錄。。非必須設置
logfile_maxbytes=50MB        ; 這個是上面那個日志文件的最大的大小,當超過50M的時候,會生成一個新的日
                               志文件。當設置為0時,表示不限制文件大小
                               默認值是50M,非必須設置。            
logfile_backups=10           ; 日志文件保持的數量,上面的日志文件大於50M時,就會生成一個新文件。文件
                               數量大於10時,最初的老文件被新文件覆蓋,文件數量將保持為10
                               當設置為0時,表示不限制文件的數量。
                               默認情況下為10。。。非必須設置
loglevel=info                ; 日志級別,有critical, error, warn, info, debug, trace, or blather等
                               默認為info。。。非必須設置項
pidfile=/tmp/supervisord.pid ; supervisord的pid文件路徑。
                               默認為$CWD/supervisord.pid。。。非必須設置
nodaemon=false               ; 如果是true,supervisord進程將在前台運行
                               默認為false,也就是后台以守護進程運行。。。非必須設置
minfds=1024                  ; 這個是最少系統空閑的文件描述符,低於這個值supervisor將不會啟動。
                               系統的文件描述符在這里設置cat /proc/sys/fs/file-max
                               默認情況下為1024。。。非必須設置
minprocs=200                 ; 最小可用的進程描述符,低於這個值supervisor也將不會正常啟動。
                              ulimit  -u這個命令,可以查看linux下面用戶的最大進程數
                              默認為200。。。非必須設置
;umask=022                   ; 進程創建文件的掩碼
                               默認為022。。非必須設置項
;user=chrism                 ; 這個參數可以設置一個非root用戶,當我們以root用戶啟動supervisord之后。
                               我這里面設置的這個用戶,也可以對supervisord進行管理
                               默認情況是不設置。。。非必須設置項
;identifier=supervisor       ; 這個參數是supervisord的標識符,主要是給XML_RPC用的。當你有多個
                               supervisor的時候,而且想調用XML_RPC統一管理,就需要為每個
                               supervisor設置不同的標識符了
                               默認是supervisord。。。非必需設置
;directory=/tmp              ; 這個參數是當supervisord作為守護進程運行的時候,設置這個參數的話,啟動
                               supervisord進程之前,會先切換到這個目錄
                               默認不設置。。。非必須設置
;nocleanup=true              ; 這個參數當為false的時候,會在supervisord進程啟動的時候,把以前子進程
                               產生的日志文件(路徑為AUTO的情況下)清除掉。有時候咱們想要看歷史日志,當
                               然不想日志被清除了。所以可以設置為true
                               默認是false,有調試需求的同學可以設置為true。。。非必須設置
;childlogdir=/tmp            ; 當子進程日志路徑為AUTO的時候,子進程日志文件的存放路徑。
                               默認路徑是這個東西,執行下面的這個命令看看就OK了,處理的東西就默認路徑
                               python -c "import tempfile;print tempfile.gettempdir()"
                               非必須設置
;environment=KEY="value"     ; 這個是用來設置環境變量的,supervisord在linux中啟動默認繼承了linux的
                               環境變量,在這里可以設置supervisord進程特有的其他環境變量。
                               supervisord啟動子進程時,子進程會拷貝父進程的內存空間內容。 所以設置的
                               這些環境變量也會被子進程繼承。
                               小例子:environment=name="haha",age="hehe"
                               默認為不設置。。。非必須設置
;strip_ansi=false            ; 這個選項如果設置為true,會清除子進程日志中的所有ANSI 序列。什么是ANSI
                               序列呢?就是我們的\n,\t這些東西。
                               默認為false。。。非必須設置
  
; the below section must remain in the config file for RPC
; (supervisorctl/web interface) to work, additional interfaces may be
; added by defining them in separate rpcinterface: sections
[rpcinterface:supervisor]    ;這個選項是給XML_RPC用的,當然你如果想使用supervisord或者web server 這
                              個選項必須要開啟的
supervisor.rpcinterface_factory = supervisor.rpcinterface:make_main_rpcinterface
  
[supervisorctl]              ;這個主要是針對supervisorctl的一些配置
serverurl=unix:///tmp/supervisor.sock ; 這個是supervisorctl本地連接supervisord的時候,本地UNIX socket
                                        路徑,注意這個是和前面的[unix_http_server]對應的
                                        默認值就是unix:///tmp/supervisor.sock。。非必須設置
;serverurl=http://127.0.0.1:9001 ; 這個是supervisorctl遠程連接supervisord的時候,用到的TCP socket路徑
                                   注意這個和前面的[inet_http_server]對應
                                   默認就是http://127.0.0.1:9001。。。非必須項
                                 
;username=chris              ; 用戶名
                               默認空。。非必須設置
;password=123                ; 密碼
                              默認空。。非必須設置
;prompt=mysupervisor         ; 輸入用戶名密碼時候的提示符
                               默認supervisor。。非必須設置
;history_file=~/.sc_history  ; 這個參數和shell中的history類似,我們可以用上下鍵來查找前面執行過的命令
                               默認是no file的。。所以我們想要有這種功能,必須指定一個文件。。。非
                               必須設置
  
; The below sample program section shows all possible program subsection values,
; create one or more 'real' program: sections to be able to control them under
; supervisor.
  
;[program:theprogramname]      ;這個就是咱們要管理的子進程了,":"后面的是名字,最好別亂寫和實際進程
                                有點關聯最好。這樣的program我們可以設置一個或多個,一個program就是
                                要被管理的一個進程
;command=/bin/cat              ; 這個就是我們的要啟動進程的命令路徑了,可以帶參數
                                例子:/home/test.py -a 'hehe'
                                有一點需要注意的是,我們的command只能是那種在終端運行的進程,不能是
                                守護進程。這個想想也知道了,比如說command=service httpd start。
                                httpd這個進程被linux的service管理了,我們的supervisor再去啟動這個命令
                                這已經不是嚴格意義的子進程了。
                                這個是個必須設置的項
;process_name=%(program_name)s ; 這個是進程名,如果我們下面的numprocs參數為1的話,就不用管這個參數
                                 了,它默認值%(program_name)s也就是上面的那個program冒號后面的名字,
                                 但是如果numprocs為多個的話,那就不能這么干了。想想也知道,不可能每個
                                 進程都用同一個進程名吧。
  
                                  
;numprocs=1                    ; 啟動進程的數目。當不為1時,就是進程池的概念,注意process_name的設置
                                 默認為1    。。非必須設置
;directory=/tmp                ; 進程運行前,會前切換到這個目錄
                                 默認不設置。。。非必須設置
;umask=022                     ; 進程掩碼,默認none,非必須
;priority=999                  ; 子進程啟動關閉優先級,優先級低的,最先啟動,關閉的時候最后關閉
                                 默認值為999 。。非必須設置
;autostart=true                ; 如果是true的話,子進程將在supervisord啟動后被自動啟動
                                 默認就是true   。。非必須設置
;autorestart=unexpected        ; 這個是設置子進程掛掉后自動重啟的情況,有三個選項,false,unexpected
                                 和true。如果為false的時候,無論什么情況下,都不會被重新啟動,
                                 如果為unexpected,只有當進程的退出碼不在下面的exitcodes里面定義的退
                                 出碼的時候,才會被自動重啟。當為true的時候,只要子進程掛掉,將會被無
                                 條件的重啟
;startsecs=1                   ; 這個選項是子進程啟動多少秒之后,此時狀態如果是running,則我們認為啟
                                 動成功了
                                 默認值為1 。。非必須設置
;startretries=3                ; 當進程啟動失敗后,最大嘗試啟動的次數。。當超過3次后,supervisor將把
                                 此進程的狀態置為FAIL
                                 默認值為3 。。非必須設置
;exitcodes=0,2                 ; 注意和上面的的autorestart=unexpected對應。。exitcodes里面的定義的
                                 退出碼是expected的。
;stopsignal=QUIT               ; 進程停止信號,可以為TERM, HUP, INT, QUIT, KILL, USR1, or USR2等信號
                                  默認為TERM 。。當用設定的信號去干掉進程,退出碼會被認為是expected
                                  非必須設置
;stopwaitsecs=10               ; 這個是當我們向子進程發送stopsignal信號后,到系統返回信息
                                 給supervisord,所等待的最大時間。 超過這個時間,supervisord會向該
                                 子進程發送一個強制kill的信號。
                                 默認為10秒。。非必須設置
;stopasgroup=false             ; 這個東西主要用於,supervisord管理的子進程,這個子進程本身還有
                                 子進程。那么我們如果僅僅干掉supervisord的子進程的話,子進程的子進程
                                 有可能會變成孤兒進程。所以咱們可以設置可個選項,把整個該子進程的
                                 整個進程組都干掉。 設置為true的話,一般killasgroup也會被設置為true。
                                 需要注意的是,該選項發送的是stop信號
                                 默認為false。。非必須設置。。
;killasgroup=false             ; 這個和上面的stopasgroup類似,不過發送的是kill信號
;user=chrism                   ; 如果supervisord是root啟動,我們在這里設置這個非root用戶,可以用來
                                 管理該program
                                 默認不設置。。。非必須設置項
;redirect_stderr=true          ; 如果為true,則stderr的日志會被寫入stdout日志文件中
                                 默認為false,非必須設置
;stdout_logfile=/a/path        ; 子進程的stdout的日志路徑,可以指定路徑,AUTO,none等三個選項。
                                 設置為none的話,將沒有日志產生。設置為AUTO的話,將隨機找一個地方
                                 生成日志文件,而且當supervisord重新啟動的時候,以前的日志文件會被
                                 清空。當 redirect_stderr=true的時候,sterr也會寫進這個日志文件
;stdout_logfile_maxbytes=1MB   ; 日志文件最大大小,和[supervisord]中定義的一樣。默認為50
;stdout_logfile_backups=10     ; 和[supervisord]定義的一樣。默認10
;stdout_capture_maxbytes=1MB   ; 這個東西是設定capture管道的大小,當值不為0的時候,子進程可以從stdout
                                 發送信息,而supervisor可以根據信息,發送相應的event。
                                 默認為0,為0的時候表達關閉管道。。。非必須項
;stdout_events_enabled=false   ; 當設置為ture的時候,當子進程由stdout向文件描述符中寫日志的時候,將
                                 觸發supervisord發送PROCESS_LOG_STDOUT類型的event
                                 默認為false。。。非必須設置
;stderr_logfile=/a/path        ; 這個東西是設置stderr寫的日志路徑,當redirect_stderr=true。這個就不用
                                 設置了,設置了也是白搭。因為它會被寫入stdout_logfile的同一個文件中
                                 默認為AUTO,也就是隨便找個地存,supervisord重啟被清空。。非必須設置
;stderr_logfile_maxbytes=1MB   ; 這個出現好幾次了,就不重復了
;stderr_logfile_backups=10     ; 這個也是
;stderr_capture_maxbytes=1MB   ; 這個一樣,和stdout_capture一樣。 默認為0,關閉狀態
;stderr_events_enabled=false   ; 這個也是一樣,默認為false
;environment=A="1",B="2"       ; 這個是該子進程的環境變量,和別的子進程是不共享的
;serverurl=AUTO                ;
  
; The below sample eventlistener section shows all possible
; eventlistener subsection values, create one or more 'real'
; eventlistener: sections to be able to handle event notifications
; sent by supervisor.
  
;[eventlistener:theeventlistenername] ;這個東西其實和program的地位是一樣的,也是suopervisor啟動的子進
                                       程,不過它干的活是訂閱supervisord發送的event。他的名字就叫
                                       listener了。我們可以在listener里面做一系列處理,比如報警等等
                                       樓主這兩天干的活,就是弄的這玩意
;command=/bin/eventlistener    ; 這個和上面的program一樣,表示listener的可執行文件的路徑
;process_name=%(program_name)s ; 這個也一樣,進程名,當下面的numprocs為多個的時候,才需要。否則默認就
                                 OK了
;numprocs=1                    ; 相同的listener啟動的個數
;events=EVENT                  ; event事件的類型,也就是說,只有寫在這個地方的事件類型。才會被發送
                        
                                   
;buffer_size=10                ; 這個是event隊列緩存大小,單位不太清楚,樓主猜測應該是個吧。當buffer
                                 超過10的時候,最舊的event將會被清除,並把新的event放進去。
                                 默認值為10。。非必須選項
;directory=/tmp                ; 進程執行前,會切換到這個目錄下執行
                                 默認為不切換。。。非必須
;umask=022                     ; 淹沒,默認為none,不說了
;priority=-1                   ; 啟動優先級,默認-1,也不扯了
;autostart=true                ; 是否隨supervisord啟動一起啟動,默認true
;autorestart=unexpected        ; 是否自動重啟,和program一個樣,分true,false,unexpected等,注意
                                  unexpected和exitcodes的關系
;startsecs=1                   ; 也是一樣,進程啟動后跑了幾秒鍾,才被認定為成功啟動,默認1
;startretries=3                ; 失敗最大嘗試次數,默認3
;exitcodes=0,2                 ; 期望或者說預料中的進程退出碼,
;stopsignal=QUIT               ; 干掉進程的信號,默認為TERM,比如設置為QUIT,那么如果QUIT來干這個進程
                                 那么會被認為是正常維護,退出碼也被認為是expected中的
;stopwaitsecs=10               ; max num secs to wait b4 SIGKILL (default 10)
;stopasgroup=false             ; send stop signal to the UNIX process group (default false)
;killasgroup=false             ; SIGKILL the UNIX process group (def false)
;user=chrism                   ;設置普通用戶,可以用來管理該listener進程。
                                默認為空。。非必須設置
;redirect_stderr=true          ; 為true的話,stderr的log會並入stdout的log里面
                                默認為false。。。非必須設置
;stdout_logfile=/a/path        ; 這個不說了,好幾遍了
;stdout_logfile_maxbytes=1MB   ; 這個也是
;stdout_logfile_backups=10     ; 這個也是
;stdout_events_enabled=false   ; 這個其實是錯的,listener是不能發送event
;stderr_logfile=/a/path        ; 這個也是
;stderr_logfile_maxbytes=1MB   ; 這個也是
;stderr_logfile_backups        ; 這個不說了
;stderr_events_enabled=false   ; 這個也是錯的,listener不能發送event
;environment=A="1",B="2"       ; 這個是該子進程的環境變量
                                 默認為空。。。非必須設置
;serverurl=AUTO                ; override serverurl computation (childutils)
  
; The below sample group section shows all possible group values,
; create one or more 'real' group: sections to create "heterogeneous"
; process groups.
  
;[group:thegroupname]    ;這個東西就是給programs分組,划分到組里面的program。我們就不用一個一個去操作了
                         我們可以對組名進行統一的操作。 注意:program被划分到組里面之后,就相當於原來
                         的配置從supervisor的配置文件里消失了。。。supervisor只會對組進行管理,而不再
                         會對組里面的單個program進行管理了
;programs=progname1,progname2  ; 組成員,用逗號分開
                                 這個是個必須的設置項
;priority=999                  ; 優先級,相對於組和組之間說的
                                 默認999。。非必須選項
  
; The [include] section can just contain the "files" setting.  This
; setting can list multiple files (separated by whitespace or
; newlines).  It can also contain wildcards.  The filenames are
; interpreted as relative to this file.  Included files *cannot*
; include files themselves.
  
;[include]                         ;這個東西挺有用的,當我們要管理的進程很多的時候,寫在一個文件里面
                                    就有點大了。我們可以把配置信息寫到多個文件中,然后include過來
;files = relative/directory/*.ini
/etc/supervisord.conf說明

 

 


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM