在 Liberty 中配置二进制日志记录

使用此信息作为在 Liberty中配置二进制日志记录的指南。

有关此任务

与缺省 Liberty 日志和跟踪框架相比，二进制日志记录提供更快的日志和跟踪处理功能以及更灵活的方式来使用日志和跟踪内容。

服务器配置由 bootstrap.properties 文件、server.xml 文件以及这些文件随附的任何可选文件组成。 bootstrap.properties 文件指定在处理主要配置之前必须提供的属性，这些属性会保持最少。 server.xml 文件是服务器的主要配置文件。

server.xml 文件及其关联文件使用适合于大多数文本编辑器的简单 XML 格式。 分布式: [AIX MacOS Linux Windows] Liberty 的 Eclipse 服务器适配器 (WAS4D+ 适配器) 提供了更丰富的编辑体验，该适配器使用生成的模式来提供可用选项，自动完成和其他编辑工具的下拉列表。 有关 Liberty的 Eclipse 服务器适配器的描述，请参阅 使用开发者工具编辑 Liberty 配置。

bootstrap.properties 文件指定服务器是将二进制日志记录用作日志和跟踪框架，还是使用缺省日志和跟踪框架。 需要重新启动服务器，才能在二进制日志记录与缺省日志和跟踪框架之间切换。

可以通过服务器配置或者 bootstrap.properties 文件来修改二进制日志记录的配置。
  • 服务器配置：要从您自己的代码获取日志记录（进行服务器配置处理之后装入），请使用服务器配置来配置二进制日志记录。
  • bootstrap.properties 文件：可能需要设置日志记录属性以使其在服务器配置文件得到处理之前生效。 例如，如果需要分析服务器启动或配置处理早期发生的问题。 在这种情况下，您可以在 bootstrap.properties 文件中配置二进制日志记录。

可以在 bootstrap.properties 或者 server.xml 文件中设置日志记录属性。 使用 server.xml 文件中的属性，或者使用 bootstrap.properties 文件中的等价属性。 从服务器读取 bootstrap.properties 文件开始，使用 bootstrap.properties 文件中的任何设置，直到 server.xml 文件完成处理为止。 如果 bootstrap.properties 文件中的日志记录属性未在 server.xml 文件中进行替换或重置，那么将继续使用 bootstrap.properties 文件中的属性值。

如果启用了二进制日志记录，那么会忽略 maxFileSize、maxFiles、messageFileName、traceFileName 和 traceFormat 日志记录元素属性（因为二进制日志记录是在没有 trace.log 和 messages.log 文件的情况下运行）。 traceSpecification、consoleLogLevel、logDirectory 和 hideMessage 属性仍可用来设置跟踪规范、控制台日志级别、日志和跟踪文件的布置以及要在 console.log 文件中隐藏的消息的配置

如果您在 server.xml 文件中设置日志记录或二进制日志记录属性，那么可以通过在 bootstrap.properties 文件中将相应的属性设置为同一值来避免在启动时与运行时之间更改配置。 如果在 bootstrap.properties 文件中未设置任何日志记录属性或者二进制日志记录属性，那么服务器将使用缺省日志记录设置。

过程

  • 通过更新 bootstrap.properties 文件为服务器启用二进制日志记录。
    在 bootstrap.properties 文件中，单独添加下列文本行：
    websphere.log.provider=binaryLogging-1.0
  • 使用下列参数来配置二进制日志记录。
    列出的所有子元素都是 server.xml 文件中日志记录元素的子元素。
    下表列出了可在 server.xml 文件中配置的属性，以及可在 bootstrap.properties 文件中设置的等价属性：
    表 1. 可在 server.xml 中配置的二进制日志记录属性以及可在 bootstrap.properties 中设置的等价属性
    日志记录子元素 属性 等价的 bootstrap.properties 属性
    binaryLog

    purgeMaxSize

    purgeMinTime

    fileSwitchTime

    bufferingEnabled

    outOfSpaceAction

    		 
    com.ibm.hpel.log.purgeMaxSize  
    com.ibm.hpel.log.purgeMinTime  
    com.ibm.hpel.log.fileSwitchTime  
    com.ibm.hpel.log.bufferingEnabled 
    com.ibm.hpel.log.outOfSpaceAction
    binaryTrace

    purgeMaxSize

    purgeMinTime

    fileSwitchTime

    bufferingEnabled

    outOfSpaceAction

    		 
    com.ibm.hpel.trace.purgeMaxSize
    com.ibm.hpel.trace.purgeMinTime 
    com.ibm.hpel.trace.fileSwitchTime  
    com.ibm.hpel.trace.bufferingEnabled
    com.ibm.hpel.trace.outOfSpaceAction
    以下示例显示配置为启用二进制日志记录的 bootstrap.properties 文件：
    websphere.log.provider=binaryLogging-1.0
    以下示例显示了具有二进制日志记录子元素的 server.xml 文件。 日志内容设为在 96 小时后过期，跟踪内容设为最大保留 1024MB：
    <server description="new server">

    <logging>
        <binaryLog purgeMinTime="96"/>
        <binaryTrace purgeMaxSize="1024"/>
    </logging>

</server>

    有关完整日志记录配置参考，请参阅 Liberty 内核中的 logging 元素。 有关 binaryLog 和 binaryTrace 元素的更多信息，请参阅 二进制日志记录。

结果

在重新启动服务器之后，将启用并配置二进制日志记录。