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)

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.

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)

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.
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"

Vorgehensweise

Geben Sie in der Definition der Persistenzeinheit in der Dateipersistence.xml die Protokollstufe an, die die gewünschten Protokollierungsdetails liefert. Legen Sie die Eigenschaft eclipselink.logging.level fest, deren Wert die Protokollstufe angibt. Die Liste der verfügbaren Protokollstufen finden Sie auf der Wikiseite zur EclipseLink-Protokollierung. Im folgenden Beispiel wird die gesamte verfügbare Protokollierung aktiviert.
<persistence-unit name="pu">
        <properties>
           <property name="eclipselink.logging.level" value="ALL"/>
...
        </properties>
</persistence-unit>

Symbol, das den Typ des Artikels anzeigt. Taskartikel



Symbol für Zeitmarke Letzte Aktualisierung: 25.05.2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tejb_loggingwjpa
Dateiname:tejb_loggingwjpa.html