4D Anwendungen können mehrere Protokolldateien erzeugen, die für die Fehlersuche oder die Optimierung ihrer Ausführung nützlich sind. Logs werden in der Regel mit Selektoren der Befehle SET DATABASE PARAMETER oder WEB SET OPTION gestartet oder gestoppt und im Ordner Logs der Datenbank gespeichert (siehe Abschnitt Beschreibung der 4D Dateien).

Die protokollierten Informationen müssen analysiert werden, um Probleme zu erkennen und zu beheben. In diesem Abschnitt finden Sie eine umfassende Beschreibung der folgenden Protokolldateien:

• 4DRequestsLog.txt
• 4DRequestsLog_ProcessInfo.txt
• HTTPDebugLog.txt
• 4DDebugLog.txt (Standard and Tabular)
• 4DDiagnosticLog.txt,
• 4DIMAPLog.txt, 4DPOP3Log.txt, and 4DSMTPLog.txt
• ORDA client requests log file

Hinweis: Wenn eine Logdatei entweder auf 4D Server oder auf dem Remote Client erzeugt werden kann, wird das Wort "Server" an den serverseitigen Logdateinamen angehängt, zum Beispiel "4DRequestsLogServer.txt"

• sequence_number: diese Nummer ist über alle Debug-Protokolle hinweg eindeutig und wird für jeden neuen Eintrag inkrementiert, was auch immer die Protokolldatei sein mag, so dass Sie die genaue Reihenfolge der Operationen erkennen können.
• connection_uuid: für jeden 4D Prozess, der auf einem 4D Client erstellt wird und sich mit einem Server verbindet, wird diese Verbindungs-UUID sowohl auf Server- als auch auf Client-Seite protokolliert. Damit können Sie den Remote-Client, der den jeweiligen Prozess gestartet hat, leicht identifizieren.

Diese Protokolldatei zeichnet Standardabfragen auf, die vom 4D Server Rechner oder dem 4D Remote Rechner, der den Befehl ausgeführt hat, durchgeführt wurden (außer Webabfragen).

So starten Sie dieses Protokoll:

• auf dem Server:
  
   SET DATABASE PARAMETER(4D Server log recording;1) //server side
• auf einem Client:
  
   SET DATABASE PARAMETER(Client Log Recording;1) //remote side

Hinweis: Diese Anweisung startet auch die Protokolldatei 4DRequestsLog_ProcessInfo.txt (siehe unten).

Kopfzeilen

Diese Datei beginnt mit den folgenden Kopfzeilen:

• Log Session Identifier
• Hostname des Servers, der die Anwendung hostet
• Benutzer-Login-Name: Login auf dem Betriebssystem des Benutzers, der die 4D Anwendung auf dem Server ausgeführt hat.

Inhalt

Für jede Anfrage werden die folgenden Felder protokolliert:

Ablauf der Anfrage:

Diese Protokolldatei zeichnet Informationen über jeden Prozess auf, der auf dem 4D Server Rechner oder dem remote 4D Rechner, der den Befehl ausgeführt hat, erstellt wurde (mit Ausnahme von Web-Anfragen).

Wie Sie dieses Protokoll starten:

• auf dem Server:
  
   SET DATABASE PARAMETER(4D Server log recording;1) //Serverseite
• auf einem Client:
  
   SET DATABASE PARAMETER(Client Log Recording;1) //entfernte Seite

Hinweis: Diese Anweisung startet auch die Protokolldatei 4DRequestsLog.txt (siehe oben).

Kopfzeilen

Diese Datei beginnt mit den folgenden Kopfzeilen:

• Log Session Identifier
• Hostname des Servers, der die Anwendung hostet
• User Login Name: Anmeldung am Betriebssystem des Benutzers, der die 4D Anwendung auf dem Server ausgeführt hat.

Inhalt

Für jeden Prozess werden die folgenden Felder protokolliert:

