Hướng dẫn syslog python - trăn nhật ký hệ thống


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.handlersSysLogHandler.

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-emscriptenwasm32-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à syslog5 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à syslog6) đặ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 syslog7 với các đối số syslog8, syslog9, syslog0.auditing event syslog7 with arguments syslog8, syslog9, syslog0.

Đã 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 syslog1.

Đ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 syslog6 không có lập luận.auditing event syslog6 with no arguments.

syslog.setlogmask (Maskpri) ¶setlogmask(maskpri)

Đặ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 syslog8 tính toán mặt nạ cho PRI ưu tiên cá nhân. Hàm syslog9 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 syslog0 với đối số syslog1.auditing event syslog0 with argument syslog1.

Mô -đun xác định các hằng số sau:

Mức độ ưu tiên (cao đến thấp):

syslog2, syslog3, syslog4, syslog5, syslog6, syslog7, LOG_INFO, syslog9.

Facilities:

logging.handlers0, syslog6, logging.handlers2, logging.handlers3, logging.handlers4, logging.handlers5, logging.handlers6, logging.handlers7, logging.handlers8, logging.handlers9, SysLogHandler0 đến SysLogHandler1, và nếu được xác định trong SysLogHandler2, ____.

Tùy chọn nhật ký:

SysLogHandler4, SysLogHandler5, SysLogHandler6, và, nếu được xác định trong SysLogHandler2, SysLogHandler8, SysLogHandler9 và wasm32-emscripten0.

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...')