Errore durante la registrazione nelle API HTTP

Questo articolo descrive le funzionalità di registrazione degli errori delle API (Application Programming Interface) http (HyperText Transfer Protocol).

Versione originale del prodotto: Windows Server 2008 R2, Windows Server 2008, Windows Server 2012 R2, Windows Server 2012, Windows 10, Windows 8.1
Numero KB originale: 820729

Riepilogo

Alcuni errori che si verificano in un'applicazione basata su HTTP vengono gestiti automaticamente dall'API HTTP anziché essere passati a un'applicazione per la gestione. Questo comportamento si verifica perché la frequenza di tali errori potrebbe inondare un registro eventi o un gestore dell'applicazione.

Negli argomenti seguenti vengono descritti i diversi aspetti della registrazione degli errori dell'API HTTP.

• Configurare la registrazione degli errori dell'API HTTP
  Le impostazioni del Registro di sistema controllano gli errori dei log dell'API HTTP, la dimensione massima consentita dei file di log e il percorso dei file di log.

• Formato dei log degli errori dell'API HTTP
  L'API HTTP crea file di log che seguono le convenzioni del file di log W3C (World Wide Web Consortium). È possibile usare gli strumenti standard per analizzare questi file di log. Tuttavia, a differenza dei file di log W3C, i file di log dell'API HTTP non contengono i nomi delle colonne.

• Tipi di errori che vengono log dell'API HTTP
  L'API HTTP registra molti errori comuni.

I metodi seguenti descrivono la risoluzione della registrazione degli errori dell'API HTTP.

Configurare la registrazione degli errori dell'API HTTP

Tre valori del Registro di sistema in una chiave HTTP \Parameters controllano la registrazione degli errori dell'API HTTP. Queste chiavi si trovano nella chiave del Registro di sistema: HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\HTTP\Parameters.

Per modificare i valori del Registro di sistema e visualizzare o modificare i file di log e la cartella che li contiene, è necessario disporre di credenziali di amministratore/sistema locale.

Le informazioni di configurazione nei valori del Registro di sistema vengono lette all'avvio del driver API HTTP. Quindi, se si modificano le impostazioni, è necessario arrestare e quindi riavviare il driver per leggere i nuovi valori. A tale scopo, digitare i comandi della console seguenti:

net stop http
net start http

La convenzione di denominazione seguente viene usata per denominare i file di log:
httperr + numero di sequenza + .log
Esempio: httperr4.log

I file di log vengono ciclo quando raggiungono le dimensioni massime specificate dal valore del Registro di sistema ErrorLogFileTruncateSize. Questo valore non può essere minore di 1 megabyte (MB).

Se la configurazione della registrazione degli errori non è valida o se si verifica un errore durante la scrittura dell'API HTTP nei file di log, l'API HTTP usa la registrazione eventi per notificare agli amministratori che la registrazione degli errori non si verifica.

Nella tabella seguente vengono descritti i valori di configurazione del Registro di sistema.

Formato dei log degli errori dell'API HTTP

In genere, i file di log degli errori dell'API HTTP hanno lo stesso formato dei log degli errori W3C, ad eccezione del fatto che i file di log degli errori dell'API HTTP non contengono intestazioni di colonna. Ogni riga di un log degli errori dell'API HTTP registra un errore. I campi vengono visualizzati in un ordine specifico. Un singolo carattere di spazio (0x0020) separa ogni campo dal campo precedente. In ogni campo i segni più (0x002B) sostituiscono spazi, schede e caratteri di controllo non stampabili.

La tabella seguente identifica i campi e l'ordine dei campi in un record del log degli errori.

Le righe di esempio seguenti provengono da un log degli errori dell'API HTTP:

2002-07-05 18:45:09 172.31.77.6 2094 172.31.77.6 80 HTTP/1.1 GET /qos/1kbfile.txt 503 - ConnLimit  
2002-07-05 19:51:59 127.0.0.1 2780 127.0.0.1 80 HTTP/1.1 GET /ThisIsMyUrl.htm 400 - Hostname  
2002-07-05 19:53:00 127.0.0.1 2894 127.0.0.1 80 HTTP/2.0 GET / 505 - Version_N/S  
2002-07-05 20:06:01 172.31.77.6 64388 127.0.0.1 80 - - - - - Timer_MinBytesPerSecond

Tipi di errori che vengono log dell'API HTTP

L'API HTTP registra le risposte agli errori ai client, i timeout di connessione, le richieste orfane e le connessioni eliminate gestite in modo non corretto.

L'elenco seguente identifica i tipi di errori log dell'API HTTP:

• Risposte ai client
  L'API HTTP invia una risposta di errore a un client, ad esempio un errore 400 causato da un errore di analisi nell'ultima richiesta ricevuta. Dopo che l'API HTTP ha inviato la risposta di errore, chiude la connessione.

• Timeout della connessione
  L'API HTTP esegue il timeout di una connessione. Se una richiesta è in sospeso al timeout della connessione, la richiesta viene usata per fornire altre informazioni sulla connessione nel log degli errori.

• Richieste orfane
  Un processo in modalità utente si arresta in modo imprevisto mentre sono ancora presenti richieste in coda che vengono instradate a tale processo. L'API HTTP registra le richieste orfane nel log degli errori. I tipi di errore specifici sono denominati dalle stringhe reason phrase che vengono sempre visualizzate come ultimo campo di ogni riga di errore. La tabella seguente identifica le frasi motivo dell'API HTTP.