Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

Beide Seiten der vorigen RevisionVorhergehende Überarbeitung
Nächste Überarbeitung
Vorhergehende Überarbeitung
protokollierung_co [2026/05/19 06:40] Thomas Speiserprotokollierung_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, da sie strukturiert vorliegen. D.h. , bisher konnten die Protokolle nur durch eine Textsuche ausgewertet werden, künftig z.B. mittels Sql- oder JSON-Abfragen oder mittels des Web-Tools Seq" (https://datalust.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 "Serilogimplementiert. 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, da sie strukturiert vorliegen. D.h. , bisher konnten die Protokolle nur durch eine Textsuche ausgewertet werden, künftig z.B. mittels Sql- oder JSON-Abfragen oder mittels des Web-Tools "Seq" (https://datalust.co/).
  
 __Einstellungsmöglichkeiten:__ __Einstellungsmöglichkeiten:__
-Im CO-Konfigurationsmanager gibt es auf der Registerkarte Protokoll" folgende Einstellungsmöglichkeiten (zuvor muss der Button Änderungen erlauben“ geklickt und mit bekanntem Passwort die Funktion temporär freigeschaltet werden):+Im CO-Konfigurationsmanager gibt es auf der Registerkarte "Protokoll" folgende Einstellungsmöglichkeiten (zuvor muss der Button "Änderungen erlaubengeklickt und mit bekanntem Passwort die Funktion temporär freigeschaltet werden):
  
 {{:registerkarte_protokoll.jpg?600|}} {{:registerkarte_protokoll.jpg?600|}}
  
-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!+<note warning>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!</note>
  
-  * __Logeinträge ab Level:__ Filtert die Logeinträge aller Senken. Wird hier z.B. Warnung" eingetragen und unter JSON Info", dann werden trotzdem auch in JSON nur Einträge ab Level Warnung" geloggt.+  * __Logeinträge ab Level:__ Filtert die Logeinträge aller Senken. Wird hier z.B. "Warnung" eingetragen und unter JSON "Info", dann werden trotzdem auch in JSON nur Einträge ab Level "Warnung" geloggt.
   * __JSON:__ Ausgabe in einer Textdatei im JSON-Format.   * __JSON:__ Ausgabe in einer Textdatei im JSON-Format.
   * __Notepad:__ Ausgabe in einer aktiven Notepad-Instanz. Sollte nur vorübergehend aktiviert werden.   * __Notepad:__ Ausgabe in einer aktiven Notepad-Instanz. Sollte nur vorübergehend aktiviert werden.
-  * __SQL Server:__ Ausgabe auf die aktuelle Datenbank in die Tabelle „__LogEvents“ +  * __SQL Server:__ Ausgabe auf die aktuelle Datenbank in die Tabelle "LogEvents“ 
-  * __Seq:__ Ausgabe auf einen Webserver, kann mit dem Tool Seq"  (https://datalust.co/) abgefragt werden.+  * __Seq:__ Ausgabe auf einen Webserver, kann mit dem Tool "Seq"  (https://datalust.co/) abgefragt werden.
   * __Text:__ Ausgabe als Textdatei.   * __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" gespeichert und gelten für alle Nutzer.+Die Einstellungen werden in der Datei "Office.Dat" gespeichert und gelten für alle Nutzer.
  
-__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.
Zeile 30: Zeile 31:
   * __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 „__LogEvents" sind folgende Spalten verfügbar:+In der Tabelle "LogEvents" sind folgende Spalten verfügbar:
   * __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 Template:__ die Meldung, ohne dass Parameter aufgelöst wurden (z.B. Testnachricht Auftrag: {Auftragsnummer}, Position: {Positionsnummer}". Hierdurch kann z.B. auf bestimmte Meldungen gefiltert oder gruppiert werden.+  * __Message Template:__ die Meldung, ohne dass Parameter aufgelöst wurden (z.B. "Testnachricht Auftrag: {Auftragsnummer}, Position: {Positionsnummer}". Hierdurch kann z.B. auf bestimmte Meldungen gefiltert oder gruppiert werden.
   * __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
Zeile 57: Zeile 58:
 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://datalust.co/ Weitere Informationen befinden sich hier: https://datalust.co/
 Bei einer lokalen Seq-Installation können die Events im Browser mit http://localhost:5341/#/events abgefragt werden. Bei einer lokalen Seq-Installation können die Events im Browser mit http://localhost:5341/#/events abgefragt werden.
- 
protokollierung_co.1779172847.txt.gz · Zuletzt geändert: 2026/05/19 06:40 von Thomas Speiser
CC Attribution-Noncommercial-Share Alike 4.0 International
Driven by DokuWiki Recent changes RSS feed Valid CSS Valid XHTML 1.0