TsgcQUICClient › Eigenschaften › LogFile

LogFile Eigenschaft

Schreibt die mit dem QUIC-Server ausgetauschten rohen UDP-Datagramme zum Debuggen in eine Textdatei.

Typ

TsgcUDPLogFile

Syntax

property LogFile: TsgcUDPLogFile read FLogFile write SetLogFile;

Hinweise

Deaktiviert (Enabled = False, FileName leer).

Untereigenschaften

NameTypHinweiseBeschreibung
EnabledBooleanFalseSchaltet die Protokollierung ein. Das Protokoll wird nur dann an die Verbindung angehängt, wenn dies True ist und FileName nicht leer ist.
FileNameStringemptyVollständiger Pfad der Datei, in die die Datagramme geschrieben werden. Ein leerer Name deaktiviert das Logging, auch wenn Enabled True ist.

Hinweise

LogFile zeichnet die Datagramme auf, die über den UDP-Socket unterhalb der QUIC-Verbindung laufen. Beide Bedingungen werden beim Erstellen der Verbindung geprüft, setzen Sie Enabled und FileName daher vor dem Öffnen der Verbindung, eine Änderung auf einer aktiven Verbindung hat keine Wirkung.

Was in der Datei landet, ist das verschlüsselte QUIC-Abbild der Leitung, nicht Ihre Anwendungs-Payload: QUIC verschlüsselt fast das gesamte Paket, einschließlich des größten Teils des Headers. Das Log ist daher nützlich, um zu bestätigen, dass Datagramme in beide Richtungen fließen, und um deren Größe zu beurteilen, nicht um Nachrichteninhalte zu lesen. Um Payloads zu untersuchen, protokollieren Sie sie selbst aus OnQUICStreamData oder vor dem Aufruf von WriteData.

Dieses Mitglied ist derzeit nur in der Delphi/C++Builder-Implementierung verfügbar.

Beispiel


oClient := TsgcQUICClient.Create(nil);
oClient.Host := 'www.example.com';
oClient.Port := 443;

oClient.LogFile.FileName := 'C:\logs\quic.log';
oClient.LogFile.Enabled := True;

oClient.Connect;

Zurück zu Properties