Konfigurieren der Fehlerprotokollierung der HTTP-Server-API

Die HTTP Server API-Fehlerprotokollierung wird durch drei Registrierungswerte unter dem Schlüssel HTTP\Parameter gesteuert, der sich hier befindet:

HKEY_LOCAL_MACHINE
   System
      CurrentControlSet
         Services
            HTTP
               Parameters

Hinweis

Der Ort und das die Form der Konfigurationswerte können sich in zukünftigen Versionen des Windows-Betriebssystems ändern.

Ein*e Benutzer*in muss über Administratorrechte oder lokale Systemrechte verfügen, um die Registrierungswerte zu ändern und die Log-Dateien und den Ordner, der sie enthält, anzuzeigen oder zu ändern.

Die Konfigurationsinformationen in den Registrierungswerten werden gelesen, wenn der HTTP Server API-Treiber gestartet wird. Wenn die Einstellungen geändert werden, muss der Treiber daher angehalten und neu gestartet werden, um die neuen Werte zu lesen. Dies kann mit den folgenden Konsolenbefehlen erreicht werden:

net stop http

net start http

Die Log-Dateien werden nach der folgenden Konvention benannt:

httperr + SequenceNumber + .log

Zum Beispiel: „httperr4.log“.

Die Log-Dateien beginnen von vorn, wenn sie die maximale Größe erreichen, die durch den Registrierungswert ErrorLogFileTruncateSize festgelegt ist, wobei der Wert nicht weniger als ein Megabyte (MB) betragen darf.

Wenn die Konfiguration der Fehlerprotokollierung ungültig ist oder beim Schreiben in die Log-Dateien irgendeine Art von Fehler auftritt, verwendet die HTTP Server API die Ereignisprotokollierung, um Administrator*innen zu benachrichtigen, dass die Fehlerprotokollierung nicht stattgefunden hat.

Die Konfigurationswerte der Registrierung werden in der folgenden Tabelle beschrieben.

Registrierungswert	Beschreibung
EnableErrorLogging	Ein DWORD , das auf 1 festgelegt werden kann (bedeutet True), um die Fehlerprotokollierung zu aktivieren, oder 0 (bedeutet False), um sie zu deaktivieren. Der Standardwert ist 1.
ErrorLogFileTruncateSize	Ein DWORD, das die maximale Größe einer Log-Datei für Fehler in Bytes angibt. Der Standardwert ist ein MB (0x100000). Hinweis: Der angegebene Wert darf nicht kleiner als der Standardwert sein.
ErrorLoggingDir	Eine Zeichenfolge, die den Ordner angibt, in dem die HTTP Server API ihre Log-Dateien ablegt. Die HTTP Server API erstellt einen Unterordner namens „HTTPERR“ unter dem angegebenen Ordner, in dem die Log-Dateien abgelegt werden. Dieser Unterordner und die Log-Dateien erhalten die gleichen Berechtigungseinstellungen, d. h. Administrator*innen und lokale Systemkonten haben Vollzugriff, während andere Benutzer*innen keinen Zugriff haben. Wenn in der Registrierung kein Ordner angegeben wird, ist der Standardordner der folgende: „%SystemRoot%\System32\LogFiles“ Hinweis: Die Zeichenfolge ErrorLoggingDir muss ein vollständig qualifizierter Pfad sein, kann aber auch „%SystemRoot%“ enthalten.