[8.5.5.6 oder höher]

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

Wenn Sie das Feature jpa-2.0 oder jpa-2.1 verwenden, können Sie die Protokollierung für die Unterstützung der Fehlerbehebung konfigurieren. Machen Sie sich mit den Protokollierungsfunktionen dieser beiden Features vertraut.
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äle
    openjpa.jdbc.SQL=all
    <server>
    ...
    <logging traceSpecification="openjpa.jdbc.SQL=all"
      traceFileName="trace.log"
      maxFileSize="20"
      maxFiles="10"
      traceFormat="BASIC" />
    </server>
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>
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>

Symbol das den Typ des Artikels anzeigt. Taskartikel

Nutzungsbedingungen für Information Center | Feedback


Symbol für Zeitmarke Letzte Aktualisierung: 25.08.2015
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=phil&product=was-libcore-mp&topic=twlp_config_jpa_log
Dateiname: twlp_config_jpa_log.html