echo_supervisord_conf - Trực tuyến trên đám mây

CHƯƠNG TRÌNH:

TÊN

echo_supervisord_conf - Tài liệu cấu hình người giám sát

Người giám sát là một hệ thống máy khách / máy chủ cho phép người dùng giám sát và kiểm soát một số
quy trình trên hệ điều hành giống UNIX.

Nó chia sẻ một số mục tiêu giống nhau của các chương trình như khởi chạy, daemontools và runit. không giống
một số chương trình này, nó không được dùng để thay thế cho trong đó là "id quy trình
1 ". Thay vào đó, nó được sử dụng để kiểm soát các quá trình liên quan đến một dự án hoặc một
khách hàng, và có nghĩa là bắt đầu giống như bất kỳ chương trình nào khác tại thời điểm khởi động.

TÀI LIỆU

Tạo a Cấu hình Tập tin
Sau khi cài đặt Người giám sát hoàn tất, hãy chạy echo_supervisord_conf. Điều này sẽ
in tệp cấu hình Người giám sát "mẫu" vào trình duyệt thiết bị đầu cuối của bạn.

Sau khi bạn thấy tệp được lặp lại đến thiết bị đầu cuối của mình, hãy gọi lại lệnh dưới dạng
echo_supervisord_conf > /etc/supervisord.conf. Điều này sẽ không hoạt động nếu bạn không có root
truy cập.

