Your Browser is not longer supported

Please use Google Chrome, Mozilla Firefox or Microsoft Edge to view the page correctly
Loading...

{{viewport.spaceProperty.prod}}

Logwriter für Connection Factory

Der Application Server stellt LogWriter zur Verfügung, auf den der BeanConnect Resource Adapter bei bestimmten Ereignissen System-Level-Informationen zu ManagedConnectionFactories und zu ManagedConnections schreibt. Diese Informationen sind für den Administrator des Application Servers bestimmt und dienen nicht der Diagnose von Problemen in den Anwendungsprogrammen.

Ereignisse und Ereignisklassen

Die Ereignisse werden in folgende Klassen unterteilt, zu denen bestimmte Ereignisse gehören:

  • Fehler

  • Transaktionen:

    • Beginn einer Transaktion für eine Connection

    • Commit/Rollback einer Transaktion für eine Connection

  • Lifecycle:

    • Erzeugen einer ManagedConnection

    • Anfordern eines Connection Handle für eine ManagedConnection

    • Switch einer Connection Handle für eine ManagedConnection

    • Freigabe einer Connection Handle und Hinzufügen der ManagedConnection zum ConnectionPool des Application Servers

    • Entnahme einer ManagedConnection aus dem ConnectionPool des Application Servers

    • Freigabe einer ManagedConnection

    • Application Exceptions, die für eine Connection Handle an eine Anwendung geworfen werden

    • System Exceptions, die für eine ManagedConnection geworfen werden

LogWriter im Application Server konfigurieren

Für Oracle WebLogic Server konfigurieren Sie den LogWriter für eine ManagedConnectionFactory in der Datei weblogic-ra.xml wie folgt:

  • Logging-Level

    Der Logging-Level bestimmt in welchem Granulat BeanConnect Meldungen zu einer ManagedConnectionFactory auf den LogWriter ausgibt. Den Logging-Level konfigurieren Sie bei Oracle WebLogic Server in der Datei weblogic-ra.xml mit der Property logLevel. Er ist für jede ManagedConnectionFactory getrennt einstellbar, es gibt die vier Log-Levels NONE, ERROR, INFO und ALL.

    Details finden Sie Konfigurations-Properties für OSI TP / LU6.2 definieren , Konfigurations-Properties für UPIC definieren . Beispiele finden Sie in Beispiel 6 im Beispiel: weblogic-ra.xml und Beispiel 8 im Beispiel: weblogic-ra.xml (UPIC) .
     

  • Logging Attribute

    Weitere Logging Attribute setzen Sie in der Definition einer ConnectionFactory im SubElement <logging>. Details zum Subelement <logging> finden Sie in der Dokumentation für den Oracle Weblogic Server in der Schema-Beschreibung für die Datei weblogic-ra.xml.

    Im Attribut <log-filename> geben Sie den Pfadnamen der Datei für die LoggingAusgabe ein.

    Mit dem Attribut <logging-enabled> schalten Sie das Logging ein oder aus.

    Mit anderen Attributen können Sie u.a. steuern, wie groß eine Log-Datei werden darf oder wieviele Log-Dateien maximal für eine ManagedConnectionFactory angelegt werden sollen, falls file rotation konfiguriert ist.

    Beispiel

    <logging>
    <log-filename>C:/temp/log/BeanConnect/echo.log</log-filename>
    <logging-enabled>true</logging-enabled>
    <rotation-type>bySize</rotation-type>
    <number-of-files-limited>true</number-of-files-limited>
    <file-count>3</file-count> 
</logging>

    Für verschiedene Connection Factories sollten Sie unterschiedliche Dateien angeben. Andernfalls kann es zu Konflikten beim Schreiben der Dateien kommen, die zu verstümmelten Log-Sätzen führen können.

Beispiel

<connection-instance>
   <jndi-name>eis/beanconnect_oltp_echo</jndi-name>
     <connection-properties>
        <logging>
           <log-filename>C:/temp/log/BeanConnect/echo.log</log-filename>
           <logging-enabled>true</logging-enabled>
           <rotation-type>bySize</rotation-type>
           <number-of-files-limited>true</number-of-files-limited>
           <file-count>3</file-count>
        </logging>
        <properties>
           <property>
             <name>ConnectionURL</name>
             <value>oltp://echo</value>
           </property>
           <property>
              <name>displayName</name>
              <value>sample application/echo</value>
           </property>
           <property>
              <name>logLevel</name>
              <value>ALL</value>
           </property>
        </properties>
     </connection-properties>
    </connection-instance>

