[8.5.5.6 或更高版本]

配置 JPA 日志记录

记录支持对应用程序的运行时行为进行查看、跟踪和故障诊断。每个 JPA 功能部件提供不同级别的日志记录,以供您指定所需的日志记录详细程度。

关于此任务

使用 jpa-2.0jpa-2.1 功能部件时,可配置日志记录以帮助进行故障诊断。请熟悉这两个功能部件的日志记录功能。
jpa-2.0
有许多受支持的 jpa-2.0 跟踪规范可通过 Liberty 配置进行配置。这些跟踪字符串可与任何其他跟踪规范一起使用。
容器管理的 JPA 应用程序
  • JPA=all

    启用所有 JPA 容器跟踪和所有 OpenJPA 跟踪

  • openjpa=all

    启用所有 OpenJPA 跟踪

  • 特定于 OpenJPA 的日志通道
    openjpa.jdbc.SQL=all
    <server>
    ...
    <logging traceSpecification="openjpa.jdbc.SQL=all"
      traceFileName="trace.log"
      maxFileSize="20"
      maxFiles="10"
      traceFormat="BASIC" />
    </server>
应用程序管理的 JPA 应用程序
运行应用程序管理的 JPA 应用程序时,日志记录和跟踪由 OpenJPA 运行时控制。所有 JPA 跟踪和日志记录必须通过 OpenJPA 持久性属性进行配置。
<persistence version="2.0">
<persistence-unit>
  <properties>
     <property name="openjpa.Log" value="openjpa.jdbc.SQL=trace"/>
  </properties>
</persistence-unit>
</persistence>
值得注意的 OpenJPA 日志记录持久性属性
openjpa.ConnectionFactoryProperties=PrintParameters=true-- 如果为 true,那么 SQL 绑定参数将包括在异常和日志中。
jpa-2.1

如果启用了 jpa-2.1 功能部件,那么所有 JPA 日志记录和跟踪是通过 Liberty 记录器路由的。

受支持的跟踪字符串
  • JPA=all

    启用所有 JPA 容器跟踪和所有 EclipseLink 类别

  • eclipselink=all

    启用所有 EclipseLink 跟踪

  • 特定于 EclipseLink 的日志类别
    • sql、transaction、event、connection、query、cache、propagation、sequencing、ejb、dms、metadata、weaver、properties 和 server
    • 即:eclipselink.sql=All -- 启用 EclipseLink SQL 跟踪
<server>
...
<logging  traceSpecification="eclipselink.sql=all"
  traceFileName="trace.log"
  maxFileSize="20"
  maxFiles="10"
  traceFormat="BASIC" />
</server>
值得注意的 EclipseLink 日志记录持久性属性
eclipselink.logging.parameters -- 如果为 true,那么 SQL 绑定参数将包括在异常和日志中。

过程

persistence.xml 文件的持久性单元定义中,根据您需要的日志记录详细信息级别指定日志记录级别。 指定 eclipselink.logging.level 属性,其中的值为日志记录级别。有关可用日志记录级别列表,请参阅 EclipseLink 日志记录 Wiki 页面。以下示例将开启所有可用日志记录。
<persistence-unit name="pu">
        <properties>
           <property name="eclipselink.logging.level" value="ALL"/>
...
        </properties>
	</persistence-unit>

用于指示主题类型的图标 任务主题

信息中心的条款和条件 | 反馈


时间戳记图标 最近一次更新时间: Wednesday, 2 September 2015
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=phil&product=was-libcore-mp&topic=twlp_config_jpa_log
文件名:twlp_config_jpa_log.html