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 helfen Konnektoren bei Verwendung mit privaten Agenten.

Für Konnektoren, die die ausführliche Protokollierung unterstützen, ist der Name des zu verwendenden Konnektors in der Dokumentation des jeweiligen Konnektors beschrieben..

Ausführliche Protokollierung aktivieren

Die ausführliche Protokollierung ist standardmäßig nicht aktiviert. Um sie 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 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 die folgenden 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 nach den 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 Konnektor eine der folgenden Optionen innerhalb des <configuration> Element, Einstellung CONNECTOR_NAME zum Name der ausführlichen Protokollierung des Connectors, Und LEVEL zum Java-Protokollierungslevel 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 Konnektor 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 Versionen 10.35 bis 10.69 oder 11.7 zu aktivieren, führen Sie die folgenden 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 nach den 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 Konnektor eine der folgenden Optionen innerhalb des <configuration> Element, Einstellung CONNECTOR_NAME zum Name der ausführlichen Protokollierung des Connectors, Und LEVEL zum Java-Protokollierungslevel 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 Konnektor 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 die folgenden 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 nach den 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 Konnektor direkt vor der Zeile, die mit beginnt, eine der folgenden Optionen hinzu: # Debug, Einstellung CONNECTOR_NAME zum Name der ausführlichen Protokollierung des Connectors, Und LEVEL zum Java-Protokollierungslevel 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 Ausschnitt der Eigenschaftendatei 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 logback.xml oder log4j.properties Datei, die der privaten Agentenversion entspricht, setzen Sie alle Ebenen auf OFF und starten Sie 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 Agentenversion an folgenden Speicherorten gespeichert:

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

Steckverbinder mit 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 Aufruf verknüpfte Anforderungsheader. Aus Sicherheitsgründen werden Header, die bestimmte Informationen enthalten, wie z. B. die in einem Header übergebenen, 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, falls vorhanden.
  • Antworttext: Der mit dem Anruf verknüpfte Antworttext, falls vorhanden.
  • HTTP-Statuscode: Der mit dem Aufruf 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...