How to: Aktivieren von Tracing im (neuen) SwyxIt!

Die Information in diesem Artikel betrifft die folgenden Produkte:

• SwyxIt! ab Version 14
• SwyxIt! Classic

ZUSAMMENFASSUNG

Dieser Artikel beschreibt wie das Tracing für das neue SwyxIt! aktiviert wird und wo die Trace Files anschließend eingesammelt werden können.

Für SwyxIt! Classic wird das Tracing wie gewohnt über die Registry Keys Trace ON/OFF aktiviert.

INFORMATION

Wie aktiviere ich das Logging/Tracing für das (neue) SwyxIt!

• Um das Tracing zu aktivieren, aktualisieren Sie die Datei „settings.json“ unter „%LocalAppData%\Local\Programs\SwyxIt!“

wie folgt:

{"traceSettings": {"traceLevel": "info"}}

Welche Werte kann ich für traceLevel einsetzen? 

• Es können die folgenden Werte für traceLevel gesetzt werden:
  • "verbose" - Für Entwickler Debugging gedacht. Sammelt extrem viel Daten und kann sich auf die Client Performance auswirken. Sollte nur gesetzt werden, wenn explizit von der Swyx Entwicklung angefragt

  • "debug" - Ähnlich wie verbose... sammelt aber keine großen Datenabfragen wie z.B. das Einlesen des Telefonbuchs, welches im Zweifelsfall mehrere Tausend Einträge haben kann.

    "debug" und "verbose" sollten nur auf Supportanfrage genutzt werden und wenn ein Problem direkt reproduzierbar ist, so dass traceLevel nach Abschluss des Reproduktionsszenario wieder reduziert werden kann.

  • "info" - Man sieht Infos + alles da darüber (notice, warning, error). Dies ist in der Regel die erste Einstellung, die der Support initial anfordert. Die Informationsdichte bietet für eine initiale Analyse erstmal eine ausreichend Informationsdichte.
  • "notice" - Standardeinstellung -> Notice Meldungen (z.b. App Startinfo) + warnings + error
  • "warning" - Nur Warnungen und Fehlermeldungen  
  • "error" - Nur Fehlermeldungen

Wo finde ich die Trace-Dateien/die Trace Ausgabe?

• Die Trace-Dateien werden täglich erstellt und befinden sich unter %LocalAppData%\Swyx\SwyxIt!\Traces. Sie haben die folgende Namensstruktur:
  • SwyxIt!-yyyy-mm-dd.
  • ComSocket-yyyymmdd-hhmms