![[8.5.5.6 oder höher]](../ng_v8556.gif)
JPA-Protokollierung konfigurieren
Mithilfe der Protokollierung können Sie das Laufzeitverhalten einer Anwendung anzeigen, Traces erstellen und Fehler beheben. Jedes der JPA-Features stellt verschiedene Protokollierungsebenen bereit, mit denen Sie angeben können, wie detailliert die Protokollierung erfolgen soll.
Informationen zu diesem Vorgang
- jpa-2.0
- Es gibt zahlreiche unterstützte jpa-2.0-Tracespezifikationen, die über die Liberty-Konfiguration konfiguriert werden können. Diese Tracezeichenfolgen können zusammen mit allen anderen Tracespezifikationen verwendet werden.
- Containergesteuerte JPA-Anwendungen
- JPA=all
Aktiviert alle JPA-Container- und alle OpenJPA-Traces.
- openjpa=all
Aktiviert alle OpenJPA-Traces.
- OpenJPA-spezifische Protokollkanäleopenjpa.jdbc.SQL=all
<server> ... <logging traceSpecification="openjpa.jdbc.SQL=all" traceFileName="trace.log" maxFileSize="20" maxFiles="10" traceFormat="BASIC" /> </server>
- JPA=all
- Anwendungsgesteuerte JPA-Anwendungen
- Wenn Sie eine JPA-Anwendung ausführen, die anwendungsgesteuert ist, wird die Protokollierung und das Tracing von der
OpenJPA-Laufzeitumgebung gesteuert.
Das JPA-Tracing und die JPA-Protokollierung müssen vollständig mit OpenJPA-Persistenzeigenschaften konfiguriert werden.
<persistence version="2.0"> <persistence-unit> <properties> <property name="openjpa.Log" value="openjpa.jdbc.SQL=trace"/> </properties> </persistence-unit> </persistence>
- Besondere Persistenzeigenschaften für die OpenJPA-Protokollierung
- openjpa.ConnectionFactoryProperties=PrintParameters=true: Wenn Sie diese Eigenschaft auf true setzen, werden SQL-Bindungsparameter in Ausnahmen und Protokolle eingeschlossen.
- jpa-2.1
Wenn das Feature jpa-2.1 aktiviert ist, werden die JPA-Protokollierung und das JPA-Tracing vollständig über die Liberty-Protokollfunktionen weitergeleitet.
- Unterstützte Tracezeichenfolgen
- JPA=all
Aktiviert den JPA-Container-Trace und alle EclipseLink-Kategorien.
- eclipselink=all
Akiviert alle EclipseLink-Traces.
- EclipseLink-spezifische Protokollkategorien
- sql, transaction, event, connection, query, cache, propagation, sequencing, ejb, dms, metadata, weaver, properties, server
- ie: eclipselink.sql=All: Aktiviert den EclipseLink-SQL-Trace.
<server> ... <logging traceSpecification="eclipselink.sql=all" traceFileName="trace.log" maxFileSize="20" maxFiles="10" traceFormat="BASIC" /> </server>
- JPA=all
- Besondere Persistenzeigenschaften für die EclipseLink-Protokollierung
- eclipselink.logging.parameters: Wenn Sie diese Eigenschaft auf true setzen, werden SQL-Bindungsparameter in Ausnahmen und Protokolle eingeschlossen.
Vorgehensweise
Geben Sie in der Persistenzeinheitendefinition in der Datei persistence.xml
die Protokollierungsebene an, die sich nach dem gewünschten Detaillierungsgrad der Protokollierung richtet. Geben Sie die Eigenschaft eclipselink.logging.level mit der gewünschten Protokollierungsebene
als Wert an. Die Liste der verfügbaren Protokollierungsebenen finden Sie auf der Wiki-Seite zur EclipseLink-Protokollierung. Der folgende
Beispielcode aktiviert die gesamte verfügbare Protokollierung:
<persistence-unit name="pu">
<properties>
<property name="eclipselink.logging.level" value="ALL"/>
...
</properties>
</persistence-unit>