Ausführliches Protokollieren für Connectoren mit Jitterbit privaten Agenten

Einführung

Das ausführliche Protokollieren von Connectoren kann helfen, Probleme mit bestimmten Integration Studio Connectoren zu beheben, wenn sie mit privaten Agenten verwendet werden.

Für Connectoren, die das ausführliche Protokollieren unterstützen, wird der spezifische Name des Connectoren für das ausführliche Protokollieren in der Dokumentation jedes Connectors beschrieben.

Ausführliches Protokollieren aktivieren

Das ausführliche Protokollieren ist standardmäßig nicht aktiviert. Um es zu aktivieren, müssen Sie sich bei allen privaten Agenten-Hosts in der Gruppe anmelden, eine Datei bearbeiten und alle Agenten neu starten. Die zu bearbeitende Datei hängt von der Version des privaten Agenten ab:

• Agent Version 10.70 / 11.8 und später: logback.xml bearbeiten

• Agent Version 10.35 bis 10.69 / 11.7: logback.xml bearbeiten

• Agent Version 10.34 und früher: log4j.properties bearbeiten

Agent Version 10.70 / 11.8 und später: logback.xml bearbeiten

Um das ausführliche Protokollieren auf privaten Agenten der Version 10.70 oder 11.8 und später zu aktivieren, befolgen Sie diese Schritte:

1. Erstellen Sie eine Sicherungskopie der folgenden Datei:

   LinuxWindows

   /opt/jitterbit/tomcat/shared/lib/logback.xml

   C:\Program Files\Jitterbit Agent\tomcat\shared\lib\logback.xml

2. Bearbeiten Sie die logback Datei und suchen Sie die folgenden Zeilen:

   . . .
     <logger name="org.springframework" level="WARN"/>
     <logger name="org.hibernate.engine.jdbc.internal.JdbcResourceRegistryImpl" level="ERROR"/>
   . . .
   

3. Um das Protokollniveau zu konfigurieren, fügen Sie eines der folgenden Elemente innerhalb des <configuration>-Elements hinzu, wobei Sie CONNECTOR_NAME auf den ausführlichen Protokollnamen des Connectors und LEVEL auf den Java-Protokollierungsgrad setzen:

   <logger name="org.jitterbit.connector.CONNECTOR_NAME" level="LEVEL"/>
   

   <logger name="org.jitterbit.connector.verbose.logging.CONNECTOR_NAME" level="LEVEL"/>
   

   Beispiel

   Für den Workday Prism Analytics-Connector lautet der ausführliche Protokollname workdayprismanalytics (zu finden in der Dokumentation des Workday Prism Analytics-Connectors):

   Beispiel für Workday Prism Analytics

   . . .
     <logger name="org.springframework" level="WARN"/>
     <logger name="org.hibernate.engine.jdbc.internal.JdbcResourceRegistryImpl" level="ERROR"/>
     <logger name="org.jitterbit.connector.verbose.logging.workdayprismanalytics" level="DEBUG"/>
   . . .
   

4. (Optional) Fügen Sie zusätzliche Zeilen für andere Connectoren hinzu.

5. Speichern Sie die Datei und starten Sie den Linux oder Windows privaten Agenten neu.

Agenten-Version 10.35 bis 10.69 / 11.7: logback.xml bearbeiten

Um das ausführliche Protokollieren auf privaten Agenten der Versionen 10.35 bis 10.69 oder der Version 11.7 zu aktivieren, befolgen Sie diese Schritte:

1. Erstellen Sie eine Sicherungskopie der folgenden Datei:

   LinuxWindows

   /opt/jitterbit/tomcat/webapps/axis/WEB-INF/lib/logback.xml

   C:\Program Files\Jitterbit Agent\tomcat\webapps\axis\WEB-INF\lib\logback.xml

2. Bearbeiten Sie die logback-Datei und suchen Sie die folgenden Zeilen:

   . . .
     <logger name="org.springframework" level="WARN"/>
     <logger name="org.hibernate.engine.jdbc.internal.JdbcResourceRegistryImpl" level="ERROR"/>
   . . .
   

3. Um das Protokollniveau zu konfigurieren, fügen Sie eines der folgenden Elemente innerhalb des <configuration>-Elements hinzu, wobei Sie CONNECTOR_NAME auf den ausführlichen Protokollnamen des Connectors und LEVEL auf den Java-Protokollierungsgrad setzen:

