Unterschiede
Hier werden die Unterschiede zwischen zwei Versionen angezeigt.
| Nächste Überarbeitung | Vorhergehende Überarbeitung | ||
| protokollierung_co [2026/05/19 06:31] – angelegt Thomas Speiser | protokollierung_co [2026/05/19 06:48] (aktuell) – Thomas Speiser | ||
|---|---|---|---|
| Zeile 1: | Zeile 1: | ||
| **Protokollierung in CO** | **Protokollierung in CO** | ||
| - | Die Protokollierung in Concept Office wurde grundlegend überarbeitet. Bisher wurden Protokolle in verschiedene Textdateien geschrieben. Diese Möglichkeit besteht weiterhin, kann jedoch durch den Anwender deaktiviert werden. Die Protokollierung wurde mit dem Open Source Tool „Serilog“ implementiert. Für den Anwender ergibt sich der Vorteil, dass er besser steuern kann, welche Protokolle (steuerbar über sog. Senken) in welcher Ausführlichkeit erstellt werden. Außerdem ist es möglich, Protokolle besser auszuwerten, | + | Die Protokollierung in Concept Office wurde grundlegend überarbeitet. Bisher wurden Protokolle in verschiedene Textdateien geschrieben. Diese Möglichkeit besteht weiterhin, kann jedoch durch den Anwender deaktiviert werden. Die Protokollierung wurde mit dem Open Source Tool "Serilog" |
| - | {{: | + | |
| __Einstellungsmöglichkeiten: | __Einstellungsmöglichkeiten: | ||
| - | Im CO-Konfigurationsmanager gibt es auf der Registerkarte | + | Im CO-Konfigurationsmanager gibt es auf der Registerkarte |
| - | + | ||
| - | **ACHTUNG: Bitte mit Vorsicht und unter Beobachtung z.B. für SQL Server die Tabelle „__LogEvents“ die Log-Level-Schalter konfigurieren! Eine zu detaillierte Protokollierung mit langer Löschfrist kann den SQL Server stark beeinträchtigen bzw. Stoppen!** | + | {{:registerkarte_protokoll.jpg?600|}} |
| - | • Logeinträge | + | <note warning> |
| - | • JSON: Ausgabe in einer Textdatei im JSON-Format. | + | Eine zu detaillierte Protokollierung mit langer Löschfrist kann den SQL Server stark beeinträchtigen bzw. Stoppen!</ |
| - | • Notepad: Ausgabe in einer aktiven Notepad-Instanz. Sollte nur vorübergehend aktiviert werden. | + | |
| - | • SQL | + | * __Logeinträge |
| - | • Seq: Ausgabe auf einen Webserver, kann mit dem Tool „Seq" | + | * __JSON:__ Ausgabe in einer Textdatei im JSON-Format. |
| - | • Text: Ausgabe als Textdatei. | + | * __Notepad:__ Ausgabe in einer aktiven Notepad-Instanz. Sollte nur vorübergehend aktiviert werden. |
| + | * __SQL Server:__ Ausgabe auf die aktuelle Datenbank in die Tabelle | ||
| + | * __Seq:__ Ausgabe auf einen Webserver, kann mit dem Tool "Seq" | ||
| + | * __Text:__ Ausgabe als Textdatei. | ||
| Textlog im alten Format: gibt die Logs mit dem bisher verwendeten Verfahren in Textdateien aus. | Textlog im alten Format: gibt die Logs mit dem bisher verwendeten Verfahren in Textdateien aus. | ||
| - | Die Einstellungen werden in der Datei „Office.Dat" | + | Die Einstellungen werden in der Datei "Office.Dat" |
| Folgende Log-Level sind verfügbar: | Folgende Log-Level sind verfügbar: | ||
| - | • Aus: es wird keine Loginformation auf diese Senke ausgegeben | + | * __Aus:__ es wird keine Loginformation auf diese Senke ausgegeben |
| - | • Ausführlich: es werden alle Loginformationen ausgegeben. Sollte nur zur Fehlersuche aktiviert werden, wenn Debug nicht ausreichend ist. | + | * __Ausführlich:__ es werden alle Loginformationen ausgegeben. Sollte nur zur Fehlersuche aktiviert werden, wenn Debug nicht ausreichend ist. |
| - | • Debug: es werden Loginformationen zur Fehlersuche ausgegeben. | + | * __Debug:__ es werden Loginformationen zur Fehlersuche ausgegeben. |
| - | • Information: gibt interessante Loginformationen aus. Sollte als Standard für SQL Server und Seq eingestellt werden. Wird dieser Level für Textdateien aktiviert, so können diese unter Umständen sehr groß werden. | + | * __Information:__ gibt interessante Loginformationen aus. Sollte als Standard für SQL Server und Seq eingestellt werden. Wird dieser Level für Textdateien aktiviert, so können diese unter Umständen sehr groß werden. |
| - | • Warnung: gibt Loginformationen bzgl. möglicher Probleme aus. | + | * __Warnung:__ gibt Loginformationen bzgl. möglicher Probleme aus. |
| - | • Fehler: gibt Loginformationen zu Fehlern und unerwarteten Situationen aus. | + | * __Fehler:__ gibt Loginformationen zu Fehlern und unerwarteten Situationen aus. |
| - | • Kritisch: gibt Loginformationen zu kritischen Fehlern aus. | + | * __Kritisch:__ gibt Loginformationen zu kritischen Fehlern aus. |
| - | Auswertung von Protokollen | + | Auswertung von Protokollen: |
| Protokolle können in verschiedenen Formen mit jeweils speziellen Auswertungsmöglichkeiten erstellt werden. | Protokolle können in verschiedenen Formen mit jeweils speziellen Auswertungsmöglichkeiten erstellt werden. | ||
| Zeile 37: | Zeile 38: | ||
| SQL Server: | SQL Server: | ||
| - | In der Tabelle | + | In der Tabelle |
| - | • Id: fortlaufende Nummer | + | * __Id:__ fortlaufende Nummer |
| - | • Message: Die Meldung mit aufgelösten Parametern z.B. „Testnachricht Auftrag: 3, Position: 2" | + | * __Message:__ Die Meldung mit aufgelösten Parametern z.B. "Testnachricht Auftrag: 3, Position: 2" |
| - | • Message | + | * __Message |
| - | • Level: Log-Level in Textform | + | * __Level:__ Log-Level in Textform |
| - | • TimeStamp: Zeitpunkt, zu dem die Meldung erstellt wurde | + | * __TimeStamp:__ Zeitpunkt, zu dem die Meldung erstellt wurde |
| - | • Exception: zusätzliche Daten, wenn eine Ausnahme (Exception) auftrat. | + | * __Exception:__ zusätzliche Daten, wenn eine Ausnahme (Exception) auftrat. |
| - | • LogEvent: weitere Daten im JSON-Format. Diese können in eine SQL-Abfrage eingezogen werden | + | * __LogEvent:__ weitere Daten im JSON-Format. Diese können in eine SQL-Abfrage eingezogen werden |
| - | • UserName: Benutzername | + | * __UserName:__ Benutzername |
| - | • MachineName: Rechnername | + | * __MachineName:__ Rechnername |
| - | • AppVersion: Anwendungsversion | + | * __AppVersion:__ Anwendungsversion |
| - | • OperatingSystem: Betriebssystem | + | * __OperatingSystem:__ Betriebssystem |
| - | • ProtocolType: CO-Protokollname | + | * __ProtocolType:__ CO-Protokollname |
| - | • FileName: Name der Datei, in welche der Protokolleintrag im Dateisystem geschrieben worden wäre | + | * __FileName:__ Name der Datei, in welche der Protokolleintrag im Dateisystem geschrieben worden wäre |
| - | • Client: Mandant | + | * __Client:__ Mandant |
| - | • MemberName. SourceFiIepath, | + | * __MemberName. SourceFiIepath, |
| - | • Auftragsnummer. Bestellnummer, | + | * __Auftragsnummer. Bestellnummer, |
| Auf diese Tabelle können Abfragen mit der CO-Recherche erstellt werden. Die Einträge werden durch Concept Office automatisch nach 2 Monaten gelöscht. | Auf diese Tabelle können Abfragen mit der CO-Recherche erstellt werden. Die Einträge werden durch Concept Office automatisch nach 2 Monaten gelöscht. | ||
| - | __Seq:__ | + | Seq: |
| Logeinträge werden an Seq übergeben. Hierzu muss ein entsprechender Webserver aufgesetzt werden. | Logeinträge werden an Seq übergeben. Hierzu muss ein entsprechender Webserver aufgesetzt werden. | ||
| Weitere Informationen befinden sich hier: https:// | Weitere Informationen befinden sich hier: https:// | ||
| Bei einer lokalen Seq-Installation können die Events im Browser mit http:// | Bei einer lokalen Seq-Installation können die Events im Browser mit http:// | ||
| - | |||
