Hướng dẫn python logging in a library - python đăng nhập thư viện

Đối tượng logger

Loggers có các thuộc tính và phương thức sau. Lưu ý rằng loggers không bao giờ nên được khởi tạo trực tiếp, nhưng luôn thông qua hàm cấp mô-đun logging.getLogger(name). Nhiều cuộc gọi đến

Stack (most recent call last):

Stack (most recent call last):

Stack (most recent call last):

Stack (most recent call last):

Stack (most recent call last):

Stack (most recent call last):

Stack (most recent call last):

Stack (most recent call last):

Stack (most recent call last):

Stack (most recent call last):

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logger = logging.getLogger('tcpserver')
logger.warning('Protocol problem: %s', 'connection reset', extra=d)

Nếu thuộc tính này đánh giá là TRUE, các sự kiện được ghi vào logger này sẽ được chuyển cho các trình xử lý của các trình ghi nhật ký cấp cao hơn (tổ tiên), ngoài bất kỳ trình xử lý nào được gắn vào logger này. Các thông điệp được truyền trực tiếp đến các trình xử lý của tổ tiên - cả cấp độ cũng không phải là bộ lọc của các trình ghi nhật ký của tổ tiên trong câu hỏi đều được xem xét.

Nếu điều này đánh giá là sai, các tin nhắn ghi nhật ký không được chuyển cho người xử lý của các trình ghi nhật ký tổ tiên.

Đánh vần nó bằng một ví dụ: nếu thuộc tính tuyên truyền của logger có tên

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logger = logging.getLogger('tcpserver')
logger.warning('Protocol problem: %s', 'connection reset', extra=d)

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logger = logging.getLogger('tcpserver')
logger.warning('Protocol problem: %s', 'connection reset', extra=d)

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logger = logging.getLogger('tcpserver')
logger.warning('Protocol problem: %s', 'connection reset', extra=d)

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logger = logging.getLogger('tcpserver')
logger.warning('Protocol problem: %s', 'connection reset', extra=d)

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logger = logging.getLogger('tcpserver')
logger.warning('Protocol problem: %s', 'connection reset', extra=d)

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logger = logging.getLogger('tcpserver')
logger.warning('Protocol problem: %s', 'connection reset', extra=d)

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logger = logging.getLogger('tcpserver')
logger.warning('Protocol problem: %s', 'connection reset', extra=d)

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logger = logging.getLogger('tcpserver')
logger.warning('Protocol problem: %s', 'connection reset', extra=d)

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logger = logging.getLogger('tcpserver')
logger.warning('Protocol problem: %s', 'connection reset', extra=d)

2006-02-08 22:20:02,165 192.168.0.1 fbloggs  Protocol problem: connection reset

Hàm tạo đặt thuộc tính này thành

2006-02-08 22:20:02,165 192.168.0.1 fbloggs  Protocol problem: connection reset

Ghi chú

Nếu bạn gắn một trình xử lý vào một logger và một hoặc nhiều tổ tiên của nó, nó có thể phát ra cùng một bản ghi nhiều lần. Nói chung, bạn không cần phải gắn một trình xử lý vào nhiều hơn một logger - nếu bạn chỉ gắn nó vào logger thích hợp cao nhất trong phân cấp logger, thì nó sẽ thấy tất cả các sự kiện được ghi bởi tất cả các trình ghi nhật ký, miễn là tuyên truyền của chúng Cài đặt được đặt thành

2006-02-08 22:20:02,165 192.168.0.1 fbloggs  Protocol problem: connection reset

Đặt ngưỡng cho logger này thành cấp. Các tin nhắn ghi nhật ký ít nghiêm trọng hơn mức sẽ bị bỏ qua; Các tin nhắn ghi nhật ký có mức độ nghiêm trọng hoặc cao hơn sẽ được phát ra bởi bất kỳ người xử lý hoặc dịch vụ xử lý nào trong logger này, trừ khi mức độ xử lý đã được đặt ở mức độ nghiêm trọng cao hơn mức.

Khi logger được tạo, mức được đặt thành

2006-02-08 22:20:02,165 192.168.0.1 fbloggs  Protocol problem: connection reset

2006-02-08 22:20:02,165 192.168.0.1 fbloggs  Protocol problem: connection reset

Thuật ngữ ‘Phái đoàn cho cha mẹ có nghĩa là nếu một logger có mức độ không có, thì chuỗi loggers của tổ tiên của nó được đi qua cho đến khi một tổ tiên có mức độ khác không được tìm thấy, hoặc đạt được gốc.

Nếu một tổ tiên được tìm thấy với một cấp độ khác ngoài notset, thì mức độ tổ tiên đó được coi là mức hiệu quả của logger nơi tìm kiếm tổ tiên bắt đầu và được sử dụng để xác định cách xử lý sự kiện ghi nhật ký.

Nếu đạt được gốc và nó có một mức độ không có, thì tất cả các tin nhắn sẽ được xử lý. Nếu không, mức độ gốc sẽ được sử dụng làm mức hiệu quả.

Xem các cấp độ ghi nhật ký để biết danh sách các cấp độ.Logging Levels for a list of levels.

Đã thay đổi trong phiên bản 3.2: Tham số cấp hiện chấp nhận biểu diễn chuỗi của cấp độ như ‘thông tin thay thế cho các hằng số số nguyên như

2006-02-08 22:20:02,165 192.168.0.1 fbloggs  Protocol problem: connection reset

2006-02-08 22:20:02,165 192.168.0.1 fbloggs  Protocol problem: connection reset

2006-02-08 22:20:02,165 192.168.0.1 fbloggs  Protocol problem: connection reset

2006-02-08 22:20:02,165 192.168.0.1 fbloggs  Protocol problem: connection reset

2006-02-08 22:20:02,165 192.168.0.1 fbloggs  Protocol problem: connection reset

2006-02-08 22:20:02,165 192.168.0.1 fbloggs  Protocol problem: connection reset

Cho biết nếu một thông điệp về mức độ nghiêm trọng sẽ được xử lý bởi logger này. Phương pháp này trước tiên kiểm tra mức cấp độ mô-đun được đặt bởi

2006-02-08 22:20:02,165 192.168.0.1 fbloggs  Protocol problem: connection reset

2006-02-08 22:20:02,165 192.168.0.1 fbloggs  Protocol problem: connection reset

Chỉ ra mức hiệu quả cho logger này. Nếu một giá trị khác với

2006-02-08 22:20:02,165 192.168.0.1 fbloggs  Protocol problem: connection reset

old_factory = logging.getLogRecordFactory()

def record_factory(*args, **kwargs):
    record = old_factory(*args, **kwargs)
    record.custom_attribute = 0xdecafbad
    return record

logging.setLogRecordFactory(record_factory)

2006-02-08 22:20:02,165 192.168.0.1 fbloggs  Protocol problem: connection reset

old_factory = logging.getLogRecordFactory()

def record_factory(*args, **kwargs):
    record = old_factory(*args, **kwargs)
    record.custom_attribute = 0xdecafbad
    return record

