Anwendungen mit JPA protokollieren
Durch Protokollierung können Sie das Laufzeitverhalten einer Anwendung anzeigen, verfolgen und die dort auftretenden Fehler beheben. Java™ Persistence API (JPA) stellt ein in den Anwendungsserver integriertes flexibles Protokollierungssystem bereit, das Sie bei der Fehlerbehebung unterstützt.
Informationen zu diesem Vorgang
Die Protokollierung unterstützt Sie bei der Fehlerbehebung.
- Protokollierung für EclipseLink
- Unterstützte Tracezeichenfolgen für containergesteuerte JPA-Anwendungen
- JPA=all
Aktiviert den JPA-Container-Trace
- eclipselink=all
Aktiviert den vollständigen EclipseLink-Trace (d. h. eclipselink.*=all)
- EclipseLink-spezifische Protokollkategorien
Für EclipseLink spezifische Tracezeichenfolgen (d. h. eclipselink.sql=all)
- JPA=all
- Unterstützte Tracezeichenfolgen für anwendungsgesteuerte JPA-Anwendungen
Wenn Sie eine anwendungsgesteuerte JPA-Anwendung ausführen, werden die Protokollierung und das Tracing von der EclipseLink-Laufzeit gesteuert. Das gesamte JPA-Tracing und die gesamte JPA-Protokollierung müssen über die EclipseLink-Persistenzeigenschaften in der Datei persistence.xml konfiguriert werden.
- Relevante Persistenzeigenschaften für die Protokollierung:
- eclipselink.logging.parameters
Ist die Eigenschaft auf "true" gesetzt, werden SQL-Bind-Parameter in Ausnahmen und Protokolle aufgenommen.
- eclipselink.logging.parameters
- Protokollierung für OpenJPA
- Unterstützte Tracezeichenfolgen für containergesteuerte JPA-Anwendungen
- JPA=all
Aktiviert den JPA-Container-Trace
- OpenJPA=all
Aktiviert den vollständigen OpenJPA-Trace (d. h. openjpa.*=all)
- OpenJPA-spezifische Protokollkategorien
Für OpenJPA spezifische Tracezeichenfolgen (d. h. openjpa.jdbc.SQL=all)
- JPA=all
- Unterstützte Tracezeichenfolgen für anwendungsgesteuerte JPA-Anwendungen
Wenn Sie eine anwendungsgesteuerte JPA-Anwendung ausführen, werden die Protokollierung und das Tracing von der OpenJPA-Laufzeit gesteuert. Das gesamte JPA-Tracing und die gesamte JPA-Protokollierung müssen über die OpenJPA-Persistenzeigenschaften in der Datei persistence.xml konfiguriert werden.
- Relevante OpenJPA-Persistenzeigenschaften für die Protokollierung:
- openjpa.ConnectionFactoryProperties=PrintParameters=true
Ist die Eigenschaft auf "true" gesetzt, werden SQL-Bind-Parameter in Ausnahmen und Protokolle aufgenommen.
- Die Eigenschaft openjpa.Log wird ignoriert, wenn sie in einer CMP-Einheit (Container-Managed Persistence) definiert ist, die die mit dem Anwendungsserver bereitgestellten Persistenzprovider verwendet. In diesem Fall muss die Standardtracespezifikation für den Anwendungsserver verwendet werden.
- openjpa.ConnectionFactoryProperties=PrintParameters=true
- WSJPA-spezifische Traceinformationen
- Tracekanäle für WSJPA:
- wsjpa.pdq
Trace für alle Interaktionen zwischen dem Speichermanager und der PDQ-Laufzeit
- wsjpa.Sqlgen
Diagnosetrace für das Programm "wsdbgen"
- wsjpa.pdq
Vorgehensweise
<persistence-unit name="pu">
<properties>
<property name="eclipselink.logging.level" value="ALL"/>
...
</properties>
</persistence-unit>