![[8.5.5.6 或更高版本]](../ng_v8556.gif)
配置 JPA 日志记录
记录支持对应用程序的运行时行为进行查看、跟踪和故障诊断。每个 JPA 功能部件提供不同级别的日志记录,以供您指定所需的日志记录详细程度。
关于此任务
- 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=all
- 应用程序管理的 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>
- JPA=all
- 值得注意的 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>