Mô -đun này cung cấp một giao diện cho các thói quen thư viện UNIX syslog
. Tham khảo các trang hướng dẫn UNIX để biết mô tả chi tiết về cơ sở syslog
.
Mô -đun này kết thúc gia đình các thói quen syslog
. Một thư viện Python thuần túy có thể nói chuyện với máy chủ Syslog có sẵn trong mô -đun logging.handlers
là SysLogHandler
.
Tính khả dụng: Không phải emscripten, không phải wasi.: not Emscripten, not WASI.
Mô -đun này không hoạt động hoặc không có sẵn trên các nền tảng Webassugging wasm32-emscripten
và wasm32-wasi
. Xem các nền tảng Webassugging để biết thêm thông tin.WebAssembly platforms for more information.
Mô -đun xác định các chức năng sau:
syslog.syslog [tin nhắn] ¶ syslog.syslog [ưu tiên, tin nhắn]syslog[message]¶ syslog.syslog[priority, message]Gửi thông báo chuỗi đến bộ ghi hệ thống. Một dòng mới được thêm vào nếu cần thiết. Mỗi tin nhắn được gắn thẻ ưu tiên bao gồm một cơ sở và một cấp độ. Đối số ưu tiên tùy chọn, mặc định là LOG_INFO
, xác định mức độ ưu tiên của thông báo. Nếu cơ sở không được mã hóa ở mức độ ưu tiên bằng cách sử dụng logic-hoặc [____10], giá trị được đưa ra trong cuộc gọi
syslog.openlog[logoption=syslog.LOG_PID, facility=syslog.LOG_MAIL] syslog.syslog['E-mail processing initiated...']1 được sử dụng.
Nếu
syslog.openlog[logoption=syslog.LOG_PID, facility=syslog.LOG_MAIL] syslog.syslog['E-mail processing initiated...']1 chưa được gọi trước cuộc gọi đến
syslog.openlog[logoption=syslog.LOG_PID, facility=syslog.LOG_MAIL] syslog.syslog['E-mail processing initiated...']3,
syslog.openlog[logoption=syslog.LOG_PID, facility=syslog.LOG_MAIL] syslog.syslog['E-mail processing initiated...']1 sẽ được gọi mà không có đối số.
Tăng một sự kiện kiểm toán
syslog.openlog[logoption=syslog.LOG_PID, facility=syslog.LOG_MAIL] syslog.syslog['E-mail processing initiated...']5 với các đối số
syslog.openlog[logoption=syslog.LOG_PID, facility=syslog.LOG_MAIL] syslog.syslog['E-mail processing initiated...']6,
syslog.openlog[logoption=syslog.LOG_PID, facility=syslog.LOG_MAIL] syslog.syslog['E-mail processing initiated...']7.auditing event
syslog.openlog[logoption=syslog.LOG_PID, facility=syslog.LOG_MAIL] syslog.syslog['E-mail processing initiated...']5 with arguments
syslog.openlog[logoption=syslog.LOG_PID, facility=syslog.LOG_MAIL] syslog.syslog['E-mail processing initiated...']6,
syslog.openlog[logoption=syslog.LOG_PID, facility=syslog.LOG_MAIL] syslog.syslog['E-mail processing initiated...']7.
Đã thay đổi trong phiên bản 3.2: Trong các phiên bản trước, syslog.openlog[logoption=syslog.LOG_PID, facility=syslog.LOG_MAIL]
syslog.syslog['E-mail processing initiated...']
1 sẽ không được gọi tự động nếu nó được gọi trước khi gọi đến syslog.openlog[logoption=syslog.LOG_PID, facility=syslog.LOG_MAIL]
syslog.syslog['E-mail processing initiated...']
3, trì hoãn việc triển khai Syslog để gọi syslog.openlog[logoption=syslog.LOG_PID, facility=syslog.LOG_MAIL]
syslog.syslog['E-mail processing initiated...']
1.In previous versions,
syslog.openlog[logoption=syslog.LOG_PID, facility=syslog.LOG_MAIL] syslog.syslog['E-mail processing initiated...']1 would not be called automatically if it wasn’t called prior to the call to
syslog.openlog[logoption=syslog.LOG_PID, facility=syslog.LOG_MAIL] syslog.syslog['E-mail processing initiated...']3, deferring to the syslog implementation to call
syslog.openlog[logoption=syslog.LOG_PID, facility=syslog.LOG_MAIL] syslog.syslog['E-mail processing initiated...']1. syslog.openlog [[nhận dạng [, logoption [, cơ sở]]]]openlog[[ident[, logoption[, facility]]]]¶
Các tùy chọn ghi nhật ký của các cuộc gọi
syslog.openlog[logoption=syslog.LOG_PID, facility=syslog.LOG_MAIL] syslog.syslog['E-mail processing initiated...']3 tiếp theo có thể được đặt bằng cách gọi
syslog.openlog[logoption=syslog.LOG_PID, facility=syslog.LOG_MAIL] syslog.syslog['E-mail processing initiated...']1.
syslog.openlog[logoption=syslog.LOG_PID, facility=syslog.LOG_MAIL] syslog.syslog['E-mail processing initiated...']3 sẽ gọi
syslog.openlog[logoption=syslog.LOG_PID, facility=syslog.LOG_MAIL] syslog.syslog['E-mail processing initiated...']1 không có đối số nếu nhật ký hiện không mở.
Đối số từ khóa nhận dạng tùy chọn là một chuỗi được chuẩn bị cho mọi thông báo và mặc định là syslog
5 với các thành phần đường dẫn hàng đầu bị tước. Đối số từ khóa logoption tùy chọn [mặc định là 0] là một trường bit - xem bên dưới để biết các giá trị có thể kết hợp. Đối số từ khóa cơ sở tùy chọn [mặc định là syslog
6] đặt cơ sở mặc định cho các tin nhắn không có cơ sở được mã hóa rõ ràng.
Tăng một sự kiện kiểm toán syslog
7 với các đối số syslog
8, syslog
9, syslog
0.auditing event syslog
7 with arguments syslog
8, syslog
9,
syslog
0.
Đã thay đổi trong phiên bản 3.2: Trong các phiên bản trước, không được phép đối số từ khóa và cần phải nhận dạng.In previous versions, keyword arguments were not allowed, and ident was required.
syslog.closelog [] ¶closelog[]¶Đặt lại các giá trị mô -đun SYSLOG và gọi thư viện hệ thống syslog
1.
Điều này làm cho mô -đun hoạt động như khi được nhập ban đầu. Ví dụ:
syslog.openlog[logoption=syslog.LOG_PID, facility=syslog.LOG_MAIL] syslog.syslog['E-mail processing initiated...']1 sẽ được gọi trong cuộc gọi
syslog.openlog[logoption=syslog.LOG_PID, facility=syslog.LOG_MAIL] syslog.syslog['E-mail processing initiated...']3 đầu tiên [nếu
syslog.openlog[logoption=syslog.LOG_PID, facility=syslog.LOG_MAIL] syslog.syslog['E-mail processing initiated...']1 đã được gọi], và các tham số
syslog.openlog[logoption=syslog.LOG_PID, facility=syslog.LOG_MAIL] syslog.syslog['E-mail processing initiated...']1 khác được đặt lại về mặc định.
Tăng một sự kiện kiểm toán syslog
6 không có lập luận.auditing event syslog
6 with no arguments.
Đặt mặt nạ ưu tiên thành MaskPri và trả về giá trị mặt nạ trước đó. Các cuộc gọi đến
syslog.openlog[logoption=syslog.LOG_PID, facility=syslog.LOG_MAIL] syslog.syslog['E-mail processing initiated...']3 với mức độ ưu tiên không được đặt trong MaskPri bị bỏ qua. Mặc định là ghi lại tất cả các ưu tiên. Hàm
syslog
8 tính toán mặt nạ cho PRI ưu tiên cá nhân. Hàm syslog
9 tính toán mặt nạ cho tất cả các ưu tiên lên đến và bao gồm cả PRI.Tăng một sự kiện kiểm toán syslog
0 với đối số syslog
1.auditing event syslog
0 with argument syslog
1.
Mô -đun xác định các hằng số sau:
Mức độ ưu tiên [cao đến thấp]:syslog
2, syslog
3, syslog
4, syslog
5, syslog
6, syslog
7, LOG_INFO
, syslog
9.
logging.handlers
0, syslog
6, logging.handlers
2, logging.handlers
3, logging.handlers
4, logging.handlers
5, logging.handlers
6, logging.handlers
7, logging.handlers
8, logging.handlers
9, SysLogHandler
0 đến SysLogHandler
1, và nếu được xác định trong SysLogHandler
2, ____.
SysLogHandler
4, SysLogHandler
5, SysLogHandler
6, và, nếu được xác định trong SysLogHandler
2, SysLogHandler
8, SysLogHandler
9 và wasm32-emscripten
0.
Ví dụ;
Ví dụ đơn giản
Một tập hợp các ví dụ đơn giản:
import syslog syslog.syslog['Processing started'] if error: syslog.syslog[syslog.LOG_ERR, 'Processing started']
Một ví dụ về việc thiết lập một số tùy chọn nhật ký, chúng sẽ bao gồm ID quy trình trong các tin nhắn đã đăng nhập và ghi tin nhắn vào cơ sở đích được sử dụng để ghi nhật ký thư:
syslog.openlog[logoption=syslog.LOG_PID, facility=syslog.LOG_MAIL] syslog.syslog['E-mail processing initiated...']