配置 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
- ie: 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>