<logger name="org.jitterbit.connector.CONNECTOR_NAME" level="LEVEL"/>

<logger name="org.jitterbit.connector.verbose.logging.CONNECTOR_NAME" level="LEVEL"/>

. . .
      <logger name="org.springframework" level="WARN"/>
      <logger name="org.hibernate.engine.jdbc.internal.JdbcResourceRegistryImpl" level="ERROR"/>
      <logger name="org.jitterbit.connector.verbose.logging.workdayprismanalytics" level="DEBUG"/>
    . . .

1. (Optional) Fügen Sie zusätzliche Zeilen für andere Connectoren hinzu.

2. Speichern Sie die Datei und starten Sie den Linux oder Windows privaten Agenten neu.

Agent-Version 10.34 und früher: log4j.properties bearbeiten{: #verboseloggingforconnectors-log4j }

Um das ausführliche Logging auf privaten Agenten der Version 10.34 und früher zu aktivieren, befolgen Sie diese Schritte:

1. Erstellen Sie eine Sicherungskopie der folgenden Datei:

   LinuxWindows

   /opt/jitterbit/tomcat/webapps/axis/WEB-INF/lib/log4j.properties

   C:\Program Files\Jitterbit Agent\tomcat\webapps\axis\WEB-INF\lib\log4j.properties

2. Bearbeiten Sie die Datei und suchen Sie die folgenden Zeilen:

   . . .
   log4j.logger.org.springframework=WARN
   log4j.logger.org.hibernate.engine.jdbc.internal.JdbcResourceRegistryImpl=ERROR
   
   # Debug options can be turned on by uncommenting these lines
   # . . .
   

3. Um das Log-Level zu konfigurieren, fügen Sie eine der folgenden Zeilen je nach Connector direkt vor der Zeile ein, die mit # Debug beginnt, wobei Sie CONNECTOR_NAME auf den ausführlichen Logging-Namen des Connectors und LEVEL auf den Java-Logging-Level setzen:

   log4j.logger.org.jitterbit.connector.CONNECTOR_NAME=LEVEL
   

   log4j.logger.org.jitterbit.connector.verbose.logging.CONNECTOR_NAME=LEVEL
   

   Beispiel

   Am Beispiel des Workday Prism Analytics Connectors lautet der Name für das ausführliche Logging workdayprismanalytics (zu finden in der Dokumentation des Workday Prism Analytics Connectors). Dies sollte dann der Ausschnitt der Eigenschaften-Datei sein:

        . . .
        log4j.logger.org.springframework=WARN
        log4j.logger.org.hibernate.engine.jdbc.internal.JdbcResourceRegistryImpl=ERROR
        log4j.logger.org.jitterbit.connector.verbose.logging.workdayprismanalytics=DEBUG

        # Debug options can be turned on by uncommenting these lines
        # . . .
        ```

4.  (Optional) Fügen Sie zusätzliche Zeilen für andere Connectoren hinzu.

5.  Speichern Sie die Datei und starten Sie den [Linux](/de/agent/linux/#manage) oder [Windows](/de/agent/windows/#manage) privaten Agenten neu.

## Deaktivieren Sie das ausführliche Protokollieren {: #disable-verbose-logging }

Um das ausführliche Protokollieren zu deaktivieren, bearbeiten Sie die Datei `logback.xml` oder `log4j.properties`, die zur Version des privaten Agenten gehört, setzen Sie alle Ebenen auf `OFF` und starten Sie dann den Agenten neu.

## Anzeigen ausführlicher Protokolle {: #view-verbose-logs }

Wenn das ausführliche Protokollieren aktiviert ist, werden Einträge in die Datei `jitterbit-axis.log` geschrieben. Öffnen Sie die Protokolldatei in einem Editor, um die Einträge anzuzeigen. Die Protokolldatei wird an diesen Orten gespeichert, abhängig vom Betriebssystem und der Agenten-Version:

=== "Linux"
    `/opt/jitterbit/log/jitterbit-axis.log`

=== "Windows"
    `C:\Program Files\Jitterbit Agent\log\jitterbit-axis.log`

Um Einträge zu finden, suchen Sie nach den Begriffen `INFO`, `DEBUG` oder `VerboseLogger` in der Datei. Einträge können Nachrichten, Schemata und andere Informationen enthalten, die beim Debuggen verwendet werden können. Ein Auszug ist hier gezeigt:

```txt
2020-12-07 15:06:31,445 +0530 http-nio-127.0.0.1-46912-exec-9 DEBUG org.jitterbit.connector.verbose.logging.epicorerp.VerboseLogger:22 - org.jitterbit.connector.epicor.EpicorClient.PATCH, msg: {"method: ":"PATCH","headers: ":"Authorization: Basic bWFuYWdlcjomd1I3aWk1IQ==\nkeep-alive: true\n","URI: ":"https://sample.developer.epicor.com/%2Fserver%2Fapi%2Fv1/BaqSvc/PartsAdvancedBPM","requestPayload: ":"{\"Part_Company\":\"EPIC01\",\"SysRowID\":\"470bf6e7-cba1-4a7b-6ee7-a33b015c3cbc\",\"Part_PartNum\":\"001_MPCons\",\"Part_UserDecimal1\":\"0\"}"}
2020-12-07 15:06:31,742 +0530 http-nio-127.0.0.1-46912-exec-9 DEBUG org.jitterbit.connector.verbose.logging.epicorerp.VerboseLogger:22 - org.jitterbit.epicor.adapter.common.CommonResponseGenerator.statusCode, msg: 200
2020-12-07 15:06:31,742 +0530 http-nio-127.0.0.1-46912-exec-9 DEBUG org.jitterbit.connector.verbose.logging.epicorerp.VerboseLogger:22 - org.jitterbit.epicor.adapter.common.CommonResponseGenerator.responsePayload, msg: {
  "odata.metadata":"https://sample.developer.epicor.com/server/api/v1/BaqSvc/PartsAdvancedBPM/$metadata#Epicor.DynamicQuery.QueryResults","value":[
    {
      "Part_Company":"EPIC06","Part_PartNum":"001_MPCons","Part_UserChar1":"","Part_UserDecimal1":"0","RowMod":"","RowIdent":"38ca34b4-2440-4d3d-ac3b-177b610f01ac","SysRowID":"470bf6e7-cba1-4a7b-6ee7-a33b015c3cbc"
    }
  ]
}

Zusätzliche Protokollinformationen

Connectoren, die das Format org.jitterbit.connector.<connector_name> für das ausführliche Protokollieren verwenden, enthalten bestimmte Informationen in der Protokolldatei, wenn sie auf die Protokollebene DEBUG gesetzt sind:

• HTTP-Anfragen: HTTP-Anfragen vom Connector.

  • URL: Die mit dem Aufruf verbundene URL, einschließlich aller Abfrage- und Pfadparameter, falls vorhanden.
  • Anforderungsheader: Anforderungsheader, die mit dem Aufruf verbunden sind. Aus Sicherheitsgründen werden Header, die bestimmte Informationen enthalten, wie die in einem Autorisierungsheader übermittelten, mit Sternchen maskiert.
  • Antwortheader: Antwortheader, die mit dem Aufruf verbunden sind.
  • HTTP-Methode: Die mit dem Aufruf verbundene HTTP-Methode, eine von HEAD, GET, POST, PUT, PATCH, DELETE, OPTIONS, CONNECT oder TRACE.
  • Antwortzeit: Die Antwortzeit des Aufrufs in Millisekunden.
  • Anforderungstext: Der Anforderungstext, der mit dem Aufruf verbunden ist, falls vorhanden.
  • Antworttext: Der Antworttext, der mit dem Aufruf verbunden ist, falls vorhanden.
  • HTTP-Statuscode: Der HTTP-Statuscode, der mit dem Aufruf verbunden ist.

• Fehlermeldungen: Zusätzliche Protokollnachrichten zur Unterstützung bei der Fehlersuche von Connector-Problemen.

Protokollnachrichten enthalten auch die Harmony-Organisations-ID und die Umgebungs-ID, die mit dem Projekt als orgId bzw. envId verknüpft sind:

2023-05-07 18:13:42 http-nio-127.0.0.1-46912-exec-6 DEBUG org.jitterbit.connector.<connector_name>.Connection:80 [orgId:-][envId:100000] - Verbindung wird geschlossen
2023-05-07 18:13:42 http-nio-127.0.0.1-46912-exec-6 DEBUG org.jitterbit.connector.<connector_name>.client.Client:80 [orgId:-][envId:100000] - Verbindung wird geschlossen...