Ausführliche Protokollierung für Konnektoren, die private Jitterbit-Agenten verwenden

Einführung

Die ausführliche Protokollierung des Connectors kann bei der fehlerbehebung von Problemen mit bestimmten Integration Studio-Anschlüsse bei Verwendung mit privaten Agenten.

Für Konnektoren, die die ausführliche Protokollierung von Konnektoren unterstützen, wird der zu verwendende spezifische Name des Konnektors für die ausführliche Protokollierung in der Dokumentation jedes Konnektors beschrieben.

Ausführliches Protokollieren aktivieren

Die ausführliche Protokollierung ist standardmäßig nicht aktiviert. Um sie zu aktivieren, müssen Sie sich bei allen privaten Agent-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 höher: Bearbeiten logback.xml

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

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

Agent Version 10.70 / 11.8 und höher: Bearbeiten logback.xml

Um die ausführliche Protokollierung auf privaten Agenten der Version 10.70 oder 11.8 und höher zu aktivieren, führen Sie diese Schritte aus:

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 das 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 die Protokollebene zu konfigurieren, fügen Sie je nach Connector eines der folgenden Elemente innerhalb des <configuration> Element, Einstellung CONNECTOR_NAME zum ausführlichen Protokollierungsnamen des Connectors, Und LEVEL zur Java-Protokollierungsebene Zeichenfolge:

   <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 Protokollierungsname workdayprismanalytics (zu finden in der Dokumentation zum Workday Prism Analytics Connector):

   Example for 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 Konnektoren hinzu.

5. Speichern Sie die Datei und starten Sie Linux neu oder Windows Privatagent.

Agent 10.35 bis 10.69 / 11.7: Bearbeiten logback.xml

Um die ausführliche Protokollierung auf privaten Agenten der Version 10.35 bis 10.69 oder der Version 11.7 zu aktivieren, führen Sie diese Schritte aus:

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 das 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 die Protokollebene zu konfigurieren, fügen Sie je nach Connector eines der folgenden Elemente innerhalb des <configuration> Element, Einstellung CONNECTOR_NAME zum ausführlichen Protokollierungsnamen des Connectors, Und LEVEL zur Java-Protokollierungsebene Zeichenfolge:

   <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 Protokollierungsname workdayprismanalytics (zu finden in der Dokumentation zum Workday Prism Analytics Connector):

   Example for 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 Konnektoren hinzu.

5. Speichern Sie die Datei und starten Sie Linux neu oder Windows Privatagent.

Agent 10.34 und früher: bearbeiten log4j.properties

Um die ausführliche Protokollierung auf privaten Agenten der Version 10.34 und früher zu aktivieren, führen Sie diese Schritte aus:

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 die Protokollebene zu konfigurieren, fügen Sie je nach Connector direkt vor der Zeile, die mit beginnt, eines der folgenden Elemente hinzu # Debug, Einstellung CONNECTOR_NAME zum ausführlichen Protokollierungsnamen des Connectors, Und LEVEL zur Java-Protokollierungsebene Zeichenfolge:

   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 Konnektors lautet sein ausführlicher Protokollierungsname workdayprismanalytics (zu finden in der Dokumentation zum Workday Prism Analytics Connector). Dies sollte dann der Eigenschaftsdateiausschnitt 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 Konnektoren hinzu.

5. Speichern Sie die Datei und starten Sie Linux neu oder Windows Privatagent.

Ausführliche Protokollierung deaktivieren

Um die ausführliche Protokollierung zu deaktivieren, bearbeiten Sie die logback.xml oder log4j.properties Datei, die der privaten Agent-Version entspricht, setzen Sie alle Ebenen auf OFF, und starten Sie dann den Agenten neu.

Ausführliche Protokolle anzeigen

Wenn die ausführliche Protokollierung aktiviert ist, werden Einträge in das jitterbit-axis.log Datei. Öffnen Sie die Protokolldatei in einem Editor, um die Einträge anzuzeigen. Die Protokolldatei wird je nach Betriebssystem und Agentversion an diesen Speicherorten gespeichert:

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 wird hier angezeigt:

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

Anschlüsse mit dem org.jitterbit.connector.<connector_name> Das ausführliche Protokollierungsnamenformat enthält bestimmte Informationen in der Protokolldatei, wenn es auf DEBUG Protokollierungsebene:

• HTTP-Aufrufe: HTTP-Aufrufe vom Connector.

  • URL: Die mit dem Aufruf verknüpfte URL, einschließlich aller Abfrage und Pfadparameter, falls vorhanden.
  • Anforderungsheader: Mit dem Anruf verknüpfte Anforderungsheader. Aus Sicherheitsgründen werden Header, die bestimmte Informationen enthalten, wie sie beispielsweise in einem Header übergeben werden, mit Sternchen maskiert.
  • Antwort-Header: Mit dem Anruf verknüpfte Antwort-Header.
  • HTTP-Methode: Die mit dem Aufruf verknüpfte HTTP-Methode, eine von HEAD, GET, POST, PUT, PATCH, DELETE, OPTIONS, CONNECT, oder TRACE.
  • Reaktionszeit: Die Reaktionszeit des Anrufs in Millisekunden.
  • Anforderungstext: Der mit dem Aufruf verknüpfte Anforderungstext, sofern vorhanden.
  • Antworttext: Der mit dem Anruf verknüpfte Antworttext, sofern vorhanden.
  • HTTP-Statuscode: Der mit dem Anruf verknüpfte HTTP-Statuscode.

• Meldungen zur Fehlerbehebung: Zusätzliche Protokollmeldungen zur Unterstützung bei der Behebung von Connector-Problemen.

Protokollnachrichten enthalten auch die Harmony Organisations-ID und Umfeld-ID im Zusammenhang mit dem Projekt als orgId Und envId jeweils:

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] - Closing connection
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] - Connection is closing...