logging.setLogRecordFactory(record_factory)

old_factory = logging.getLogRecordFactory()

def record_factory(*args, **kwargs):
    record = old_factory(*args, **kwargs)
    record.custom_attribute = 0xdecafbad
    return record

logging.setLogRecordFactory(record_factory)

Trả về một logger là hậu duệ của logger này, như được xác định bởi hậu tố. Do đó,

old_factory = logging.getLogRecordFactory()

def record_factory(*args, **kwargs):
    record = old_factory(*args, **kwargs)
    record.custom_attribute = 0xdecafbad
    return record

logging.setLogRecordFactory(record_factory)

old_factory = logging.getLogRecordFactory()

def record_factory(*args, **kwargs):
    record = old_factory(*args, **kwargs)
    record.custom_attribute = 0xdecafbad
    return record

logging.setLogRecordFactory(record_factory)

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logger = logging.getLogger('tcpserver')
logger.warning('Protocol problem: %s', 'connection reset', extra=d)

Mới trong phiên bản 3.2.

Ghi lại một thông báo với cấp

old_factory = logging.getLogRecordFactory()

def record_factory(*args, **kwargs):
    record = old_factory(*args, **kwargs)
    record.custom_attribute = 0xdecafbad
    return record

logging.setLogRecordFactory(record_factory)

Có bốn đối số từ khóa trong kwargs được kiểm tra: exc_info, stack_info, Stacklevel và Extra.

Nếu exc_info không đánh giá là sai, nó sẽ khiến thông tin ngoại lệ được thêm vào thông báo ghi nhật ký. Nếu một bộ ngoại lệ (ở định dạng được trả về bởi

old_factory = logging.getLogRecordFactory()

def record_factory(*args, **kwargs):
    record = old_factory(*args, **kwargs)
    record.custom_attribute = 0xdecafbad
    return record

logging.setLogRecordFactory(record_factory)

old_factory = logging.getLogRecordFactory()

def record_factory(*args, **kwargs):
    record = old_factory(*args, **kwargs)
    record.custom_attribute = 0xdecafbad
    return record

logging.setLogRecordFactory(record_factory)

Đối số từ khóa tùy chọn thứ hai là stack_info, mặc định là

class MyLogger(logging.getLoggerClass()):
    # ... override behaviour here

Bạn có thể chỉ định stack_info độc lập với exc_info, ví dụ: Để chỉ ra cách bạn đến một điểm nhất định trong mã của bạn, ngay cả khi không có ngoại lệ nào được nêu ra. Các khung ngăn xếp được in theo dòng tiêu đề có nội dung:

Stack (most recent call last):

Điều này bắt chước

class MyLogger(logging.getLoggerClass()):
    # ... override behaviour here

Đối số từ khóa tùy chọn thứ ba là Stacklevel, mặc định là

class MyLogger(logging.getLoggerClass()):
    # ... override behaviour here

class MyLogger(logging.getLoggerClass()):
    # ... override behaviour here

class MyLogger(logging.getLoggerClass()):
    # ... override behaviour here

Đối số từ khóa thứ tư là thêm có thể được sử dụng để truyền từ điển được sử dụng để điền vào __dict__ của

class MyLogger(logging.getLoggerClass()):
    # ... override behaviour here

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logger = logging.getLogger('tcpserver')
logger.warning('Protocol problem: %s', 'connection reset', extra=d)

sẽ in một cái gì đó như

2006-02-08 22:20:02,165 192.168.0.1 fbloggs  Protocol problem: connection reset

Các phím trong từ điển được truyền thêm không nên đụng độ với các phím được sử dụng bởi hệ thống ghi nhật ký. (Xem phần trên các thuộc tính logrecord để biết thêm thông tin về các khóa được sử dụng bởi hệ thống ghi nhật ký.)LogRecord attributes for more information on which keys are used by the logging system.)

Nếu bạn chọn sử dụng các thuộc tính này trong các tin nhắn đã đăng nhập, bạn cần thực hiện một số chăm sóc. Ví dụ, trong ví dụ trên,

class MyLogger(logging.getLoggerClass()):
    # ... override behaviour here

class MyLogger(logging.getLoggerClass()):
    # ... override behaviour here

Mặc dù điều này có thể gây khó chịu, tính năng này được sử dụng trong các trường hợp chuyên ngành, chẳng hạn như các máy chủ đa luồng trong đó cùng một mã thực thi trong nhiều bối cảnh và các điều kiện thú vị phát sinh phụ thuộc vào bối cảnh này (chẳng hạn như địa chỉ IP của máy khách từ xa và được xác thực Tên người dùng, trong ví dụ trên). Trong những trường hợp như vậy, có khả năng các

class MyLogger(logging.getLoggerClass()):
    # ... override behaviour here