Diese Protokolldatei zeichnet jede HTTP-Anfrage und jede Antwort im Raw-Modus auf. Es werden ganze Anfragen einschließlich Header protokolliert; optional können auch Body-Teile protokolliert werden.

So starten Sie dieses Protokoll:

Die folgenden Felder werden sowohl für die Anfrage als auch für die Antwort protokolliert:

Dieses Logbuch protokolliert jedes Ereignis, das auf 4D Programmierebene auftritt. Der Standardmodus zeigt eine einfache Ansicht der Ereignisse.

Logbuch starten:

Für jedes Ereignis werden folgende Felder protokolliert:  

Diese Protokolldatei zeichnet jedes Ereignis, das auf der 4D Programmierebene auftritt, in einem tabellarischen, kompakten Format auf, das zusätzliche Informationen enthält (im Vergleich zum Standardformat).

So starten Sie dieses Protokoll:

Die folgenden Felder werden für jedes Ereignis protokolliert: 

Diese Protokolldatei zeichnet viele Ereignisse im Zusammenhang mit dem internen Anwendungsbetrieb auf und ist für den Menschen lesbar. Sie können mit dem Befehl LOG EVENT benutzerdefinierte Informationen in diese Datei aufnehmen.

So starten Sie dieses Protokoll:

Die folgenden Felder werden für jedes Ereignis protokolliert:

Je nach Ereignis können auch verschiedene andere Felder protokolliert werden, wie z. B. Task, Socket, etc. 

Diese Protokolldateien zeichnen jeden Austausch zwischen der 4D Anwendung und dem Mailserver (SMTP, POP3, IMAP) auf, der durch die folgenden Befehle ausgelöst wurde:

• SMTP -  SMTP New transporter 
• POP3 -  POP3 New transporter
• IMAP  -  IMAP New transporter   

Die Protokolldateien können in zwei Versionen erstellt werden:

• eine reguläre Version:
  • namens 4DSMTPLog.txt, 4DPOP3Log.txt oder 4DIMAPLog.txt
  • keine Anhänge
  • verwendet ein automatisches zirkuläres Dateirecycling alle 10 MB
  • ist für die übliche Fehlersuche vorgesehen

So starten Sie dieses Protokoll:

• •  SET DATABASE PARAMETER(SMTP Log;1) //SMTP-Protokoll starten ODER
 SET DATABASE PARAMETER(POP3 Log;1) //POP3-Protokoll starten ODER
 SET DATABASE PARAMETER(IMAP Log;1) //IMAP-Protokoll starten
    
     
  • 4D Server: Klicken Sie auf die Schaltfläche Start Request and Debug Logs auf der Seite Wartung des 4D Server Administrationsfensters.
    Dieser Protokollpfad wird von dem Befehl Get 4D file zurückgegeben.

• eine erweiterte Version:
  
  • Anhang enthalten
  • kein automatisches Recycling
  • benutzerdefinierter Name
  • für bestimmte Zwecke reserviert

So starten Sie dieses Protokoll:

• •  $server:=New object
 ...
  //SMTP
 $server.logFile:="MySMTPAuthLog.txt"
 $transporter:=SMTP New transporter($server)
 
  // POP3
 $server.logFile:="MyPOP3AuthLog.txt"
 $transporter:=POP3 New transporter($server)
 
  //IMAP
 $server.logFile:="MyIMAPAuthLog.txt"
 $transporter:=IMAP New transporter($server)

Inhalt

Für jede Anfrage werden die folgenden Felder protokolliert:

Dieses Protokoll zeichnet jede ORDA-Anfrage auf, die von einem Remote Rechner gesendet wird. Sie können die Protokollinformationen in den Speicher oder in eine Datei auf der Festplatte leiten. Der Name und der Speicherort dieser Protokolldatei sind frei wählbar.

Wie Sie dieses Protokoll starten:

Hinweis: Wenn Sie die eindeutige Sequenznummer im ORDA-Anforderungsprotokoll verwenden möchten, müssen Sie sie auslösen:

Die folgenden Felder werden für jede Anfrage protokolliert: