Connect Logs
Gilt für: serverseitige und clientseitige Connect-Verarbeitung Betrifft: Administratoren, Integratoren
Connect-Aufrufe werden im Log der Komponente protokolliert, die sie verarbeitet. Je nach Verarbeitungsweg ist das eine Server-Applikation oder primedocs Desktop. primedocs Desktop kann die empfangenen Connect-Aufrufe zusätzlich in einem eigenen Connect-Protokoll aufzeichnen. Die Übersicht aller Logs steht unter Logging.
Wo liegen Connect-Logs?
| Verarbeitungsweg | Log-Ort | Datei |
|---|---|---|
| Serverseitig über die Connect API | Server-Applikation WebApi | serverApp.oolog |
Serverseitig über den Connect-Dienst (/api/v1/Connect) | Server-Applikation Connect | serverApp.oolog |
Clientseitig (.pdcx/.pdck, Konsole, URI-Aufruf) | primedocs Desktop | PrimeDocs.Client.txt |
| Clientseitig, Connect-Protokoll (optional) | primedocs Desktop, %TEMP%\primedocsConnectLogger | eine Datei pro Aufruf |
Serverseitige Verarbeitung
Wird die Dokumentgenerierung serverseitig ausgelöst, landen die Einträge in der serverApp.oolog der verarbeitenden Server-Applikation. Diese Datei wird wie alle Server-Logs über das Admin Dashboard heruntergeladen:
Clientseitige Verarbeitung
Wird Connect über primedocs Desktop verarbeitet (Doppelklick auf eine .pdcx-/.pdck-Datei, Konsolen- oder URI-Aufruf), werden die Einträge in das Client-Log geschrieben:
Um den tatsächlich empfangenen Aufruf nachzuvollziehen, lässt sich unter primedocs › Optionen › primedocs Connect mit Protokollierung aktivieren zusätzlich das Connect-Protokoll einschalten. primedocs Desktop speichert dann jedes empfangene Connect-XML als eigene Datei. Die Aufzeichnung endet aus Datenschutzgründen 24 Stunden nach der Aktivierung automatisch, siehe Connect-Protokoll.
Was wird protokolliert?
- Der Eingang eines Connect-Aufrufs.
- Bei ausführlichem Log-Level (Debug/Trace) zusätzlich das übermittelte Connect-XML (nützlich, um den tatsächlich empfangenen Aufruf nachzuvollziehen).
- Validierungsfehler (z.B. wenn keine gültige Connect-Aktion erkannt wird).
- Fehler bei der Dokumentgenerierung.
Connect-Einträge in der Datenbank
Ist in der primedocs.config das Attribut databaseLoggingEnabled="true" gesetzt, werden Warnungen und Fehler der Server-Applikationen zusätzlich in die Datenbank geschrieben und lassen sich im Logging-Tab der DataSourceAdminApp einsehen (siehe Logging in die Datenbank). Die Spalte Application zeigt die verarbeitende Applikation: WebApi für Aufrufe über die Connect API, Connect für Aufrufe über den Connect-Dienst.