咨询BIRT各日志级别对应事件、格式及特定日志内容记录情况

关于BIRT日志级别官方文档的说明 #

BIRT采用标准Java Util Logging（JUL）的日志级别体系，包含你提到的OFF、SEVERE、WARNING、INFO、CONFIG、FINE、FINER、FINEST。官方文档会定义各级别的通用适用场景：

• SEVERE：致命错误或系统崩溃类事件
• WARNING：潜在风险或非致命异常信息
• INFO：常规运行状态通知
• CONFIG：配置加载、系统初始化类信息
• FINE/FINER/FINEST：逐级细化的调试信息，涵盖内部流程细节、变量值、调用轨迹等

但日志事件的具体内容和格式并非由BIRT统一规定，而是由两方面决定：一是BIRT代码中各日志语句实际输出的内容，二是你所使用的日志框架（此处为JBoss日志管理系统）的格式配置。

JBoss设置FINEST级别后，各项内容的记录情况 #

针对你列出的12项内容，记录判断如下：

• 格式规范且准确的事件类型、时间戳、状态码：时间戳通常由JBoss日志框架自动添加；事件类型、状态码需BIRT代码在FINEST级别日志语句中主动输出，才会被记录。
• 设备标识符（MAC地址或其他唯一标识符）：BIRT默认不会输出这类信息，仅当业务代码主动获取并在FINEST级别打印时，才会被记录。
• 会话/事务ID：需BIRT代码在处理会话或事务时，主动将ID写入FINEST级日志，否则不会记录。
• 自治系统编号：BIRT本身无默认输出逻辑，需业务代码主动添加并打印到FINEST日志才会记录。
• 源IP（IPv4/IPv6）：仅当BIRT处理网络请求时，代码主动获取并输出源IP到FINEST日志，才会被记录。
• 目的IP（IPv4/IPv6）：同上述源IP，需代码主动输出才会记录。
• 响应时间：若BIRT代码中实现了响应时间统计，并在FINEST级别输出该数据，才会被记录，默认无此内容。
• 附加头（如HTTP头）：只有BIRT在处理HTTP请求时，主动将头信息打印到FINEST日志，才会被记录。
• 用户名及/或用户ID：若BIRT集成了用户认证模块，且代码在FINEST级别输出用户身份信息，才会被记录，默认不输出。
• 执行的命令：如果BIRT代码将执行的报表操作、SQL语句等命令在FINEST级别打印，就会被记录。
• 采用键值对格式便于提取的数据：这取决于JBoss日志框架的格式配置（比如配置log4j2输出键值对格式），BIRT默认日志输出不一定是键值对，需调整日志格式配置。
• 用于事件关联的每事件唯一事件标识符：需通过JBoss日志框架配置添加（如启用日志事件ID生成），或由BIRT代码主动生成并输出到FINEST日志，否则不会默认记录。

内容的提问来源于stack exchange，提问作者Harry