zserver的Zope 3 tracelog实现
项目描述
此包实现了Zope2风格的（扩展）tracelog。tracelog是一种访问日志，记录每个请求的多个低级别事件。每个日志条目以记录类型、请求标识符和时间开始。一些日志记录包含额外的数据。
要创建跟踪日志，您需要
将zc.zservertracelog配置包含在您的站点zcml文件中
<include package="zc.zservertracelog" />
定义消息应发送到“zc.tracelog”记录器的位置。在您的zope.conf文件中，使用如下内容：
<logger> name zc.tracelog propagate false <logfile> format %(message)s path /home/jim/p/zc.zservertracelog/dev/trace.log </logfile> </logger>
分析脚本tracereport可用于分析跟踪日志。我建议使用HTML输出选项。
跟踪日志记录
请求开始
B -1214390740 2007-04-27T20:16:55.582940 GET /
包含请求方法和路径。
收到请求输入
I -1214390740 2007-04-27T20:16:55.605791 0
包含请求内容长度。
进入应用程序线程
C -1214390740 2007-04-27T20:16:55.703829
数据库活动
D -1223774356 2007-04-27T20:16:55.890371 42 0 x 2 1
数据包括每个数据库加载和保存的对象，除了没有活动的数据库。请注意，主数据库通常没有命名，数据通常以主数据库加载和保存的对象开始。
在上面的示例中，从未命名的数据库中加载了42个对象。从名为“x”的数据库中加载了两个对象，并保存了一个对象。
如果由于冲突错误而重试请求，则将出现多个“D”记录。
应用程序完成
A -1223774356 2007-04-27T20:16:55.890371 500 84
包含响应内容长度。
请求完成
E -1223774356 2007-04-27T20:16:55.913855
此外，应用程序启动还使用“S”记录进行记录
S 0 2007-04-27T20:24:29.013922
tracelog扩展记录以“-”开头
-1223774356 2008-09-12T15:51:05.559302 zc.example.extension message
变更
3.0 (2023-01-23)
删除对Python 2.7、3.4、3.5、3.6的支持。
添加对Python 3.8、3.9、3.10、3.11的支持。
2.0.0 (2019-02-26)
修复seconds_difference()中的逻辑错误，该错误可能导致特定事件的误差高达近一秒。
将HTML报告中的数字精度限制为3位小数。
删除对Python 2.6的支持。
添加对Python 3.4至3.7的支持。
1.4.0 (2015-05-06)
tracereport可以使用–date=YYYY-MM-DD..YYYY-MM-DD限制日期范围。
1.3.2 (2012-03-20)
进行轻微重构，以允许替代tracelog实现。
1.3.1 (2012-03-20)
修复在注释中没有ZODB连接的请求上的KeyError: 'ZODB.interfaces.IConnection'。
1.3.0 (2010-04-08)
添加了提供数据库传输计数的“D”记录。这有点实验性质。tracereport脚本忽略D记录。
1.2.1 (2010-01-27)
修复reST标题，以便PyPI页面正确渲染。
添加有关奇怪记录器名称的警告。
1.2.0 (2009-08-31)
tracereport改进：-修复解析错误。-添加基本测试。-以微秒分辨率报告时间。
1.1.5 (2009-04-01)
在environ中添加了用户名的新键（在zope.app.wsgi中进行重构）。
1.1.4 (2009-03-25)
将用户名放入访问日志中。
1.1.3 (2009-03-25)
时间戳具有亚秒分辨率。
1.1.1 (2008-11-21)
切换回记录器名称zc.tracelog以保持向后兼容性。
1.1.0 (2008-10-31)
修复了tracelog扩展格式，以确保它与Zope2跟踪代码的服务器关闭冲突。
向tracereport添加了仅摘要和摘要行选项。
在tracereport表输出中为交替行添加了阴影。
修复了关于日志处理程序配置的文档错误。
0.4 (2008-10-09)
添加了自动测试。
修复了日志条目可能被包含换行符的消息分割的漏洞。
将请求查询字符串添加到日志中。
将tracelog添加到WSGI环境中。
下载文件
下载适用于您平台的文件。如果您不确定选择哪个，请了解更多关于安装包的信息。