Nếu bạn không có quyền truy cập root hoặc bạn không muốn đặt giám sát.conf tập tin trong
/ etc / supervisord.conf`, bạn có thể đặt nó trong thư mục hiện tại (echo_supervisord_conf >
giám sát.conf) và bắt đầu người giám sát với -c cờ để chỉ định
vị trí tệp cấu hình.

Ví dụ, người giám sát -c giám sát.conf. Sử dụng -c cờ thực sự là thừa trong
trường hợp này, bởi vì người giám sát tìm kiếm thư mục hiện tại cho một giám sát.conf
trước khi nó tìm kiếm bất kỳ vị trí nào khác cho tệp, nhưng nó sẽ hoạt động.

Khi bạn có tệp cấu hình trên hệ thống tệp của mình, bạn có thể bắt đầu sửa đổi nó thành
thích.

Cấu hình Tập tin
Tệp cấu hình Người giám sát được đặt tên theo quy ước giám sát.conf. Nó được sử dụng bởi
cả hai người giám sát và giám sát viên. Nếu một trong hai ứng dụng được khởi động mà không có -c
tùy chọn (tùy chọn được sử dụng để cho ứng dụng biết tên tệp cấu hình
rõ ràng), ứng dụng sẽ tìm kiếm một tệp có tên giám sát.conf trong
các vị trí sau đây, theo thứ tự được chỉ định. Nó sẽ sử dụng tệp đầu tiên mà nó tìm thấy.

1. $ CWD / supervisord.conf

2. $ CWD / etc / supervisord.conf

3. /etc/supervisord.conf

4. ../etc/supervisord.conf (Liên quan đến tệp thực thi)

5. ../supervisord.conf (Liên quan đến tệp thực thi)

LƯU Ý:
Một số bản phân phối đã đóng gói Supervisor với các tùy chỉnh của riêng họ. Này
phiên bản sửa đổi của Người giám sát có thể tải tệp cấu hình từ các vị trí khác
hơn những gì được mô tả ở đây. Đáng chú ý, các gói Ubuntu đã được phát hiện sử dụng
/etc/supervisor/supervisord.conf.

Tập tin Định dạng
giám sát.conf là một tệp kiểu Windows-INI (Python ConfigParser). Nó có các phần (mỗi
được biểu thị bằng một [tiêu đề]) và các cặp khóa / giá trị trong các phần. Các phần và
giá trị cho phép được mô tả dưới đây.

Môi trường Biến
Các biến môi trường hiện diện trong môi trường tại thời điểm đó người giám sát is
Bắt đầu có thể được sử dụng trong tệp cấu hình bằng cách sử dụng cú pháp biểu thức chuỗi Python
% (ENV_X) s:

[chương trình: ví dụ]
command = / usr / bin / example --loglevel =% (ENV_LOGLEVEL) s

Trong ví dụ trên, biểu thức % (ENV_LOGLEVEL) s sẽ được mở rộng đến giá trị của
biến môi trường MỨC ĐĂNG NHẬP.

LƯU Ý:
Trong Supervisor 3.2 trở lên, % (ENV_X) s biểu thức được hỗ trợ trong tất cả các tùy chọn. Trong
các phiên bản trước, một số tùy chọn hỗ trợ chúng, nhưng hầu hết thì không. Xem tài liệu cho
mỗi tùy chọn bên dưới.

[unix_http_server] Phần Cài đặt
Sản phẩm giám sát.conf tệp chứa một phần có tên [unix_http_server] theo đó
tham số cấu hình cho máy chủ HTTP lắng nghe trên ổ cắm miền UNIX phải là
đã chèn. Nếu tệp cấu hình không có [unix_http_server] phần, miền UNIX
Máy chủ HTTP socket sẽ không được khởi động. Các giá trị cấu hình cho phép là
theo sau.

[unix_http_server] Phần Các giá trị
hồ sơ
Đường dẫn đến ổ cắm miền UNIX (ví dụ: /tmp/supervisord.sock) mà người giám sát sẽ
lắng nghe các yêu cầu HTTP / XML-RPC. giám sát viên sử dụng XML-RPC để giao tiếp với
người giám sát qua cổng này. Tùy chọn này có thể bao gồm giá trị % (tại đây) s, mở rộng
đến thư mục trong đó người giám sát tập tin cấu hình đã được tìm thấy.

Mặc định: Không ai.

Yêu cầu: Không

Giới thiệu: 3.0

chmod
Thay đổi các bit chế độ cho phép UNIX của ổ cắm miền UNIX thành giá trị này tại
khởi động

Mặc định: 0700

Yêu cầu: Không

Giới thiệu: 3.0

chown
Thay đổi người dùng và nhóm của tệp socket thành giá trị này. Có thể là tên người dùng UNIX
(ví dụ tình yêu) hoặc tên người dùng và nhóm UNIX được phân tách bằng dấu hai chấm (ví dụ: chrism: bánh xe).

Mặc định: Sử dụng tên người dùng và nhóm người dùng bắt đầu giám sát.

Yêu cầu: Không

Giới thiệu: 3.0

tên truy nhập
Tên người dùng cần thiết để xác thực máy chủ HTTP này.

Mặc định: Không cần tên người dùng.

Yêu cầu: Không

Giới thiệu: 3.0

mật khẩu
Mật khẩu bắt buộc để xác thực máy chủ HTTP này. Đây có thể là một văn bản rõ ràng
mật khẩu, hoặc có thể được chỉ định dưới dạng hàm băm SHA-1 nếu chuỗi có tiền tố {SHA}. Đối với
thí dụ, {SHA}82ab876d1387bfafe46cc1c8a2ef074eae50cb1d là phiên bản được lưu trữ SHA của
mật khẩu "thepassword".

Lưu ý rằng mật khẩu băm phải ở định dạng hex.

Mặc định: Không cần mật khẩu.

Yêu cầu: Không

Giới thiệu: 3.0

[unix_http_server] Phần Ví dụ
[unix_http_server]
tệp = /tmp/giám sát.sock
chmod = 0777
chown = ai: nogroup
tên người dùng = người dùng
mật khẩu = 123

[inet_http_server] Phần Cài đặt
Sản phẩm giám sát.conf tệp chứa một phần có tên [inet_http_server] theo đó
các tham số cấu hình cho máy chủ HTTP lắng nghe trên ổ cắm TCP (internet) phải
được chèn vào. Nếu tệp cấu hình không có [inet_http_server] phần inet HTTP
máy chủ sẽ không được khởi động. Các giá trị cấu hình cho phép như sau.

[inet_http_server] Phần Các giá trị
cổng
Máy chủ TCP: giá trị cổng hoặc (ví dụ: 127.0.0.1:9001) mà người giám sát sẽ lắng nghe
Yêu cầu HTTP / XML-RPC. giám sát viên sẽ sử dụng XML-RPC để giao tiếp với người giám sát
qua cổng này. Để nghe trên tất cả các giao diện trong máy, hãy sử dụng : 9001 or *: 9001.

Mặc định: Không có mặc định.

Yêu cầu: Có.

Giới thiệu: 3.0

tên truy nhập
Tên người dùng cần thiết để xác thực máy chủ HTTP này.

Mặc định: Không cần tên người dùng.

Yêu cầu: Không

Giới thiệu: 3.0

mật khẩu
Mật khẩu bắt buộc để xác thực máy chủ HTTP này. Đây có thể là một văn bản rõ ràng
mật khẩu, hoặc có thể được chỉ định dưới dạng hàm băm SHA-1 nếu chuỗi có tiền tố {SHA}. Đối với
thí dụ, {SHA}82ab876d1387bfafe46cc1c8a2ef074eae50cb1d là phiên bản được lưu trữ SHA của
mật khẩu "thepassword".

Lưu ý rằng mật khẩu băm phải ở định dạng hex.

Mặc định: Không cần mật khẩu.

Yêu cầu: Không

Giới thiệu: 3.0

[inet_http_server] Phần Ví dụ
[inet_http_server]
cổng = 127.0.0.1:9001
tên người dùng = người dùng
mật khẩu = 123

[giám sát viên] Phần Cài đặt
Sản phẩm giám sát.conf tệp chứa một phần có tên [giám sát viên] trong đó cài đặt chung
liên quan đến người giám sát quy trình nên được chèn vào. Những điều này như sau.

[giám sát viên] Phần Các giá trị
tệp nhật ký
Đường dẫn đến nhật ký hoạt động của quá trình giám sát. Tùy chọn này có thể bao gồm
giá trị % (tại đây) s, mở rộng đến thư mục trong đó cấu hình giám sát
tập tin đã được tìm thấy.

Mặc định: $ CWD / supervisord.log

Yêu cầu: Không

Giới thiệu: 3.0

logfile_maxbytes
Số byte tối đa có thể được sử dụng bởi tệp nhật ký hoạt động trước khi
xoay vòng (có thể sử dụng các hệ số hậu tố như "KB", "MB" và "GB" trong giá trị). Bộ
giá trị này thành 0 để cho biết kích thước nhật ký không giới hạn.

Mặc định: 50 MB

Yêu cầu: Không

Giới thiệu: 3.0

logfile_backups
Số lượng bản sao lưu cần giữ lại do xoay tệp nhật ký hoạt động. Nếu đặt
về 0, sẽ không có bản sao lưu nào được giữ lại.

Mặc định: 10

Yêu cầu: Không

Giới thiệu: 3.0

mức độ đăng nhập
Mức độ ghi nhật ký, chỉ ra những gì được ghi vào nhật ký hoạt động của người giám sát. Một trong
quan trọng, lôi, cảnh báo, Thông tin, gỡ lỗi, theo dõi, hoặc là bla bla. Lưu ý rằng ở cấp độ nhật ký gỡ lỗi,
tệp nhật ký giám sát sẽ ghi lại đầu ra stderr / stdout của các quy trình con của nó
và thông tin thông tin mở rộng về các thay đổi trạng thái quy trình, rất hữu ích cho việc gỡ lỗi
quy trình không bắt đầu đúng cách. Xem thêm: activity_log_levels.

Mặc định: thông tin

Yêu cầu: Không

Giới thiệu: 3.0

pidfile
Vị trí mà người giám sát lưu giữ tệp pid của nó. Tùy chọn này có thể bao gồm
giá trị % (tại đây) s, mở rộng đến thư mục trong đó cấu hình giám sát
tập tin đã được tìm thấy.

Mặc định: $ CWD / supervisord.pid

Yêu cầu: Không

Giới thiệu: 3.0

cái ô
Mặt nạ của quá trình giám sát.

Mặc định: 022

Yêu cầu: Không

Giới thiệu: 3.0

quái vật
Nếu đúng, người giám sát sẽ bắt đầu ở phía trước thay vì xuất hiện.

Mặc định: sai

Yêu cầu: Không

Giới thiệu: 3.0

minfds
Số lượng bộ mô tả tệp tối thiểu phải có sẵn trước khi người giám sát sẽ
bắt đầu thành công. Một cuộc gọi đến setrlimit sẽ được thực hiện để cố gắng nâng cao giá mềm và
giới hạn cứng của quá trình giám sát để đáp ứng minfds. Giới hạn cứng chỉ có thể là
nâng lên nếu supervisord được chạy dưới dạng root. supervisord sử dụng các trình mô tả tệp một cách tự do, và
sẽ chuyển sang chế độ không thành công khi không thể lấy được từ Hệ điều hành, vì vậy sẽ rất hữu ích khi
có thể chỉ định một giá trị tối thiểu để đảm bảo nó không hết chúng trong quá trình thực thi.
Tùy chọn này đặc biệt hữu ích trên Solaris, có giới hạn fd trên mỗi quy trình thấp bằng
mặc định.

Mặc định: 1024

Yêu cầu: Không

Giới thiệu: 3.0

minprocs
Số lượng bộ mô tả quy trình tối thiểu phải có trước người giám sát
sẽ bắt đầu thành công. Một cuộc gọi đến setrlimit sẽ được thực hiện để cố gắng tăng giá mềm
và các giới hạn cứng của quy trình giám sát để đáp ứng minprocs. Giới hạn cứng có thể
chỉ được nâng lên nếu supervisord được chạy dưới dạng root. giám sát viên sẽ vào chế độ không thành công
khi hệ điều hành hết bộ mô tả quy trình, vì vậy sẽ rất hữu ích khi đảm bảo đủ
bộ mô tả quy trình có sẵn trên người giám sát khởi động

Mặc định: 200

Yêu cầu: Không

Giới thiệu: 3.0

không dọn dẹp
Ngăn người giám sát xóa bất kỳ AUTO tệp nhật ký con tại thời điểm khởi động.
Hữu ích cho việc gỡ lỗi.

Mặc định: sai

Yêu cầu: Không

Giới thiệu: 3.0

nhật ký trẻ em
Thư mục được sử dụng cho AUTO tệp nhật ký con. Tùy chọn này có thể bao gồm giá trị
% (tại đây) s, mở rộng đến thư mục trong đó người giám sát tập tin cấu hình
được tìm thấy.

Mặc định: giá trị của Python tempfile.get_tempdir ()

Yêu cầu: Không

Giới thiệu: 3.0

người sử dụng
Dạy người giám sát để chuyển người dùng sang tài khoản người dùng UNIX này trước khi thực hiện bất kỳ
xử lý có ý nghĩa. Người dùng chỉ có thể được chuyển đổi nếu người giám sát được bắt đầu như
người dùng root. Nếu như người giám sát không thể chuyển đổi người dùng, nó sẽ vẫn tiếp tục nhưng sẽ viết
ghi nhật ký tin nhắn tại quan trọng cấp nói rằng nó không thể giảm đặc quyền.

Mặc định: không chuyển đổi người dùng

Yêu cầu: Không

Giới thiệu: 3.0

thư mục
Thời Gian người giám sát daemonizes, chuyển sang thư mục này. Tùy chọn này có thể bao gồm
giá trị % (tại đây) s, mở rộng đến thư mục trong đó người giám sát cấu hình
tập tin đã được tìm thấy.

Mặc định: không cd

Yêu cầu: Không

Giới thiệu: 3.0

dải_ansi
Loại bỏ tất cả các chuỗi thoát ANSI khỏi các tệp nhật ký con.

Mặc định: sai

Yêu cầu: Không

Giới thiệu: 3.0

môi trường
Danh sách các cặp khóa / giá trị trong biểu mẫu KEY = "val", KEY2 = "val2" cái đó sẽ được đặt trong
người giám sát quy trình 'môi trường (và kết quả là trong tất cả quy trình con của nó'
môi trường). Tùy chọn này có thể bao gồm giá trị % (tại đây) s, mở rộng đến
thư mục chứa tệp cấu hình giám sát được tìm thấy. Các giá trị chứa
các ký tự không phải chữ và số nên được trích dẫn (ví dụ: KEY = "val: 123", KEY2 = "val, 456").
Nếu không, trích dẫn các giá trị là tùy chọn nhưng được khuyến nghị. Để thoát phần trăm
, chỉ cần sử dụng hai ký tự. (ví dụ URI = "/ first %% 20name") Chú thích rằng các quy trình phụ sẽ
kế thừa các biến môi trường của trình bao được sử dụng để bắt đầu người giám sát ngoại trừ
những cái được ghi đè ở đây và trong chương trình môi trường Lựa chọn. Nhìn thấy
môi trường con.

Mặc định: không có giá trị

Yêu cầu: Không

Giới thiệu: 3.0

định danh
Chuỗi định danh cho quá trình giám sát này, được sử dụng bởi giao diện RPC.

Mặc định: người giám sát

Yêu cầu: Không

Giới thiệu: 3.0

[giám sát viên] Phần Ví dụ
[giám sát viên]
logfile = /tmp/supervisord.log
logfile_maxbytes = 50 MB
logfile_backups = 10
loglevel = thông tin
pidfile = /tmp/supervisord.pid
gật đầu = sai
tối thiểu = 1024
tối thiểu = 200
ô = 022
người dùng = chrism
định danh = người giám sát
thư mục = / Tmp
không dọn dẹp = đúng
conlogdir = / Tmp
dải_ansi = sai
môi trường = KEY1 = "value1", KEY2 = "value2"

[giám sát viên] Phần Cài đặt
Tệp cấu hình có thể chứa các cài đặt cho giám sát viên vỏ tương tác
chương trình. Các tùy chọn này được liệt kê bên dưới.

[giám sát viên] Phần Các giá trị
máy chủ
URL sẽ được sử dụng để truy cập máy chủ giám sát, ví dụ:
http://localhost: 9001. Đối với ổ cắm miền UNIX, hãy sử dụng
unix: ///absolute/path/to/file.sock.

Mặc định: http://localhost: 9001

Yêu cầu: Không

Giới thiệu: 3.0

tên truy nhập
Tên người dùng để chuyển đến máy chủ giám sát để sử dụng trong xác thực. Cái này nên
giống như tên truy nhập từ cấu hình máy chủ giám sát cho cổng hoặc UNIX
ổ cắm miền mà bạn đang cố gắng truy cập.

Mặc định: Không có tên người dùng

Yêu cầu: Không

Giới thiệu: 3.0

mật khẩu
Mật khẩu để chuyển đến máy chủ giám sát để sử dụng trong xác thực. Cái này nên
là phiên bản văn bản rõ ràng của mật khẩu từ cấu hình máy chủ giám sát cho
cổng hoặc ổ cắm miền UNIX mà bạn đang cố truy cập. Giá trị này không thể được chuyển thành
một hàm băm SHA. Không giống như các mật khẩu khác được chỉ định trong tệp này, nó phải được cung cấp trong
văn bản rõ ràng.

Mặc định: Không mật khẩu

Yêu cầu: Không

Giới thiệu: 3.0

nhanh chóng
Chuỗi được sử dụng làm lời nhắc supervisorctl.

Mặc định: giám sát

Yêu cầu: Không

Giới thiệu: 3.0

Tập tin lịch sử
Một đường dẫn để sử dụng làm đường dẫn tệp lịch sử liên tục. Nếu bạn bật tính năng này bằng cách
chọn một đường dẫn, các lệnh supervisorctl của bạn sẽ được lưu trong tệp và bạn có thể sử dụng
readline (ví dụ: mũi tên-lên) để gọi các lệnh bạn đã thực hiện trong trình giám sát cuối cùng của mình
phiên.

Mặc định: Không có tập tin

Yêu cầu: Không

Giới thiệu: 3.0a5

[giám sát viên] Phần Ví dụ
[giám sát viên]
serverurl = unix: ///tmp/supervisor.sock
tên người dùng = chris
mật khẩu = 123
dấu nhắc = mysupervisor

[chương trình: x] Phần Cài đặt
Tệp cấu hình phải chứa một hoặc nhiều chương trình các phần để người giám sát
để biết nó nên bắt đầu và kiểm soát những chương trình nào. Giá trị tiêu đề là giá trị tổng hợp.
Đó là từ "chương trình", ngay sau dấu hai chấm, sau đó là tên chương trình. Một tiêu đề
giá trị của [chương trình: foo] mô tả một chương trình có tên là "foo". Tên được sử dụng
bên trong các ứng dụng khách kiểm soát các quy trình được tạo ra do
cấu hình. Đó là một lỗi khi tạo chương trình phần không có tên. Các
tên không được bao gồm ký tự dấu hai chấm hoặc ký tự trong ngoặc. Giá trị của tên là
được sử dụng làm giá trị cho % (program_name) s mở rộng biểu thức chuỗi trong các giá trị khác
nơi được chỉ định.

LƯU Ý:
A [chương trình: x] phần thực sự đại diện cho một "nhóm quy trình đồng nhất" với người giám sát
(kể từ 3.0). Các thành viên của nhóm được xác định bởi sự kết hợp của số lượng
và tên_quy trình các tham số trong cấu hình. Theo mặc định, nếu numprocs và
process_name không thay đổi so với mặc định của chúng, nhóm được đại diện bởi
[chương trình: x] sẽ được đặt tên x và sẽ có một quy trình duy nhất có tên x trong đó. Điều này
cung cấp một phương thức tương thích ngược với các bản phát hành trình giám sát cũ hơn, điều này đã
không coi các phần chương trình là định nghĩa nhóm quy trình đồng nhất.

Nhưng ví dụ, nếu bạn có [chương trình: foo] phần với một số lượng của 3 và a
tên_quy trình biểu hiện của % (program_name) s _% (process_num) 02d, nhóm "foo" sẽ
chứa ba quy trình, được đặt tên foo_00, foo_01và foo_02. Điều này làm cho nó có thể
bắt đầu một số quy trình rất giống nhau bằng cách sử dụng một [chương trình: x] phần. Tất cả các
tên tệp log, tất cả các chuỗi môi trường và lệnh của chương trình cũng có thể chứa
các biểu thức chuỗi Python tương tự, để chuyển các tham số hơi khác nhau cho mỗi
quá trình.

[chương trình: x] Phần Các giá trị
lệnh
Lệnh sẽ được chạy khi chương trình này được khởi động. Lệnh có thể là
tuyệt đối (ví dụ / path / to / programname) hoặc họ hàng (ví dụ: tên chương trình). Nếu nó là
tương đối, môi trường của người giám sát $ PATH sẽ được tìm kiếm tệp thực thi.
Các chương trình có thể chấp nhận các đối số, ví dụ: / path / to / program foo thanh. Dòng lệnh có thể sử dụng
dấu ngoặc kép để nhóm các đối số có khoảng trắng trong chúng để chuyển đến chương trình, ví dụ:
/ path / to / program / name -p "foo quán ba". Lưu ý rằng giá trị của lệnh có thể bao gồm Python
biểu thức chuỗi, ví dụ: / path / to / programname --port = 80% (process_num) 02ngày có thể mở rộng
đến / path / to / programname --port = 8000 trong thời gian chạy. Biểu thức chuỗi được đánh giá
chống lại một từ điển có chứa các khóa tên nhóm, tên máy chủ_node_name, số quy trình,
tên chương trình, tại đây (thư mục của tệp cấu hình giám sát) và tất cả
Các biến môi trường của supervisord có tiền tố là ENV_. Các chương trình được kiểm soát phải
bản thân chúng không phải là daemon, vì người giám sát cho rằng nó có trách nhiệm làm daemonizing
các quy trình con (xem nondaemonizing_of_subprocesses).

Mặc định: Không có mặc định.

Yêu cầu: Có.

Giới thiệu: 3.0

tên_quy trình
Một biểu thức chuỗi Python được sử dụng để soạn tên quy trình người giám sát cho điều này
tiến trình. Bạn thường không cần lo lắng về việc cài đặt điều này trừ khi bạn thay đổi
số lượng. Biểu thức chuỗi được đánh giá dựa trên từ điển bao gồm
tên nhóm, tên máy chủ_node_name, số quy trình, tên chương trìnhvà tại đây (thư mục của
tệp cấu hình giám sát).

Mặc định: % (program_name) s

Yêu cầu: Không

Giới thiệu: 3.0

số lượng
Người giám sát sẽ bắt đầu bao nhiêu phiên bản của chương trình này theo tên của numprocs. Ghi chú
rằng nếu numprocs> 1, tên_quy trình biểu thức phải bao gồm % (process_num) s (hoặc bất kỳ
biểu thức chuỗi Python hợp lệ khác bao gồm số quy trình) bên trong nó.

Mặc định: 1

Yêu cầu: Không

Giới thiệu: 3.0

numrocs_start
Phần bù số nguyên được sử dụng để tính số số lượng bắt đầu.

Mặc định: 0

Yêu cầu: Không

Giới thiệu: 3.0

ưu tiên
Mức độ ưu tiên tương đối của chương trình trong thứ tự bắt đầu và tắt máy. Thấp hơn
mức độ ưu tiên cho biết các chương trình khởi động trước và tắt sau cùng khi khởi động và khi nào
các lệnh tổng hợp được sử dụng trong các máy khách khác nhau (ví dụ: "bắt đầu tất cả" / "dừng tất cả"). Cao hơn
ưu tiên cho biết các chương trình khởi động sau cùng và tắt trước.

Mặc định: 999

Yêu cầu: Không

Giới thiệu: 3.0

autostart
Nếu đúng, chương trình này sẽ tự động bắt đầu khi người giám sát được khởi động.

Mặc định: thật

Yêu cầu: Không

Giới thiệu: 3.0

startecs
Tổng số giây mà chương trình cần để tiếp tục chạy sau khi khởi động
coi sự khởi đầu thành công (chuyển quá trình từ BẮT ĐẦU trạng thái
ĐANG CHẠY tiểu bang). Đặt thành 0 để chỉ ra rằng chương trình không cần tiếp tục chạy cho bất kỳ
khoảng thời gian cụ thể.

LƯU Ý:
Ngay cả khi một quy trình thoát với mã thoát "dự kiến" (xem lối ra), bắt đầu
sẽ vẫn bị coi là thất bại nếu quá trình thoát nhanh hơn startecs.

Mặc định: 1

Yêu cầu: Không

Giới thiệu: 3.0

sự khởi đầu
Số lần thất bại nối tiếp người giám sát sẽ cho phép khi cố gắng
bắt đầu chương trình trước khi từ bỏ và đưa quy trình vào một Fatal tiểu bang. Nhìn thấy
process_states để giải thích về Fatal nhà nước.

Mặc định: 3

Yêu cầu: Không

Giới thiệu: 3.0

Khởi động lại tự động
Chỉ định nếu người giám sát sẽ tự động khởi động lại quá trình nếu nó thoát ra khi
trong ĐANG CHẠY tiểu bang. Có thể là một trong số sai, bất ngờ, hoặc là đúng. Nếu sai, quá trình
sẽ không được tự động khởi động lại. Nếu như bất ngờ, quá trình sẽ được bắt đầu lại khi
chương trình thoát với mã thoát không phải là một trong những mã thoát được liên kết với
cấu hình process '(xem lối ra). Nếu đúng, quá trình này sẽ vô điều kiện
khởi động lại khi nó thoát mà không liên quan đến mã thoát của nó.

LƯU Ý:
Khởi động lại tự động kiểm soát liệu người giám sát sẽ tự động khởi động lại một chương trình nếu nó thoát
sau khi nó đã khởi động thành công (quá trình này diễn ra trong ĐANG CHẠY tiểu bang).

người giám sát có một cơ chế khởi động lại khác khi quá trình bắt đầu
(quá trình này diễn ra trong BẮT ĐẦU tiểu bang). Thử lại trong quá trình khởi động là
điều khiển bởi startecs và sự khởi đầu.

Mặc định: bất ngờ

Yêu cầu: Không

Giới thiệu: 3.0

lối ra
Danh sách các mã thoát "dự kiến" cho chương trình này được sử dụng với Khởi động lại tự động. Nếu
Khởi động lại tự động tham số được đặt thành bất ngờvà quá trình thoát ra theo bất kỳ cách nào khác ngoài
do yêu cầu dừng của người giám sát, người giám sát sẽ khởi động lại quá trình nếu nó
thoát bằng mã thoát không được xác định trong danh sách này.

Mặc định: 0,2

Yêu cầu: Không

Giới thiệu: 3.0

điểm dừng
Tín hiệu dùng để ngắt chương trình khi yêu cầu dừng. Đây có thể là bất kỳ TERM nào,
HUP, INT, QUIT, KILL, USR1 hoặc USR2.

Mặc định: THUẬT NGỮ

Yêu cầu: Không

Giới thiệu: 3.0

dừng chờ đợi
Số giây chờ hệ điều hành trả về một SIGCHILD cho người giám sát sau
chương trình đã được gửi một tín hiệu dừng. Nếu số giây này trôi qua trước
người giám sát nhận được một SIGCHILD từ quy trình, người giám sát sẽ cố gắng giết nó
với một SIGKILL cuối cùng.

Mặc định: 10

Yêu cầu: Không

Giới thiệu: 3.0

nhóm dừng
Nếu đúng, cờ khiến người giám sát gửi tín hiệu dừng cho toàn bộ nhóm quy trình
và ngụ ý nhóm sát thủ là đúng. Điều này rất hữu ích cho các chương trình, chẳng hạn như Flask trong gỡ lỗi
chế độ đó không tuyên truyền các tín hiệu dừng lại cho con cái của họ, khiến chúng trở nên mồ côi.

Mặc định: sai

Yêu cầu: Không

Giới thiệu: 3.0b1

nhóm sát thủ
Nếu đúng, khi gửi SIGKILL đến chương trình để kết thúc chương trình, hãy gửi nó đến
thay vào đó, toàn bộ nhóm quy trình, cũng chăm sóc con cái của họ, chẳng hạn như với
Các chương trình Python sử dụng đa xử lý.

Mặc định: sai

Yêu cầu: Không

Giới thiệu: 3.0a11

người sử dụng
Dạy người giám sát để sử dụng tài khoản người dùng UNIX này làm tài khoản chạy
chương trình. Người dùng chỉ có thể được chuyển đổi nếu người giám sát được chạy với tư cách người dùng root. Nếu như
người giám sát không thể chuyển sang người dùng được chỉ định, chương trình sẽ không được bắt đầu.

LƯU Ý:
Người dùng sẽ được thay đổi bằng cách sử dụng cài đặt thời gian chỉ một. Điều này không bắt đầu một trình bao đăng nhập và
không thay đổi các biến môi trường như USER or TRANG CHỦ. Thấy
subprocess_enosystem để biết chi tiết.

Mặc định: Không chuyển đổi người dùng

Yêu cầu: Không

Giới thiệu: 3.0

chuyển hướng_stderr
Nếu đúng, làm cho đầu ra trình tự lệnh của quy trình được gửi trở lại người giám sát trên stdout của nó
bộ mô tả tệp (trong thuật ngữ trình bao UNIX, điều này tương đương với việc thực thi /chương trình
2> & 1).

LƯU Ý:
Không đặt redirect_stderr = true trong một [eventlistener: x] phần. Người tổ chức sự kiện
sử dụng tiêu chuẩn và tiêu chuẩn giao tiếp với người giám sát. Nếu tiêu chuẩn được chuyển hướng,
sản lượng từ tiêu chuẩn sẽ can thiệp vào giao thức eventlistener.

Mặc định: sai

Yêu cầu: Không

Giới thiệu: 3.0, thay thế 2.0 log_stdout và log_stderr

thiết bị xuất chuẩn_logfile
Đặt đầu ra quy trình stdout trong tệp này (và nếu redirect_stderr là true, hãy đặt
đầu ra stderr trong tệp này). Nếu như thiết bị xuất chuẩn_logfile chưa được đặt hoặc được đặt thành AUTO, người giám sát
sẽ tự động chọn một vị trí tệp. Nếu điều này được đặt thành NONE, giám sát viên sẽ
không tạo tệp nhật ký. AUTO các tệp nhật ký và các bản sao lưu của chúng sẽ bị xóa khi người giám sát
khởi động lại. Các thiết bị xuất chuẩn_logfile giá trị có thể chứa các biểu thức chuỗi Python sẽ
được đánh giá dựa trên từ điển có chứa các khóa tên nhóm, tên máy chủ_node_name,
số quy trình, tên chương trìnhvà tại đây (thư mục của tệp cấu hình giám sát).

LƯU Ý:
Không thể cho hai quá trình chia sẻ một tệp nhật ký (thiết bị xuất chuẩn_logfile)
khi xoay (thiết bị xuất chuẩn_logfile_maxbytes) được kích hoạt. Điều này sẽ dẫn đến tệp
bị hỏng.

Mặc định: AUTO

Yêu cầu: Không

Giới thiệu: 3.0, thay thế 2.0 tệp nhật ký

thiết bị xuất chuẩn_logfile_maxbytes
Số byte tối đa có thể được sử dụng thiết bị xuất chuẩn_logfile trước khi nó được xoay
(Các hệ số hậu tố như "KB", "MB" và "GB" có thể được sử dụng trong giá trị). Đặt cái này
giá trị thành 0 để cho biết kích thước nhật ký không giới hạn.

Mặc định: 50 MB

Yêu cầu: Không

Giới thiệu: 3.0, thay thế 2.0 logfile_maxbytes

thiết bị xuất chuẩn_logfile_backups
Số lượng thiết bị xuất chuẩn_logfile các bản sao lưu để lưu lại từ nhật ký xử lý quy trình
xoay tệp. Nếu được đặt thành 0, sẽ không có bản sao lưu nào được giữ lại.

Mặc định: 10

Yêu cầu: Không

Giới thiệu: 3.0, thay thế 2.0 logfile_backups

thiết bị xuất chuẩn_capture_maxbytes
Số byte tối đa được ghi để nắm bắt FIFO khi quá trình ở "chế độ chụp stdout"
(xem chế độ chụp). Phải là số nguyên (hệ số hậu tố như "KB", "MB" và "GB"
có thể được sử dụng trong giá trị). Nếu giá trị này là 0, chế độ chụp quá trình sẽ tắt.

Mặc định: 0

Yêu cầu: Không

Giới thiệu: 3.0, thay thế 2.0 logfile_backups

thiết bị xuất chuẩn_events_enabled
Nếu đúng, các sự kiện PROCESS_LOG_STDOUT sẽ được phát ra khi quá trình ghi vào
trình mô tả tệp stdout. Các sự kiện sẽ chỉ được phát ra nếu trình mô tả tệp không phải là
ở chế độ chụp tại thời điểm nhận dữ liệu (xem chế độ chụp).

Mặc định: 0

Yêu cầu: Không

Giới thiệu: 3.0a7

stderr_logfile
Đặt đầu ra trình mã quy trình trong tệp này trừ khi chuyển hướng_stderr là đúng. Chấp nhận
các loại giá trị giống như thiết bị xuất chuẩn_logfile và có thể chứa các biểu thức chuỗi Python giống nhau.

LƯU Ý:
Không thể cho hai quá trình chia sẻ một tệp nhật ký (stderr_logfile)
khi xoay (stderr_logfile_maxbytes) được kích hoạt. Điều này sẽ dẫn đến tệp
bị hỏng.

Mặc định: AUTO

Yêu cầu: Không

Giới thiệu: 3.0

stderr_logfile_maxbytes
Số byte tối đa trước khi xoay tệp log cho stderr_logfile. Chấp nhận
các loại giá trị giống như thiết bị xuất chuẩn_logfile_maxbytes.

Mặc định: 50 MB

Yêu cầu: Không

Giới thiệu: 3.0

stderr_logfile_backups
Số lượng bản sao lưu cần giữ lại từ quá trình xoay tệp nhật ký trình stderr.
Nếu được đặt thành 0, sẽ không có bản sao lưu nào được giữ lại.

Mặc định: 10

Yêu cầu: Không

Giới thiệu: 3.0

stderr_capture_maxbytes
Số byte tối đa được ghi để nắm bắt FIFO khi quy trình ở "chế độ chụp trình tự"
(xem chế độ chụp). Phải là số nguyên (hệ số hậu tố như "KB", "MB" và "GB"
có thể được sử dụng trong giá trị). Nếu giá trị này là 0, chế độ chụp quá trình sẽ tắt.

Mặc định: 0

Yêu cầu: Không

Giới thiệu: 3.0

stderr_events_enabled
Nếu đúng, các sự kiện PROCESS_LOG_STDERR sẽ được phát ra khi quá trình ghi vào
trình mô tả tệp stderr. Các sự kiện sẽ chỉ được phát ra nếu trình mô tả tệp không phải là
ở chế độ chụp tại thời điểm nhận dữ liệu (xem chế độ chụp).

Mặc định: sai

Yêu cầu: Không

Giới thiệu: 3.0a7

môi trường
Danh sách các cặp khóa / giá trị trong biểu mẫu KEY = "val", KEY2 = "val2" cái đó sẽ được đặt trong
môi trường xử lý con. Chuỗi môi trường có thể chứa chuỗi Python
các biểu thức sẽ được đánh giá dựa trên từ điển chứa tên nhóm,
tên máy chủ_node_name, số quy trình, tên chương trìnhvà tại đây (thư mục của người giám sát
tập tin cấu hình). Các giá trị chứa các ký tự không phải chữ và số phải được trích dẫn (ví dụ:
KEY = "val: 123", KEY2 = "val, 456"). Nếu không, trích dẫn các giá trị là tùy chọn nhưng
khuyến khích. Chú thích rằng quy trình con sẽ kế thừa các biến môi trường của
shell được sử dụng để bắt đầu "supervisord" ngoại trừ những cái được ghi đè ở đây. Nhìn thấy
môi trường con.

Mặc định: Không có thêm môi trường

Yêu cầu: Không

Giới thiệu: 3.0

thư mục
Đường dẫn tệp đại diện cho một thư mục mà người giám sát nên tạm thời chdir
trước khi hành quyết đứa trẻ.

Mặc định: Không có chdir (người giám sát kế thừa)

Yêu cầu: Không

Giới thiệu: 3.0

cái ô
Một số bát phân (ví dụ: 002, 022) đại diện cho umask của quá trình.

Mặc định: Không có umask đặc biệt (kế thừa của người giám sát)

Yêu cầu: Không

Giới thiệu: 3.0

máy chủ
URL được chuyển trong môi trường tới quy trình xử lý con dưới dạng SUPERVISOR_SERVER_URL
(xem người giám sát.childutils) để cho phép quy trình con dễ dàng giao tiếp với
máy chủ HTTP nội bộ. Nếu được cung cấp, nó phải có cùng cú pháp và cấu trúc như
[giám sát viên] tùy chọn phần cùng tên. Nếu cài đặt này được đặt thành TỰ ĐỘNG hoặc không được đặt,
người giám sát sẽ tự động tạo URL máy chủ, ưu tiên cho máy chủ
nghe trên ổ cắm miền UNIX trên ổ cắm nghe trên ổ cắm internet.

Mặc định: TỰ ĐỘNG

Yêu cầu: Không

Giới thiệu: 3.0

[chương trình: x] Phần Ví dụ
[chương trình: cat]
lệnh =/ bin / cat
process_name =% (program_name) s
numprocs = 1
thư mục =/ Tmp
umask = 022
ưu tiên = 999
autostart = true
autorestart = bất ngờ
số lần bắt đầu = 10
startretries = 3
exitcodes = 0,2
stopignal = TERM
stopwaitsecs = 10
stopasgroup = false
killasgroup = false
user = chrism
redirect_stderr = false
stdout_logfile = / a / đường dẫn
stdout_logfile_maxbytes = 1MB
stdout_logfile_backups = 10
stdout_capture_maxbytes = 1MB
stdout_events_enabled = false
stderr_logfile = / a / đường dẫn
stderr_logfile_maxbytes = 1MB
stderr_logfile_backups = 10
stderr_capture_maxbytes = 1MB
stderr_events_enabled = false
môi trường = A = "1", B = "2"
serverurl = AUTO

[bao gồm] Phần Cài đặt
Sản phẩm giám sát.conf tệp có thể chứa một phần có tên [bao gồm]. Nếu cấu hình
tệp chứa một [bao gồm] , nó phải chứa một khóa duy nhất có tên là "tệp". Các
các giá trị trong khóa này chỉ định các tệp cấu hình khác được bao gồm trong
cấu hình.

[bao gồm] Phần Các giá trị
các tập tin
Một chuỗi tệp tin được phân tách bằng dấu cách. Mỗi tập tin toàn cầu có thể là tuyệt đối hoặc tương đối.
Nếu tập tin toàn cầu là tương đối, nó được coi là liên quan đến vị trí của
tập tin cấu hình bao gồm nó. "Hình cầu" là một mẫu tệp phù hợp với
mẫu được chỉ định theo các quy tắc được sử dụng bởi Unix shell. Không có dấu ngã mở rộng là
xong, nhưng *, ?và các phạm vi ký tự được biểu thị bằng [] sẽ được đối sánh chính xác.
Bao gồm đệ quy từ các tệp được bao gồm không được hỗ trợ.

Mặc định: Không có mặc định (bắt buộc)

Yêu cầu: Có.

Giới thiệu: 3.0

[bao gồm] Phần Ví dụ
[bao gồm]
files = /an/absolute/filename.conf /an/absolute/*.conf foo.conf config ??. conf

[nhóm: x] Phần Cài đặt
Thường hữu ích khi nhóm các nhóm quy trình "đồng nhất" (còn gọi là "chương trình") với nhau thành một
nhóm quy trình "không đồng nhất" để chúng có thể được kiểm soát như một đơn vị từ Giám sát của
nhiều giao diện điều khiển khác nhau.

Để đặt các chương trình vào một nhóm để bạn có thể coi chúng như một đơn vị, hãy xác định [nhóm: x] phần
trong tệp cấu hình của bạn. Giá trị tiêu đề nhóm là một hỗn hợp. Nó là từ
"nhóm", theo sau ngay sau dấu hai chấm, sau đó là tên nhóm. Giá trị tiêu đề của [nhóm: foo]
mô tả một nhóm có tên là "foo". Tên được sử dụng trong các ứng dụng khách
kiểm soát các quá trình được tạo ra từ cấu hình này. Nó là một
lỗi tạo ra một nhóm phần không có tên. Tên không được bao gồm
ký tự dấu hai chấm hoặc ký tự trong ngoặc.

Đối với một [nhóm: x], phải có một hoặc nhiều [chương trình: x] các phần khác trong
tệp cấu hình và nhóm phải tham chiếu đến chúng theo tên trong chương trình giá trị.

Nếu các nhóm quy trình "đồng nhất" (được đại diện bởi các phần chương trình) được đặt vào một
nhóm "không đồng nhất" qua [nhóm: x] phần của chương trình dòng, các nhóm đồng nhất
được ngụ ý bởi phần chương trình sẽ không tồn tại trong thời gian chạy trong trình giám sát. Thay vào đó, tất cả
các quy trình thuộc từng nhóm đồng nhất sẽ được đặt vào
nhóm không đồng nhất. Ví dụ: với cấu hình nhóm sau:

[nhóm: foo]
chương trình = bar, baz
ưu tiên = 999

Với những điều trên, khi khởi động supervisord, thanh và căn cứ các nhóm đồng nhất sẽ không
tồn tại và các quy trình mà lẽ ra theo đó sẽ được chuyển vào foo
nhóm.

[nhóm: x] Phần Các giá trị
chương trình
Danh sách tên chương trình được phân tách bằng dấu phẩy. Các chương trình được liệt kê trở thành thành viên
của nhóm.

Mặc định: Không có mặc định (bắt buộc)

Yêu cầu: Có.

Giới thiệu: 3.0

ưu tiên
Một số ưu tiên tương tự như một [chương trình: x] giá trị ưu tiên được gán cho nhóm.

Mặc định: 999

Yêu cầu: Không

Giới thiệu: 3.0

[nhóm: x] Phần Ví dụ
[nhóm: foo]
chương trình = bar, baz
ưu tiên = 999

[fcgi-program: x] Phần Cài đặt
Người giám sát có thể quản lý các nhóm NhanhCGI tất cả các quy trình đều lắng nghe trên cùng một ổ cắm.
Cho đến nay, tính linh hoạt khi triển khai cho FastCGI còn hạn chế. Để có được quy trình đầy đủ
quản lý, bạn có thể sử dụng mod_fastcgi trong Apache nhưng sau đó bạn gặp khó khăn với Apache's
mô hình đồng thời không hiệu quả của một quy trình hoặc luồng trên mỗi kết nối. Ngoài
yêu cầu nhiều tài nguyên CPU và bộ nhớ hơn, quy trình / luồng trên mỗi mô hình kết nối có thể
nhanh chóng bị bão hòa bởi một tài nguyên chậm, ngăn không cho các tài nguyên khác được phục vụ. Trong
để tận dụng các máy chủ web hướng sự kiện mới hơn như lighttpd hoặc nginx
không bao gồm trình quản lý quy trình tích hợp sẵn, bạn phải sử dụng các tập lệnh như cgi-fcgi hoặc
đẻ trứng-fcgi. Chúng có thể được sử dụng cùng với một người quản lý quy trình như giám sát viên
hoặc daemontools nhưng yêu cầu mỗi tiến trình con FastCGI liên kết với ổ cắm riêng của nó. Các
nhược điểm của điều này là: cấu hình máy chủ web phức tạp không cần thiết, không theo thứ tự
khởi động lại và giảm khả năng chịu lỗi. Với ít ổ cắm hơn để định cấu hình, máy chủ web
cấu hình sẽ nhỏ hơn nhiều nếu các nhóm quy trình FastCGI có thể chia sẻ các ổ cắm. Được chia sẻ
sockets cho phép khởi động lại dễ dàng vì socket vẫn bị ràng buộc bởi quy trình mẹ
trong khi bất kỳ quy trình con nào đang được khởi động lại. Cuối cùng, các ổ cắm được chia sẻ nhiều hơn
khả năng chịu lỗi vì nếu một quy trình nhất định không thành công, các quy trình khác có thể tiếp tục phục vụ
kết nối trong nước.

Với hỗ trợ sinh sản FastCGI tích hợp, Supervisor cung cấp cho bạn những gì tốt nhất của cả hai thế giới.
Bạn nhận được quản lý quy trình đầy đủ tính năng với các nhóm ổ cắm chia sẻ quy trình FastCGI
mà không bị ràng buộc với một máy chủ web cụ thể. Đó là sự tách biệt rõ ràng về các mối quan tâm,
cho phép máy chủ web và người quản lý quy trình làm những gì họ làm tốt nhất.

LƯU Ý:
Trình quản lý ổ cắm trong Người giám sát ban đầu được phát triển để hỗ trợ các quy trình FastCGI
nhưng nó không giới hạn ở FastCGI. Các giao thức khác cũng có thể được sử dụng mà không cần đặc biệt
cấu hình. Bất kỳ chương trình nào có thể truy cập một ổ cắm mở từ bộ mô tả tệp (ví dụ:
với socket.fromfd bằng Python) có thể sử dụng trình quản lý ổ cắm. Người giám sát sẽ
tự động tạo ổ cắm, liên kết và lắng nghe trước khi phân nhánh đứa trẻ đầu tiên trong một
tập đoàn. Ổ cắm sẽ được chuyển cho từng đứa trẻ trên số bộ mô tả tệp 0 (số không).
Khi trẻ cuối cùng trong nhóm thoát ra ngoài, Người giám sát sẽ đóng ổ cắm.

Tất cả các tùy chọn có sẵn cho [chương trình: x] các phần cũng được tôn trọng bởi chương trình fcgi
phần.

[fcgi-program: x] Phần Các giá trị
[fcgi-program: x] các phần có một khóa duy nhất [chương trình: x] phần không có.

ổ cắm
Ổ cắm FastCGI cho chương trình này, ổ cắm miền TCP hoặc UNIX. Đối với ổ cắm TCP,
sử dụng định dạng này: tcp: // localhost: 9002. Đối với ổ cắm miền UNIX, hãy sử dụng
unix: ///absolute/path/to/file.sock. Biểu thức chuỗi được đánh giá dựa trên
từ điển có chứa các khóa "program_name" và "here" (thư mục của
tệp cấu hình giám sát).

Mặc định: Không có mặc định.

Yêu cầu: Có.

Giới thiệu: 3.0

ổ cắm_chủ sở hữu
Đối với ổ cắm miền UNIX, tham số này có thể được sử dụng để chỉ định người dùng và nhóm cho
ổ cắm FastCGI. Có thể là tên người dùng UNIX (ví dụ: chrism) hoặc tên người dùng và nhóm UNIX
ngăn cách bằng dấu hai chấm (ví dụ: chrism: bánh xe).

Mặc định: Sử dụng nhóm người dùng và nhóm cho chương trình fcgi

Yêu cầu: Không

Giới thiệu: 3.0

chế độ ổ cắm
Đối với ổ cắm miền UNIX, tham số này có thể được sử dụng để chỉ định chế độ quyền.

Mặc định: 0700

Yêu cầu: Không

Giới thiệu: 3.0

Tư vấn [chương trình: x] Phần Cài đặt đối với các khóa cho phép khác, xóa các ràng buộc trên
và bổ sung.

[fcgi-program: x] Phần Ví dụ
[fcgi-program: fcgiprogramname]
lệnh = / usr / bin / example.fcgi
socket = unix: /// var / run / supervisor /% (program_name) s.sock
socket_owner = chrism
socket_mode = 0700
process_name =% (program_name) s _% (process_num) 02d
numprocs = 5
thư mục =/ Tmp
umask = 022
ưu tiên = 999
autostart = true
autorestart = bất ngờ
số lần bắt đầu = 1
startretries = 3
exitcodes = 0,2
stopignal = QUIT
stopasgroup = false
killasgroup = false
stopwaitsecs = 10
user = chrism
redirect_stderr = true
stdout_logfile = / a / đường dẫn
stdout_logfile_maxbytes = 1MB
stdout_logfile_backups = 10
stdout_events_enabled = false
stderr_logfile = / a / đường dẫn
stderr_logfile_maxbytes = 1MB
stderr_logfile_backups = 10
stderr_events_enabled = false
môi trường = A = "1", B = "2"
serverurl = AUTO

[eventlistener: x] Phần Cài đặt
Người giám sát cho phép các nhóm quy trình đồng nhất chuyên biệt ("nhóm xử lý sự kiện") được
được xác định trong tệp cấu hình. Các nhóm này chứa các quy trình nhằm mục đích
nhận và phản hồi các thông báo sự kiện từ hệ thống sự kiện của người giám sát. Xem các sự kiện cho
giải thích về cách các sự kiện hoạt động và cách triển khai các chương trình có thể được khai báo là
người nghe sự kiện.

Lưu ý rằng tất cả các tùy chọn có sẵn cho [chương trình: x] phần được tôn trọng bởi eventlistener
phần ngoại trừ cho thiết bị xuất chuẩn_capture_maxbytes và stderr_capture_maxbytes (người nghe sự kiện
không thể phát ra các sự kiện giao tiếp quá trình, xem capture_mode).

[eventlistener: x] Phần Các giá trị
[eventlistener: x] các phần có một vài phím mà [chương trình: x] phần không có.

đệm_size
Kích thước bộ đệm hàng đợi sự kiện của nhóm xử lý sự kiện. Khi bộ đệm sự kiện của nhóm người nghe
bị tràn (có thể xảy ra khi nhóm trình xử lý sự kiện không thể theo kịp tất cả
sự kiện được gửi đến nó), sự kiện cũ nhất trong bộ đệm sẽ bị loại bỏ.

sự kiện
Danh sách tên loại sự kiện được phân tách bằng dấu phẩy mà người nghe này "quan tâm"
nhận thông báo cho (xem event_types để biết danh sách các tên loại sự kiện hợp lệ).

result_handler
A pkg_resource nhập điểm chuỗi phân giải thành một Python có thể gọi được. Mặc định
giá trị là supervisor.dispatchers: default_handler. Chỉ định một kết quả thay thế
xử lý là một việc rất không phổ biến cần phải làm, và do đó, cách tạo một trình xử lý là
không được ghi lại.

Tư vấn [chương trình: x] Phần Cài đặt đối với các khóa cho phép khác, xóa các ràng buộc trên
và bổ sung.

[eventlistener: x] Phần Ví dụ
[eventlistener: theeventlistenername]
command = / bin / eventlistener
process_name =% (program_name) s _% (process_num) 02d
numprocs = 5
sự kiện = PROCESS_STATE
buffer_size = 10
thư mục =/ Tmp
umask = 022
ưu tiên = -1
autostart = true
autorestart = bất ngờ
số lần bắt đầu = 1
startretries = 3
exitcodes = 0,2
stopignal = QUIT
stopwaitsecs = 10
stopasgroup = false
killasgroup = false
user = chrism
redirect_stderr = false
stdout_logfile = / a / đường dẫn
stdout_logfile_maxbytes = 1MB
stdout_logfile_backups = 10
stdout_events_enabled = false
stderr_logfile = / a / đường dẫn
stderr_logfile_maxbytes = 1MB
stderr_logfile_backups = 10
stderr_events_enabled = false
môi trường = A = "1", B = "2"
serverurl = AUTO

[rpcinterface: x] Phần Cài đặt
Thêm rpcinterface: x cài đặt trong tệp cấu hình chỉ hữu ích cho những người
muốn mở rộng người giám sát với hành vi tùy chỉnh bổ sung.

Trong tệp cấu hình mẫu, có một phần được đặt tên là [rpcinterface: supervisor].
Theo mặc định, nó trông giống như sau.

[rpcinterface: supervisor]
supervisor.rpcinterface_factory = supervisor.rpcinterface: make_main_rpcinterface

Sản phẩm [rpcinterface: supervisor] phần phải vẫn ở trong cấu hình cho tiêu chuẩn
thiết lập người giám sát để hoạt động tốt. Nếu bạn không muốn người giám sát làm bất cứ điều gì
chưa hoạt động hiệu quả, đây là tất cả những gì bạn cần biết về loại
phần.

Tuy nhiên, nếu bạn muốn thêm không gian tên giao diện rpc để tùy chỉnh trình giám sát, bạn
có thể bổ sung thêm [rpcinterface: foo] phần, trong đó "foo" đại diện cho không gian tên của
giao diện (từ web gốc) và giá trị được đặt tên bởi người giám sát.rpcinterface_factory
là một nhà máy có thể gọi mà phải có một chữ ký hàm chấp nhận một
đối số vị trí người giám sát và nhiều đối số từ khóa theo yêu cầu để thực hiện
cấu hình. Bất kỳ cặp khóa / giá trị bổ sung nào được xác định trong [rpcinterface: x] phần sẽ
được chuyển dưới dạng đối số từ khóa đến nhà máy.

Đây là một ví dụ về một hàm gốc, được tạo trong __init__.py tệp Python
gói gói của tôi.

từ my.package.rpcinterface nhập AnotherRPCInterface

def make_aosystem_rpcinterface (supervisord, ** config):
retries = int (config.get ('retries', 0))
another_rpc_interface = AnotherRPCInterface (người giám sát, thử lại)
trả về another_rpc_interface

Và một phần trong tệp cấu hình có nghĩa là để cấu hình nó.

[rpcinterface: another]
supervisor.rpcinterface_factory = my.package: make_aosystem_rpcinterface
số lần thử lại = 1

[rpcinterface: x] Phần Các giá trị
người giám sát.rpcinterface_factory
pkg_resource "entry point" tên có dấu chấm cho chức năng xuất xưởng của giao diện RPC của bạn.

Mặc định: Không áp dụng

Yêu cầu: Không

Giới thiệu: 3.0

[rpcinterface: x] Phần Ví dụ
[rpcinterface: another]
supervisor.rpcinterface_factory = my.package: make_aosystem_rpcinterface
số lần thử lại = 1

Thuật ngữ
daemontools
A quá trình điều khiển hệ thống by DJ Bernstein.

khởi động
A quá trình điều khiển hệ thống đã sử dụng by Apple như quy trình 1 trong Mac OS X.

runit A quá trình điều khiển hệ thống.

Siêu cấp
Một gói cung cấp các triển khai trình xử lý sự kiện khác nhau cắm vào
Người giám sát có thể giúp giám sát việc sử dụng bộ nhớ của quá trình và trạng thái sự cố:
http://pypi.python.org/pypi/superlance.

cái ô Viết tắt của người sử dụng mặt nạ: đặt mặt nạ tạo chế độ tệp của tiến trình hiện tại.
Xem http://en.wikipedia.org/wiki/Umask.

Sử dụng echo_supervisord_conf trực tuyến bằng các dịch vụ onworks.net