Versionen im Vergleich

Schlüssel

  • Diese Zeile wurde hinzugefügt.
  • Diese Zeile wurde entfernt.
  • Formatierung wurde geändert.

In diesem Protokoll werden die Vorgänge vom Prozess "AdvokatClient.exe" aufgezeichnet. Die Datei befindet sich unter "%programdata%\Advokat\Log"des ADVOKAT Server Clients protokolliert. Die Datei existiert auf jedem Arbeitsplatz (FAT-Client und Terminalserver) unter "%programdata%\Advokat\<SB>\Log".
Die Datei ist zusätzlich im ADVOKAT Backend unter "...\ADVOKAT\Daten\Log\ProgramData" verfügbar.

Hinweis

Das Level Debug ist zur Unterstützung bei einer Fehlersuche oder Problemanalyse gedacht und sollte niemals länger als die Suche/Analyse dauert gesetzt sein.

  • In diesem Protokoll werden die Vorgänge vom Prozess "AdvokatClient.exe" aufgezeichnet.

  • Der Dateiname lautet "

    Advokat.Client.%USERNAME%

    AdvokatClient<YYYYMM>-<fortlaufende Nummer>.log",

    wobei %USERNAME% dem Windows Benutzernamen entspricht.Ist der Windows Benutzername

    also beispielsweise "

    mmustermann

    AdvokatClient202410.log",

    dann ist der Dateiname "Advokat.Client.mmustermann

    "AdvokatClient202410-1.log".


  • Das Protokoll existiert nur, wenn die Datei "client.json" entsprechend konfiguriert wurde.
  • Es muss in der Datei "client.json" ein Bereich "Serilog" existieren.

Vorgehensweise

...

Vorgehensweise (Empfehlung)

  1. Navigieren Sie auf einem beliebigen Gerät (Arbeitsplatz oder Server wo ADVOKAT Server per AdvoAll oder Microsoft IIS betrieben wird) zu "C:\Program Files (x86)\Advokat" und starten Sie "JsonConfigEditor.exe".

    • Wählen Sie Menüpunkt “Datei” > “Öffnen” und im Fenster “Schema-Auswahl für Konfiguration” den Eintrag “Advokat Client”.

    • Es öffnet sich das Fenster “Konfiguration laden” in dem Sie die Datei “client.json” aus dem Ordner “Config” im ADVOKAT Backend auswählen.

    • Retour im Fenster “Konfigurations-Editor - Advokat Server” warten Sie 5-10 Sekunden ab, bis der Inhalt angezeigt wird.

  2. Aktivieren Sie die Checkbox beim Block (Bereich) “Logging” und die untergeordnete Checkbox “Minimumlevel”, dadurch wird das Feld “Default” ersichtlich.
    Im Feld “Default” wird der Wert von ‘Information’ auf ‘Debug’ geändert. Abschließend klicken Sie links oben auf Menüpunkt “Datei” > “Speichern”.

    Screenshot.PNGImage Added

...

Vorgehensweise (Alternative)

Diese Vorgehensweise ist nur zu wählen, wenn der Start von ADVOKAT AdvoAll per “C:\Program Files (x86)\Advokat\JsonConfigEditor.exe.exe” nicht funktioniert.

  1. Öffnen Sie den Windows Explorer und navigieren zum ADVOKAT Backend

...

  1.  unter "...\ADVOKAT\Daten\Config". Öffnen Sie die Datei "client.json" mit einem Texteditor.

Suchen Sie nach dem Bereich "Serilog" und passen Sie den Wert bei MinimumLevel und Name an.
In diesem Beispiel wird der Informationsgehalt der Protokollierung von Information auf Debug erhöht, damit ein Problem genauer analysiert werden.

...

  "Serilog": {
    "MinimumLevel": {
      "Default": "Information"
    },
    "WriteTo": [
      {
        "Name": "File",
        "Args": {
          "path": "%ALLUSERSPROFILE%\\Advokat\\Log\\Advokat.Client.%USERNAME%.log",
          "buffered": false,
          "fileSizeLimitBytes": "1048576",
          "rollOnfileSizeLimit": "true",
          "retainedFileCountLimit": "10",
          "outputTemplate": "{Timestamp:o} [{Level:u3}] ({Application}, {ThreadId,3}, {SourceContext}) {Message:lj}{NewLine}{Exception}"
        }
      },
      {
        "Name": "Information"
      }
    ],
    "Enrich": [ "FromLogContext", "WithThreadId" ],
    "Properties": {
      "Application": "ADVOKAT.Client"
    }
  },

...

  "Serilog": {
    "MinimumLevel": {
      "Default": "Debug"
    },
    "WriteTo": [
      {
        "Name": "File",
        "Args": {
          "path": "%ALLUSERSPROFILE%\\Advokat\\Log\\Advokat.Client.%USERNAME%.log",
          "buffered": false,
          "fileSizeLimitBytes": "1048576",
          "rollOnfileSizeLimit": "true",
          "retainedFileCountLimit": "10",
          "outputTemplate": "{Timestamp:o} [{Level:u3}] ({Application}, {ThreadId,3}, {SourceContext}) {Message:lj}{NewLine}{Exception}"
        }
      },
      {
        "Name": "Debug"
      }
    ],
    "Enrich": [ "FromLogContext", "WithThreadId" ],
    "Properties": {
      "Application": "ADVOKAT.Client"
    }
  },  

  1. Prüfen Sie ob der Block (Bereich) "Logging" vorhanden ist:

    • Ist der Block (Bereich) vorhanden, dann passen Sie diesen wie folgt an:

      Codeblock
      languagejson
        "Logging": {
          "MinimumLevel": {
            "Default": "Debug"
          }
        }
    • Ist der Block (Bereich) nicht vorhanden, dann fügen Sie diesen wie in diesem Beispiel ersichtlich ein:

      Codeblock
      languagejson
      {
        "ServerConnection": {
          "Address": "https://SERVER.advokat.local:443",
          "AllowInvalidCertificates": true
        },
        "Logging": {
          "MinimumLevel": {
            "Default": "Debug"
          }
        }  
      }
    • In diesem Beispiel wird der Informationsgehalt der Protokollierung von Information auf Debug erhöht, damit ein Problem genauer analysiert werden.

    • Mehr Informationen dazu finden finden Sie im Kapitel Serilog Konfiguration.