Nếu không có trình xử lý nào được gắn vào logger này (hoặc bất kỳ tổ tiên nào của nó, có tính đến các thuộc tính

Stack (most recent call last):

Stack (most recent call last):

Đã thay đổi trong phiên bản 3.2: Tham số Stack_info đã được thêm vào.The stack_info parameter was added.

Đã thay đổi trong phiên bản 3.5: Tham số Exc_info hiện có thể chấp nhận các trường hợp ngoại lệ.The exc_info parameter can now accept exception instances.

Thay đổi trong phiên bản 3.8: Tham số Stacklevel đã được thêm vào.The stacklevel parameter was added.

Ghi lại một thông báo với cấp

2006-02-08 22:20:02,165 192.168.0.1 fbloggs  Protocol problem: connection reset

Stack (most recent call last):

Ghi lại một thông báo với cấp

2006-02-08 22:20:02,165 192.168.0.1 fbloggs  Protocol problem: connection reset

Stack (most recent call last):

Ghi chú

Có một phương pháp lỗi thời

Stack (most recent call last):

Stack (most recent call last):

Stack (most recent call last):

Stack (most recent call last):

Ghi lại một thông báo với cấp

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logging.warning('Protocol problem: %s', 'connection reset', extra=d)

Stack (most recent call last):

Ghi lại một thông báo với cấp

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logging.warning('Protocol problem: %s', 'connection reset', extra=d)

Stack (most recent call last):

Ghi lại một thông báo với mức số nguyên trên logger này. Các đối số khác được giải thích là đối với

Stack (most recent call last):

Ghi lại một thông báo với cấp

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logging.warning('Protocol problem: %s', 'connection reset', extra=d)

Stack (most recent call last):

Thêm bộ lọc được chỉ định vào logger này.

Xóa bộ lọc được chỉ định khỏi bộ ghi này.

Áp dụng các bộ lọc logger này vào bản ghi và trả về

2006-02-08 22:20:02,165 192.168.0.1 fbloggs  Protocol problem: connection reset

Thêm HDLR xử lý được chỉ định vào logger này.

Loại bỏ HDLR xử lý được chỉ định khỏi bộ ghi này.

Tìm tên tệp và số dòng người gọi người gọi. Trả về tên tệp, số dòng, tên hàm và thông tin xếp chồng dưới dạng bộ thứ 4 yếu tố. Thông tin ngăn xếp được trả về dưới dạng

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logging.warning('Protocol problem: %s', 'connection reset', extra=d)

2006-02-08 22:20:02,165 192.168.0.1 fbloggs  Protocol problem: connection reset

Tham số Stacklevel được truyền từ mã gọi

Stack (most recent call last):

Xử lý một bản ghi bằng cách chuyển nó cho tất cả các trình xử lý được liên kết với bộ ghi này và tổ tiên của nó (cho đến khi tìm thấy giá trị giả của tuyên truyền). Phương pháp này được sử dụng cho các bản ghi không được lấy từ một ổ cắm, cũng như các bản ghi được tạo tại địa phương. Lọc cấp logger được áp dụng bằng cách sử dụng

2006-02-08 22:20:02,165 192.168.0.1 fbloggs  Protocol problem: connection reset

Đây là một phương thức nhà máy có thể được ghi đè trong các lớp con để tạo các trường hợp

class MyLogger(logging.getLoggerClass()):
    # ... override behaviour here

Kiểm tra xem liệu logger này có trình xử lý được cấu hình không. Điều này được thực hiện bằng cách tìm kiếm người xử lý trong bộ ghi này và cha mẹ của nó trong hệ thống phân cấp logger. Trả về

2006-02-08 22:20:02,165 192.168.0.1 fbloggs  Protocol problem: connection reset

class MyLogger(logging.getLoggerClass()):
    # ... override behaviour here

Mới trong phiên bản 3.2.

Đã thay đổi trong phiên bản 3.7: Loggers hiện có thể được ngâm và không được giải thích.Loggers can now be pickled and unpickled.

Mức ghi nhật ký

Các giá trị số của các mức ghi nhật ký được đưa ra trong bảng sau. Đây chủ yếu được quan tâm nếu bạn muốn xác định cấp độ của riêng bạn và cần chúng có các giá trị cụ thể liên quan đến các cấp độ được xác định trước. Nếu bạn xác định một mức có cùng giá trị số, nó sẽ ghi đè lên giá trị được xác định trước; Tên được xác định trước bị mất.

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logging.warning('Protocol problem: %s', 'connection reset', extra=d)

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logging.warning('Protocol problem: %s', 'connection reset', extra=d)

2006-02-08 22:20:02,165 192.168.0.1 fbloggs  Protocol problem: connection reset

2006-02-08 22:20:02,165 192.168.0.1 fbloggs  Protocol problem: connection reset

old_factory = logging.getLogRecordFactory()

def record_factory(*args, **kwargs):
    record = old_factory(*args, **kwargs)
    record.custom_attribute = 0xdecafbad
    return record

logging.setLogRecordFactory(record_factory)

2006-02-08 22:20:02,165 192.168.0.1 fbloggs  Protocol problem: connection reset

Đối tượng xử lý

Người xử lý có các thuộc tính và phương thức sau. Lưu ý rằng

Stack (most recent call last):

Khởi tạo thể hiện

Stack (most recent call last):

Khởi tạo một khóa luồng có thể được sử dụng để tuần tự hóa quyền truy cập vào chức năng I/O bên dưới có thể không phải là ThreadSafe.

Có được khóa luồng được tạo bằng logging.getLogger(name)6.

Phát hành khóa luồng thu được với logging.getLogger(name)8.

Đặt ngưỡng cho người xử lý này lên cấp. Tin nhắn ghi nhật ký ít nghiêm trọng hơn mức sẽ bị bỏ qua. Khi một trình xử lý được tạo, mức được đặt thành

2006-02-08 22:20:02,165 192.168.0.1 fbloggs  Protocol problem: connection reset

Xem các cấp độ ghi nhật ký để biết danh sách các cấp độ.Logging Levels for a list of levels.

Đã thay đổi trong phiên bản 3.2: Tham số cấp hiện chấp nhận biểu diễn chuỗi của cấp độ như ‘thông tin thay thế cho các hằng số số nguyên như

2006-02-08 22:20:02,165 192.168.0.1 fbloggs  Protocol problem: connection reset

2006-02-08 22:20:02,165 192.168.0.1 fbloggs  Protocol problem: connection reset

Đặt

class MyLogger(logging.getLoggerClass()):
    # ... override behaviour here

Thêm bộ lọc được chỉ định vào trình xử lý này.

Xóa bộ lọc được chỉ định khỏi trình xử lý này.

Áp dụng các bộ lọc xử lý này vào hồ sơ và trả về

2006-02-08 22:20:02,165 192.168.0.1 fbloggs  Protocol problem: connection reset

Đảm bảo tất cả đầu ra ghi nhật ký đã được xóa. Phiên bản này không có gì và được dự định sẽ được thực hiện bởi các lớp con.

Tidy lên bất kỳ tài nguyên được sử dụng bởi người xử lý. Phiên bản này không có đầu ra nhưng loại bỏ trình xử lý khỏi danh sách các trình xử lý nội bộ được đóng khi

Stack (most recent call last):

Stack (most recent call last):

Có điều kiện phát ra bản ghi ghi nhật ký được chỉ định, tùy thuộc vào các bộ lọc có thể đã được thêm vào trình xử lý. Kết thúc sự phát xạ thực tế của hồ sơ với việc mua lại/phát hành khóa luồng I/O.

Phương pháp này nên được gọi từ người xử lý khi gặp phải ngoại lệ trong cuộc gọi

Stack (most recent call last):

Stack (most recent call last):

class MyLogger(logging.getLoggerClass()):
    # ... override behaviour here

Stack (most recent call last):

2006-02-08 22:20:02,165 192.168.0.1 fbloggs  Protocol problem: connection reset

Thực hiện định dạng cho một bản ghi - nếu một định dạng được đặt, hãy sử dụng nó. Nếu không, sử dụng định dạng mặc định cho mô -đun.

Làm bất cứ điều gì cần thiết để thực sự ghi nhật ký bản ghi ghi nhật ký được chỉ định. Phiên bản này được dự định sẽ được thực hiện bởi các lớp con và do đó tăng

Stack (most recent call last):

Cảnh báo

Phương pháp này được gọi sau khi một khóa cấp xử lý được thu thập, được phát hành sau khi phương thức này trả về. Khi bạn ghi đè phương thức này, lưu ý rằng bạn nên cẩn thận khi gọi bất cứ thứ gì gọi các phần khác của API ghi nhật ký có thể khóa, bởi vì điều đó có thể dẫn đến bế tắc. Đặc biệt:

• API cấu hình ghi nhật ký có được khóa cấp độ mô-đun, và sau đó khóa cấp độ xử lý riêng lẻ khi các trình xử lý được cấu hình.

• Nhiều API ghi nhật ký khóa khóa mô-đun. Nếu API như vậy được gọi từ phương thức này, nó có thể gây bế tắc nếu lệnh gọi cấu hình được thực hiện trên một luồng khác, bởi vì luồng đó sẽ cố gắng thu Khóa cấp mô-đun sau khóa cấp xử lý (vì trong phương thức này, khóa cấp độ xử lý đã được thu thập).

Để biết danh sách các trình xử lý được bao gồm dưới dạng tiêu chuẩn, xem

Stack (most recent call last):

Đối tượng định dạng

Các đối tượng

class MyLogger(logging.getLoggerClass()):
    # ... override behaviour here

class MyLogger(logging.getLoggerClass()):
    # ... override behaviour here

class MyLogger(logging.getLoggerClass()):
    # ... override behaviour here

Stack (most recent call last):

Một định dạng có thể được khởi tạo bằng một chuỗi định dạng sử dụng kiến ​​thức của các thuộc tính

class MyLogger(logging.getLoggerClass()):
    # ... override behaviour here

Các khóa ánh xạ hữu ích trong

class MyLogger(logging.getLoggerClass()):
    # ... override behaviour here

Trả về một thể hiện mới của lớp

class MyLogger(logging.getLoggerClass()):
    # ... override behaviour here

Stack (most recent call last):

Stack (most recent call last):

Tham số kiểu có thể là một trong những ‘ %,‘ {{hoặc ‘$ $ và xác định cách thức chuỗi định dạng sẽ được kết hợp với dữ liệu của nó: sử dụng một trong số %-formatting,

Stack (most recent call last):

Stack (most recent call last):

Stack (most recent call last):

Stack (most recent call last):

Stack (most recent call last):

Tham số mặc định có thể là một từ điển với các giá trị mặc định để sử dụng trong các trường tùy chỉnh. Ví dụ:

Stack (most recent call last):

Thay đổi trong phiên bản 3.2: Tham số kiểu đã được thêm vào.The style parameter was added.

Thay đổi trong phiên bản 3.8: Tham số xác thực đã được thêm vào. Phong cách không chính xác hoặc không phù hợp và FMT sẽ tăng

Stack (most recent call last):

Stack (most recent call last):

Stack (most recent call last):

Stack (most recent call last):

Thay đổi trong phiên bản 3.10: Tham số mặc định đã được thêm vào.The defaults parameter was added.

Từ điển thuộc tính của bản ghi được sử dụng làm toán hạng cho hoạt động định dạng chuỗi. Trả về chuỗi kết quả. Trước khi định dạng từ điển, một vài bước chuẩn bị được thực hiện. Thuộc tính tin nhắn của bản ghi được tính toán bằng MSG % Args. Nếu chuỗi định dạng chứa

Stack (most recent call last):

Stack (most recent call last):

Stack (most recent call last):

class MyLogger(logging.getLoggerClass()):
    # ... override behaviour here

Nếu có sẵn thông tin ngăn xếp, nó được thêm vào sau thông tin ngoại lệ, sử dụng

Stack (most recent call last):

Phương pháp này nên được gọi từ

Stack (most recent call last):

Stack (most recent call last):

Stack (most recent call last):

Stack (most recent call last):

Chức năng này sử dụng chức năng có thể định cấu hình người dùng để chuyển đổi thời gian tạo thành tuple. Theo mặc định,

Stack (most recent call last):

Stack (most recent call last):

Stack (most recent call last):

Stack (most recent call last):

Stack (most recent call last):

class MyLogger(logging.getLoggerClass()):
    # ... override behaviour here

Đã thay đổi trong phiên bản 3.3: Trước đây, định dạng mặc định đã được mã hóa cứng như trong ví dụ này:

Stack (most recent call last):

Stack (most recent call last):

Stack (most recent call last):

Stack (most recent call last):

Stack (most recent call last):

Stack (most recent call last):

Stack (most recent call last):

Stack (most recent call last):

Stack (most recent call last):

Stack (most recent call last):

Đã thay đổi trong phiên bản 3.9:

Stack (most recent call last):

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logging.warning('Protocol problem: %s', 'connection reset', extra=d)

Stack (most recent call last):

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logging.warning('Protocol problem: %s', 'connection reset', extra=d)

Định dạng thông tin ngoại lệ được chỉ định (một bộ ngoại lệ tiêu chuẩn được trả về bởi

old_factory = logging.getLogRecordFactory()

def record_factory(*args, **kwargs):
    record = old_factory(*args, **kwargs)
    record.custom_attribute = 0xdecafbad
    return record

logging.setLogRecordFactory(record_factory)

Stack (most recent call last):

Định dạng thông tin ngăn xếp được chỉ định (một chuỗi được trả về bởi

Stack (most recent call last):

Một lớp định dạng cơ sở phù hợp để phân lớp khi bạn muốn định dạng một số hồ sơ. Bạn có thể vượt qua một thể hiện

class MyLogger(logging.getLoggerClass()):
    # ... override behaviour here

Trả lại một tiêu đề cho một danh sách các hồ sơ. Việc thực hiện cơ sở chỉ trả về chuỗi trống. Bạn sẽ cần ghi đè phương thức này nếu bạn muốn hành vi cụ thể, ví dụ: Để hiển thị số lượng hồ sơ, một tiêu đề hoặc một dòng phân cách.

Trả về một chân trang cho một danh sách các hồ sơ. Việc thực hiện cơ sở chỉ trả về chuỗi trống. Bạn sẽ cần ghi đè phương thức này nếu bạn muốn hành vi cụ thể, ví dụ: Để hiển thị số lượng hồ sơ hoặc một dòng phân cách.

Trả về văn bản được định dạng cho một danh sách các bản ghi. Việc triển khai cơ sở chỉ trả về chuỗi trống nếu không có hồ sơ; Mặt khác, nó trả về sự kết hợp của tiêu đề, mỗi bản ghi được định dạng với định dạng dòng và chân trang.

Bộ lọc đối tượng Jo

Stack (most recent call last):

Stack (most recent call last):

Stack (most recent call last):

Trả về một thể hiện của lớp

Stack (most recent call last):

Là bản ghi được chỉ định được ghi lại? Trả về Zero cho không, khác không cho có. Nếu được coi là phù hợp, hồ sơ có thể được sửa đổi tại chỗ theo phương pháp này.

Lưu ý rằng các bộ lọc được gắn vào các trình xử lý được tư vấn trước khi một sự kiện được phát ra bởi trình xử lý, trong khi các bộ lọc được gắn vào loggers được tư vấn bất cứ khi nào một sự kiện được ghi lại (sử dụng

Stack (most recent call last):

Stack (most recent call last):

Bạn không thực sự cần phải phân lớp

Stack (most recent call last):

Stack (most recent call last):

Đã thay đổi trong phiên bản 3.2: Bạn không cần tạo các lớp

Stack (most recent call last):

Stack (most recent call last):

Stack (most recent call last):

Stack (most recent call last):

2006-02-08 22:20:02,165 192.168.0.1 fbloggs  Protocol problem: connection reset

2006-02-08 22:20:02,165 192.168.0.1 fbloggs  Protocol problem: connection reset

Stack (most recent call last):

Stack (most recent call last):

Stack (most recent call last):

Stack (most recent call last):

2006-02-08 22:20:02,165 192.168.0.1 fbloggs  Protocol problem: connection reset

2006-02-08 22:20:02,165 192.168.0.1 fbloggs  Protocol problem: connection reset

Mặc dù các bộ lọc được sử dụng chủ yếu để lọc các bản ghi dựa trên các tiêu chí tinh vi hơn các cấp, nhưng chúng có thể thấy mọi bản ghi được xử lý bởi trình xử lý hoặc logger mà chúng được đính kèm: điều này có thể hữu ích nếu bạn muốn làm những việc như đếm số lượng Các bản ghi được xử lý bởi một bộ ghi hoặc trình xử lý cụ thể hoặc thêm, thay đổi hoặc xóa các thuộc tính trong

class MyLogger(logging.getLoggerClass()):
    # ... override behaviour here

Đối tượng logrecord

Các phiên bản

class MyLogger(logging.getLoggerClass()):
    # ... override behaviour here

Stack (most recent call last):

Stack (most recent call last):

Chứa tất cả các thông tin phù hợp với sự kiện được ghi lại.

Thông tin chính được truyền trong MSG và ARGS, được kết hợp bằng cách sử dụng

Stack (most recent call last):

Stack (most recent call last):

• Tên (STR) - Tên của logger được sử dụng để ghi lại sự kiện được biểu thị bằng

  class MyLogger(logging.getLoggerClass()):
      # ... override behaviour here
  

  4 này. Lưu ý rằng tên logger trong

  class MyLogger(logging.getLoggerClass()):
      # ... override behaviour here
  

  4 sẽ luôn có giá trị này, mặc dù nó có thể được phát ra bởi một trình xử lý được gắn vào một logger (tổ tiên) khác. (str) – The name of the logger used to log the event represented by this

  class MyLogger(logging.getLoggerClass()):
      # ... override behaviour here
  

  4. Note that the logger name in the

  class MyLogger(logging.getLoggerClass()):
      # ... override behaviour here
  

  4 will always have this value, even though it may be emitted by a handler attached to a different (ancestor) logger.

• Cấp độ (int) - Mức số của sự kiện khai thác (chẳng hạn như

  Stack (most recent call last):
  

  79 cho

  old_factory = logging.getLogRecordFactory()
  
  def record_factory(*args, **kwargs):
      record = old_factory(*args, **kwargs)
      record.custom_attribute = 0xdecafbad
      return record
  
  logging.setLogRecordFactory(record_factory)
  

  8,

  Stack (most recent call last):
  

  81 cho

  2006-02-08 22:20:02,165 192.168.0.1 fbloggs  Protocol problem: connection reset
  

  5, v.v.). Lưu ý rằng điều này được chuyển đổi thành hai thuộc tính của logrecord:

  Stack (most recent call last):
  

  83 cho giá trị số và

  Stack (most recent call last):
  

  84 cho tên cấp tương ứng. (int) – The numeric level of the logging event (such as

  Stack (most recent call last):
  

  79 for

  old_factory = logging.getLogRecordFactory()
  
  def record_factory(*args, **kwargs):
      record = old_factory(*args, **kwargs)
      record.custom_attribute = 0xdecafbad
      return record
  
  logging.setLogRecordFactory(record_factory)
  

  8,

  Stack (most recent call last):
  

  81 for

  2006-02-08 22:20:02,165 192.168.0.1 fbloggs  Protocol problem: connection reset
  

  5, etc). Note that this is converted to two attributes of the LogRecord:

  Stack (most recent call last):
  

  83 for the numeric value and

  Stack (most recent call last):
  

  84 for the corresponding level name.

• PathName (STR) - Đường dẫn chuỗi đầy đủ của tệp nguồn nơi thực hiện cuộc gọi ghi nhật ký. (str) – The full string path of the source file where the logging call was made.

• Lineno (int) - Số dòng trong tệp nguồn nơi thực hiện cuộc gọi ghi nhật ký. (int) – The line number in the source file where the logging call was made.

• MSG (STR)-Thông báo mô tả sự kiện, có thể là chuỗi %-format với trình giữ chỗ cho dữ liệu biến. (str) – The event description message, which can be a %-format string with placeholders for variable data.

• args (tuple | dict [str, any]) - dữ liệu biến để hợp nhất vào đối số MSG để có được mô tả sự kiện. (tuple | dict[str, Any]) – Variable data to merge into the msg argument to obtain the event description.

• exc_info (tuple [type [baseexception], baseexception, type.traceBackType] | none) - một ngoại lệ với thông tin ngoại lệ hiện tại, được trả về bởi

  old_factory = logging.getLogRecordFactory()
  
  def record_factory(*args, **kwargs):
      record = old_factory(*args, **kwargs)
      record.custom_attribute = 0xdecafbad
      return record
  
  logging.setLogRecordFactory(record_factory)
  

  9 hoặc

  FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
  logging.basicConfig(format=FORMAT)
  d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
  logging.warning('Protocol problem: %s', 'connection reset', extra=d)
  

  9 nếu không có thông tin ngoại lệ nào có sẵn. (tuple[type[BaseException], BaseException, types.TracebackType] | None) – An exception tuple with the current exception information, as returned by

  old_factory = logging.getLogRecordFactory()
  
  def record_factory(*args, **kwargs):
      record = old_factory(*args, **kwargs)
      record.custom_attribute = 0xdecafbad
      return record
  
  logging.setLogRecordFactory(record_factory)
  

  9, or

  FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
  logging.basicConfig(format=FORMAT)
  d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
  logging.warning('Protocol problem: %s', 'connection reset', extra=d)
  

  9 if no exception information is available.

• func (str | none) - tên của hàm hoặc phương thức mà từ đó cuộc gọi đăng nhập được gọi. (str | None) – The name of the function or method from which the logging call was invoked.

• Sinfo (str | none) - một chuỗi văn bản đại diện cho thông tin ngăn xếp từ cơ sở của ngăn xếp trong luồng hiện tại, cho đến cuộc gọi ghi nhật ký. (str | None) – A text string representing stack information from the base of the stack in the current thread, up to the logging call.

Trả về thông báo cho phiên bản

class MyLogger(logging.getLoggerClass()):
    # ... override behaviour here

Stack (most recent call last):

Stack (most recent call last):

Thay đổi trong phiên bản 3.2: Việc tạo ra một

class MyLogger(logging.getLoggerClass()):
    # ... override behaviour here

Stack (most recent call last):

Stack (most recent call last):

class MyLogger(logging.getLoggerClass()):
    # ... override behaviour here

Stack (most recent call last):

Stack (most recent call last):

Chức năng này có thể được sử dụng để đưa các giá trị của riêng bạn vào

class MyLogger(logging.getLoggerClass()):
    # ... override behaviour here

old_factory = logging.getLogRecordFactory()

def record_factory(*args, **kwargs):
    record = old_factory(*args, **kwargs)
    record.custom_attribute = 0xdecafbad
    return record

logging.setLogRecordFactory(record_factory)

Với mô hình này, nhiều nhà máy có thể bị xích và miễn là họ không ghi đè lên các thuộc tính khác của nhau hoặc vô tình ghi đè các thuộc tính tiêu chuẩn được liệt kê ở trên, không có bất ngờ nào.

Thuộc tính logrecord

Logrecord có một số thuộc tính, hầu hết trong số đó có nguồn gốc từ các tham số đến hàm tạo. . Các danh sách bảng sau (theo thứ tự bảng chữ cái) tên thuộc tính, ý nghĩa của chúng và trình giữ chỗ tương ứng theo chuỗi định dạng kiểu %.

Nếu bạn đang sử dụng {} -formatting (

Stack (most recent call last):

Stack (most recent call last):

Stack (most recent call last):

Stack (most recent call last):

Stack (most recent call last):

Trong trường hợp {} -formatting, bạn có thể chỉ định các cờ định dạng bằng cách đặt chúng sau tên thuộc tính, được tách ra khỏi nó bằng dấu hai chấm. Ví dụ: một người giữ chỗ của

Stack (most recent call last):

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logger = logging.getLogger('tcpserver')
logger.warning('Protocol problem: %s', 'connection reset', extra=d)

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logger = logging.getLogger('tcpserver')
logger.warning('Protocol problem: %s', 'connection reset', extra=d)

Stack (most recent call last):

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logger = logging.getLogger('tcpserver')
logger.warning('Protocol problem: %s', 'connection reset', extra=d)

Stack (most recent call last):

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logger = logging.getLogger('tcpserver')
logger.warning('Protocol problem: %s', 'connection reset', extra=d)

class MyLogger(logging.getLoggerClass()):
    # ... override behaviour here

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logger = logging.getLogger('tcpserver')
logger.warning('Protocol problem: %s', 'connection reset', extra=d)

class MyLogger(logging.getLoggerClass()):
    # ... override behaviour here

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logger = logging.getLogger('tcpserver')
logger.warning('Protocol problem: %s', 'connection reset', extra=d)

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logger = logging.getLogger('tcpserver')
logger.warning('Protocol problem: %s', 'connection reset', extra=d)

Stack (most recent call last):

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logger = logging.getLogger('tcpserver')
logger.warning('Protocol problem: %s', 'connection reset', extra=d)

class MyLogger(logging.getLoggerClass()):
    # ... override behaviour here

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logger = logging.getLogger('tcpserver')
logger.warning('Protocol problem: %s', 'connection reset', extra=d)

class MyLogger(logging.getLoggerClass()):
    # ... override behaviour here

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logger = logging.getLogger('tcpserver')
logger.warning('Protocol problem: %s', 'connection reset', extra=d)

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logger = logging.getLogger('tcpserver')
logger.warning('Protocol problem: %s', 'connection reset', extra=d)

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logging.warning('Protocol problem: %s', 'connection reset', extra=d)

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logger = logging.getLogger('tcpserver')
logger.warning('Protocol problem: %s', 'connection reset', extra=d)

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logger = logging.getLogger('tcpserver')
logger.warning('Protocol problem: %s', 'connection reset', extra=d)

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logger = logging.getLogger('tcpserver')
logger.warning('Protocol problem: %s', 'connection reset', extra=d)

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logger = logging.getLogger('tcpserver')
logger.warning('Protocol problem: %s', 'connection reset', extra=d)

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logger = logging.getLogger('tcpserver')
logger.warning('Protocol problem: %s', 'connection reset', extra=d)

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logger = logging.getLogger('tcpserver')
logger.warning('Protocol problem: %s', 'connection reset', extra=d)

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logger = logging.getLogger('tcpserver')
logger.warning('Protocol problem: %s', 'connection reset', extra=d)

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logger = logging.getLogger('tcpserver')
logger.warning('Protocol problem: %s', 'connection reset', extra=d)

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logger = logging.getLogger('tcpserver')
logger.warning('Protocol problem: %s', 'connection reset', extra=d)

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logger = logging.getLogger('tcpserver')
logger.warning('Protocol problem: %s', 'connection reset', extra=d)

class MyLogger(logging.getLoggerClass()):
    # ... override behaviour here

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logger = logging.getLogger('tcpserver')
logger.warning('Protocol problem: %s', 'connection reset', extra=d)

Stack (most recent call last):

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logger = logging.getLogger('tcpserver')
logger.warning('Protocol problem: %s', 'connection reset', extra=d)

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logger = logging.getLogger('tcpserver')
logger.warning('Protocol problem: %s', 'connection reset', extra=d)

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logger = logging.getLogger('tcpserver')
logger.warning('Protocol problem: %s', 'connection reset', extra=d)

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logger = logging.getLogger('tcpserver')
logger.warning('Protocol problem: %s', 'connection reset', extra=d)

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logger = logging.getLogger('tcpserver')
logger.warning('Protocol problem: %s', 'connection reset', extra=d)

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logger = logging.getLogger('tcpserver')
logger.warning('Protocol problem: %s', 'connection reset', extra=d)

Stack (most recent call last):

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logger = logging.getLogger('tcpserver')
logger.warning('Protocol problem: %s', 'connection reset', extra=d)

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logger = logging.getLogger('tcpserver')
logger.warning('Protocol problem: %s', 'connection reset', extra=d)

quá trìnhprocessName was added.

ID xử lý (nếu có).

Tên xử lýadding contextual information to your logging output.

tương đối được điều trị

Thông tin khung ngăn xếp (nếu có) từ dưới cùng của ngăn xếp trong luồng hiện tại, lên đến và bao gồm khung ngăn xếp của cuộc gọi ghi nhật ký dẫn đến việc tạo bản ghi này.

chủ đề

ID chủ đề (nếu có).Attribute

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logger = logging.getLogger('tcpserver')
logger.warning('Protocol problem: %s', 'connection reset', extra=d)

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logger = logging.getLogger('tcpserver')
logger.warning('Protocol problem: %s', 'connection reset', extra=d)

Tên ThreadN

Tên chủ đề (nếu có).

Đã thay đổi trong phiên bản 3.1: Quy trình đã được thêm vào.

Đối tượng LoggerAd CHƯƠNG

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logger = logging.getLogger('tcpserver')
logger.warning('Protocol problem: %s', 'connection reset', extra=d)

Trả về một thể hiện của

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logger = logging.getLogger('tcpserver')
logger.warning('Protocol problem: %s', 'connection reset', extra=d)

Stack (most recent call last):

Quy trình (MSG, KWARGS) ¶

Ngoài các điều trên,

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logger = logging.getLogger('tcpserver')
logger.warning('Protocol problem: %s', 'connection reset', extra=d)

Stack (most recent call last):

Stack (most recent call last):

Stack (most recent call last):

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logger = logging.getLogger('tcpserver')
logger.warning('Protocol problem: %s', 'connection reset', extra=d)

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logger = logging.getLogger('tcpserver')
logger.warning('Protocol problem: %s', 'connection reset', extra=d)

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logger = logging.getLogger('tcpserver')
logger.warning('Protocol problem: %s', 'connection reset', extra=d)

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logger = logging.getLogger('tcpserver')
logger.warning('Protocol problem: %s', 'connection reset', extra=d)

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logger = logging.getLogger('tcpserver')
logger.warning('Protocol problem: %s', 'connection reset', extra=d)

2006-02-08 22:20:02,165 192.168.0.1 fbloggs  Protocol problem: connection reset

Stack (most recent call last):

class MyLogger(logging.getLoggerClass()):
    # ... override behaviour here

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logger = logging.getLogger('tcpserver')
logger.warning('Protocol problem: %s', 'connection reset', extra=d)

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logger = logging.getLogger('tcpserver')
logger.warning('Protocol problem: %s', 'connection reset', extra=d)

Selen an toàn %

Mô-đun ghi nhật ký được dự định là an toàn chủ đề mà không cần bất kỳ công việc đặc biệt nào cần được thực hiện bởi các máy khách của mình. Nó đạt được điều này mặc dù sử dụng khóa luồng; Có một khóa để tuần tự hóa quyền truy cập vào mô -đun dữ liệu được chia sẻ và mỗi trình xử lý cũng tạo một khóa để tuần tự hóa quyền truy cập vào I/O cơ bản của nó.This function has been provided, along with

Stack (most recent call last):

class MyLogger(logging.getLoggerClass()):
    # ... override behaviour here

Nếu bạn đang thực hiện các trình xử lý tín hiệu không đồng bộ bằng mô -đun

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logger = logging.getLogger('tcpserver')
logger.warning('Protocol problem: %s', 'connection reset', extra=d)

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logger = logging.getLogger('tcpserver')
logger.warning('Protocol problem: %s', 'connection reset', extra=d)

Ngoài các lớp được mô tả ở trên, có một số hàm cấp mô-đun.

Có ba đối số từ khóa trong kwargs được kiểm tra: exc_info, nếu nó không đánh giá là sai, khiến thông tin ngoại lệ được thêm vào thông báo đăng nhập. Nếu một bộ ngoại lệ (ở định dạng được trả về bởi

old_factory = logging.getLogRecordFactory()

def record_factory(*args, **kwargs):
    record = old_factory(*args, **kwargs)
    record.custom_attribute = 0xdecafbad
    return record

logging.setLogRecordFactory(record_factory)

old_factory = logging.getLogRecordFactory()

def record_factory(*args, **kwargs):
    record = old_factory(*args, **kwargs)
    record.custom_attribute = 0xdecafbad
    return record

logging.setLogRecordFactory(record_factory)

Đối số từ khóa tùy chọn thứ hai là stack_info, mặc định là

class MyLogger(logging.getLoggerClass()):
    # ... override behaviour here

Bạn có thể chỉ định stack_info độc lập với exc_info, ví dụ: Để chỉ ra cách bạn đến một điểm nhất định trong mã của bạn, ngay cả khi không có ngoại lệ nào được nêu ra. Các khung ngăn xếp được in theo dòng tiêu đề có nội dung:

Stack (most recent call last):

Điều này bắt chước

class MyLogger(logging.getLoggerClass()):
    # ... override behaviour here

Đối số từ khóa tùy chọn thứ ba là thêm có thể được sử dụng để truyền từ điển được sử dụng để điền vào __dict__ của logrecord được tạo cho sự kiện ghi nhật ký với các thuộc tính do người dùng xác định. Các thuộc tính tùy chỉnh này sau đó có thể được sử dụng như bạn muốn. Ví dụ, chúng có thể được kết hợp vào các tin nhắn đã ghi. Ví dụ:

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logging.warning('Protocol problem: %s', 'connection reset', extra=d)

sẽ in một cái gì đó như:

2006-02-08 22:20:02,165 192.168.0.1 fbloggs  Protocol problem: connection reset

Các phím trong từ điển được truyền thêm không nên đụng độ với các phím được sử dụng bởi hệ thống ghi nhật ký. (Xem tài liệu

class MyLogger(logging.getLoggerClass()):
    # ... override behaviour here

Nếu bạn chọn sử dụng các thuộc tính này trong các tin nhắn đã đăng nhập, bạn cần thực hiện một số chăm sóc. Ví dụ, trong ví dụ trên,

class MyLogger(logging.getLoggerClass()):
    # ... override behaviour here

Mặc dù điều này có thể gây khó chịu, tính năng này được sử dụng trong các trường hợp chuyên ngành, chẳng hạn như các máy chủ đa luồng trong đó cùng một mã thực thi trong nhiều bối cảnh và các điều kiện thú vị phát sinh phụ thuộc vào bối cảnh này (chẳng hạn như địa chỉ IP của máy khách từ xa và được xác thực Tên người dùng, trong ví dụ trên). Trong những trường hợp như vậy, có khả năng các

class MyLogger(logging.getLoggerClass()):
    # ... override behaviour here

Hàm này (cũng như

Stack (most recent call last):

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logger = logging.getLogger('tcpserver')
logger.warning('Protocol problem: %s', 'connection reset', extra=d)

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logger = logging.getLogger('tcpserver')
logger.warning('Protocol problem: %s', 'connection reset', extra=d)

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logger = logging.getLogger('tcpserver')
logger.warning('Protocol problem: %s', 'connection reset', extra=d)

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logger = logging.getLogger('tcpserver')
logger.warning('Protocol problem: %s', 'connection reset', extra=d)

Đã thay đổi trong phiên bản 3.2: Tham số Stack_info đã được thêm vào.The stack_info parameter was added.

Ghi lại một thông báo với cấp

2006-02-08 22:20:02,165 192.168.0.1 fbloggs  Protocol problem: connection reset

Stack (most recent call last):

Ghi lại một thông báo với cấp

2006-02-08 22:20:02,165 192.168.0.1 fbloggs  Protocol problem: connection reset

Stack (most recent call last):

Ghi chú

Có một hàm lỗi thời

Stack (most recent call last):

Stack (most recent call last):

Stack (most recent call last):

Stack (most recent call last):

Ghi lại một thông báo với cấp

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logging.warning('Protocol problem: %s', 'connection reset', extra=d)

Stack (most recent call last):

Ghi lại một thông báo với cấp

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logging.warning('Protocol problem: %s', 'connection reset', extra=d)

Stack (most recent call last):

Ghi lại một thông báo với cấp

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logging.warning('Protocol problem: %s', 'connection reset', extra=d)

Stack (most recent call last):

Ghi lại một thông báo với cấp độ trên logger gốc. Các đối số khác được giải thích là đối với

Stack (most recent call last):

Cung cấp một cấp độ ghi đè cho tất cả các trình ghi nhật ký được ưu tiên hơn mức độ riêng của logger. Khi nhu cầu phát sinh để tạm thời ghi âm đầu ra trên toàn bộ ứng dụng, chức năng này có thể hữu ích. Hiệu quả của nó là vô hiệu hóa tất cả các cuộc gọi ghi nhật ký ở mức độ nghiêm trọng trở xuống, để nếu bạn gọi nó với giá trị thông tin, thì tất cả các sự kiện thông tin và gỡ lỗi sẽ bị loại Cấp hiệu quả. Nếu

2006-02-08 22:20:02,165 192.168.0.1 fbloggs  Protocol problem: connection reset

Lưu ý rằng nếu bạn đã xác định bất kỳ mức ghi nhật ký tùy chỉnh nào cao hơn

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logging.warning('Protocol problem: %s', 'connection reset', extra=d)

Thay đổi trong phiên bản 3.7: Tham số cấp được mặc định là cấp

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logging.warning('Protocol problem: %s', 'connection reset', extra=d)

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logging.warning('Protocol problem: %s', 'connection reset', extra=d)

Cấp độ liên kết với mức độ văn bản trong một từ điển nội bộ, được sử dụng để ánh xạ các cấp số đến một biểu diễn văn bản, ví dụ khi một

class MyLogger(logging.getLoggerClass()):
    # ... override behaviour here

Ghi chú

Nếu bạn đang nghĩ đến việc xác định các cấp độ của riêng bạn, vui lòng xem phần về các cấp tùy chỉnh.Custom Levels.

Trả về một ánh xạ từ tên cấp độ đến các cấp ghi nhật ký tương ứng của họ. Ví dụ: chuỗi các bản đồ quan trọng của người Viking đến

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logging.warning('Protocol problem: %s', 'connection reset', extra=d)

Mới trong phiên bản 3.11.

Trả về biểu diễn văn bản hoặc số của cấp độ ghi nhật ký.

Nếu mức là một trong những cấp độ được xác định trước

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logging.warning('Protocol problem: %s', 'connection reset', extra=d)

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logging.warning('Protocol problem: %s', 'connection reset', extra=d)

2006-02-08 22:20:02,165 192.168.0.1 fbloggs  Protocol problem: connection reset

2006-02-08 22:20:02,165 192.168.0.1 fbloggs  Protocol problem: connection reset

old_factory = logging.getLogRecordFactory()

def record_factory(*args, **kwargs):
    record = old_factory(*args, **kwargs)
    record.custom_attribute = 0xdecafbad
    return record

logging.setLogRecordFactory(record_factory)

2006-02-08 22:20:02,165 192.168.0.1 fbloggs  Protocol problem: connection reset

Tham số cấp độ cũng chấp nhận một biểu diễn chuỗi của cấp độ như ‘thông tin. Trong những trường hợp như vậy, các chức năng này trả về giá trị số tương ứng của cấp độ.

Nếu không có giá trị số hoặc chuỗi phù hợp được truyền vào, chuỗi ‘cấp % s % được trả về.

Ghi chú

Nếu bạn đang nghĩ đến việc xác định các cấp độ của riêng bạn, vui lòng xem phần về các cấp tùy chỉnh.LogRecord attributes), and vice versa.

đăng nhập.getLevelNamesMapping ()In Python versions earlier than 3.4, this function could also be passed a text level, and would return the corresponding numeric value of the level. This undocumented behaviour was considered a mistake, and was removed in Python 3.4, but reinstated in 3.4.2 due to retain backward compatibility.

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logging.warning('Protocol problem: %s', 'connection reset', extra=d)

Mới trong phiên bản 3.11.

Trả về biểu diễn văn bản hoặc số của cấp độ ghi nhật ký.

Nếu mức là một trong những cấp độ được xác định trước

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logging.warning('Protocol problem: %s', 'connection reset', extra=d)

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logging.warning('Protocol problem: %s', 'connection reset', extra=d)

2006-02-08 22:20:02,165 192.168.0.1 fbloggs  Protocol problem: connection reset

2006-02-08 22:20:02,165 192.168.0.1 fbloggs  Protocol problem: connection reset

old_factory = logging.getLogRecordFactory()

def record_factory(*args, **kwargs):
    record = old_factory(*args, **kwargs)
    record.custom_attribute = 0xdecafbad
    return record

logging.setLogRecordFactory(record_factory)

2006-02-08 22:20:02,165 192.168.0.1 fbloggs  Protocol problem: connection reset

Ghi chú

Nếu bạn đang nghĩ đến việc xác định các cấp độ của riêng bạn, vui lòng xem phần về các cấp tùy chỉnh.

đăng nhập.getLevelNamesMapping ()

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logging.warning('Protocol problem: %s', 'connection reset', extra=d)

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logging.warning('Protocol problem: %s', 'connection reset', extra=d)

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logging.warning('Protocol problem: %s', 'connection reset', extra=d)

2006-02-08 22:20:02,165 192.168.0.1 fbloggs  Protocol problem: connection reset

2006-02-08 22:20:02,165 192.168.0.1 fbloggs  Protocol problem: connection reset

old_factory = logging.getLogRecordFactory()

def record_factory(*args, **kwargs):
    record = old_factory(*args, **kwargs)
    record.custom_attribute = 0xdecafbad
    return record

logging.setLogRecordFactory(record_factory)

2006-02-08 22:20:02,165 192.168.0.1 fbloggs  Protocol problem: connection reset

2006-02-08 22:20:02,165 192.168.0.1 fbloggs  Protocol problem: connection reset

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logger = logging.getLogger('tcpserver')
logger.warning('Protocol problem: %s', 'connection reset', extra=d)

class MyLogger(logging.getLoggerClass()):
    # ... override behaviour here

class MyLogger(logging.getLoggerClass()):
    # ... override behaviour here

class MyLogger(logging.getLoggerClass()):
    # ... override behaviour here

Stack (most recent call last):

Stack (most recent call last):

2006-02-08 22:20:02,165 192.168.0.1 fbloggs  Protocol problem: connection reset

2006-02-08 22:20:02,165 192.168.0.1 fbloggs  Protocol problem: connection reset

class MyLogger(logging.getLoggerClass()):
    # ... override behaviour here

Stack (most recent call last):

Stack (most recent call last):

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logger = logging.getLogger('tcpserver')
logger.warning('Protocol problem: %s', 'connection reset', extra=d)

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logger = logging.getLogger('tcpserver')
logger.warning('Protocol problem: %s', 'connection reset', extra=d)

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logger = logging.getLogger('tcpserver')
logger.warning('Protocol problem: %s', 'connection reset', extra=d)

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logger = logging.getLogger('tcpserver')
logger.warning('Protocol problem: %s', 'connection reset', extra=d)

2006-02-08 22:20:02,165 192.168.0.1 fbloggs  Protocol problem: connection reset

Stack (most recent call last):

2006-02-08 22:20:02,165 192.168.0.1 fbloggs  Protocol problem: connection reset

2006-02-08 22:20:02,165 192.168.0.1 fbloggs  Protocol problem: connection reset

FORMAT = '%(asctime)s %(clientip)-15s %(user)-8s %(message)s'
logging.basicConfig(format=FORMAT)
d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
logging.warning('Protocol problem: %s', 'connection reset', extra=d)