Format der Logging-Sätze

Alle Sätze, die BeanConnect auf den LogWriter schreibt, haben folgenden Aufbau:

BeanConnect:<date-time> <identifier> message

<date-time>

gibt Datum und Uhrzeit an, an dem der Satz geschrieben wurde.
Format (Beispiel): 2018-07-17 08:30:26.810+0100.

<identifier>

gibt den Identifier an.
Für eine ManagedConnectionFactory ist dies der Wert, der in der Property DisplayName der Datei weblogic-ra.xml konfiguriert ist, siehe Konfigurations-Properties für OSI TP / LU6.2 definieren und Konfigurations-Properties für UPIC definieren .
Für eine ManagedConnection hat der Identifier die Form BCUnnnnn , wobei jedes n für eine Ziffer steht.
Für eine Connection Handle hat der Identifier die Form BCUnnnnn.i , wobei jedes n für eine Ziffer und i für eine Zahl steht.

message

Meldung, die der Resource Adapter ausgibt.

Beispiel 25 Einträge in der LogWriter Datei

  1. Für Lifecycle-Ereignisse werden Datum, Uhrzeit und Identifier der ManagedConnection protokolliert:

    BeanConnect:2018-07-17 08:30:51.225+0100 <sample application/echo>:
Managed connection with id <BCU00002> destroyed

  2. Für Ereignisse, die sich auf eine Exception beziehen, wird auch die Exception protokolliert:

    BeanConnect:2018-07-17 08:33:35.198+0100 <sample application/echo>: 
rcvString(): Exception thrown for connection <BCU00003.2>: 
net.fsc.jca.communication.EISConnectionException: 
net.fsc.jca.communication.EISConnectionException: 
exceptionShortageOfResources: shortage of resources (40Z,KD10): no 
connection to partner; partner: (SMPOSICL,gssbwrit), Dialog, error code: 
undefined error code [EC_UNDEFINED:0], connectionId: , error code: 
undefined error code [EC_UNDEFINED:0], connectionId: BCU00003.2, proxy: 
MYPROXY:30004/BCU30004, userId: BCU00003; diagnostic string:

  3. Bei einer Kommunikation mit Transaktionen werden im Allgemeinen sechs LoggingSätze erzeugt:

    BeanConnect:2018-07-17 08:30:27.138+0100 <sample application/echo>: 
Managed connection with id <BCU00002> taken from pool
BeanConnect:2018-07-17 08:30:27.138+0100 <sample application/echo>: 
Connection handle with id <BCU00002.1> created
BeanConnect:2018-07-17 08:30:27.653+0100 <sample application/echo>: 
Transaction started for managed connection "BCU00002" with xid: 
formatID=48801, gtrid=002157A9 D15A3057 A4BD, bqual=6569732F 6265616E 
636F6E6E 6563745F 6F6C7470 5F656368 6F
BeanConnect:2018-07-17 08:30:43.815+0100 <sample application/echo>: 
Transaction committed for managed connection "BCU00002" with xid: 
formatID=48801, gtrid=002157A9 D15A3057 A4BD, bqual=6569732F 6265616E 
636F6E6E 6563745F 6F6C7470 5F656368 6F
BeanConnect:2018-07-17 08:30:43.908+0100 <sample application/echo>: 
Connection handle with id <BCU00002.1> released
BeanConnect:2018-07-17 08:30:44.267+0100 <sample application/echo>: 
Managed connection with id <BCU00002> returned for pooling

  4. Bei einer Kommunikation ohne Transaktionen werden im Allgemeinen vier LoggingSätze erzeugt:

    BeanConnect:2018-07-17 08:50:41.117+0100 <sample application/echo>: 
Managed connection with id <BCU00005> taken from pool
BeanConnect:2018-07-17 08:50:41.117+0100 <sample application/echo>: 
Connection handle with id <BCU00005.4> created
BeanConnect:2018-07-17 08:50:53.753+0100 <sample application/echo>: 
Connection handle with id <BCU00005.4> released
BeanConnect:2018-07-17 08:50:54.112+0100 <sample application/echo>: 
Managed connection with id <BCU00005> returned for pooling



Powered by Atlassian Confluence and Scroll Viewport.