Condividi tramite


Configurazione della registrazione degli errori dell'API del server HTTP

La registrazione degli errori dell'API del server HTTP è controllata da tre valori del Registro di sistema in una chiave dei parametri HTTP\all'indirizzo:

HKEY_LOCAL_MACHINE
   System
      CurrentControlSet
         Services
            HTTP
               Parameters

Nota

Il percorso e la forma dei valori di configurazione possono cambiare nelle versioni future del sistema operativo Windows.

Un utente deve avere privilegi di amministratore/sistema locale per modificare i valori del Registro di sistema e visualizzare o modificare i file di log e la cartella che li contiene.

Le informazioni di configurazione nei valori del Registro di sistema sono lette all'avvio del driver API del server HTTP. Di conseguenza, se le impostazioni vengono modificate, il driver deve essere arrestato e riavviato per leggere i nuovi valori. A tale scopo, è possibile usare i comandi della console seguenti:

net stop http

net start http

I file di log vengono denominati usando la convenzione seguente:

httperr +SequenceNumber+ .log

Ad esempio: "httperr4.log".

I file di log vengono ciclici quando raggiungono le dimensioni massime specificate dal valore del Registro di sistema ErrorLogFileTruncateSize e il valore non può essere minore di un megabyte (MB).

Se la configurazione della registrazione degli errori non è valida o si verifica qualsiasi tipo di errore durante la scrittura nei file di log, l'API del server HTTP usa la registrazione eventi per notificare agli amministratori che la registrazione degli errori non è stata eseguita.

I valori di configurazione del Registro di sistema sono descritti nella tabella seguente.

Valore del Registro di sistema Descrizione
EnableErrorLogging DWORD che può essere impostato su 1 (indica True) per abilitare la registrazione degli errori o 0 (indica False) per disabilitarla. Il valore predefinito è 1.
ErrorLogFileTruncateSize DWORD che specifica le dimensioni massime di un file di log degli errori, in byte. Il valore predefinito è un MB (0x100000).
Nota: il valore specificato non può essere inferiore al valore predefinito.
ErrorLoggingDir Valore String che specifica la cartella in cui l'API del server HTTP inserisce i file di registrazione.
L'API server HTTP crea una sottocartella denominata "HTTPERR" nella cartella specificata in cui vengono inseriti i file di log. Questa sottocartella e i file di log ricevono le stesse impostazioni di autorizzazione, il che significa che gli account amministratore e sistema locale hanno accesso completo, mentre altri utenti non hanno accesso.
Se una cartella non è specificata nel Registro di sistema, la cartella predefinita è la seguente:
"%SystemRoot%\System32\LogFiles"
Nota: il valore della stringa ErrorLoggingDir deve essere un percorso completo, ma può contenere "%SystemRoot%".