日志条目本质上被设计为彼此独立。
将它们连接在一起的正确方法是将一些上下文信息包含到条目中,以便稍后查看日志时进行过滤。
以下是包含此类信息的 Sharepoint 日志记录示例:
Timestamp Process TID Area Category EventID Level Message Correlation
02/26/2015 17:49:19.65 w3wp.exe (0x1F40) 0x2358 SharePoint Foundation Logging Correlation Data xmnv Medium Name=Request (POST:http://reserver2:80/pest/_vti_bin/sitedata.asmx) d1e2b688-e0b2-481e-98ce-497a11acab44
在Python中logging
docs, 将上下文信息添加到日志输出中 https://docs.python.org/2/howto/logging-cookbook.html#adding-contextual-information-to-your-logging-output建议使用以下两种方法之一:LoggerAdapter
or a Filter
.
LoggerAdapter
像这样使用(示例基于文档中的示例):
class AddConnIdAdapter(logging.LoggerAdapter):
def process(self, msg, kwargs):
return <augment_message(msg,arbitrary_info)>, kwargs
la = AddConnIdAdapter(<logger>,extra=<parameters, saved in self.extra>)
<...>
la.info(<message>)
Filter
像这样使用:
#Either all messages should have custom fields
# or the Formatter used should support messages
# both with and without custom fields
logging.basicConfig(<...>,format='%(asctime)-15s %(name)-5s %(levelname)-8s IP: %(ip)-15s User: %(user)-8s %(message)s')
class AddClientInfo(logging.Filter):
#override __init__ or set attributes to specify parameters
def filter(self, record):
record.ip = <get_client_ip()>
record.user = <get_client_name()>
return True #do not filter out anything
l=<logger()>
l.addFilter(AddClientInfo()) #can attach to either loggers or handlers
<...>
l.info('message')
正如你所看到的,区别在于LoggerAdapter
是不透明的,而Filter
是透明的。示例中,前者修改消息文本,后者设置自定义属性(实际编写需要双方配合)Formatter
使用)但事实上,两者都可以做到。
因此,如果您只需要向某些消息添加上下文,则前者更有用,而后者更适合扩充所有或大部分正在记录的消息。