一、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)
/etc/supervisord.d/tornado_handover.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
使配置生效
[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.logSupervisor配置文件說明
/etc/supervisord.conf說明[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