ID do artigo: 820729 - �ltima revis�o: segunda-feira, 27 de fevereiro de 2012 - Revis�o: 6.0

Erro ao registrar em log na API de HTTP

Dica do SistemaEste artigo aplica-se a um sistema operativo diferente do que est� a utilizar. Foi desactivado o conte�do do artigo, que pode n�o ser relevante para si.

Este artigo descreve os recursos de log de erro de APIs para protocolo HTTP (Hypertext Transfer).

Alguns erros de aplicativos com base em HTTP s�o manipulados automaticamente pela API do HTTP, em vez de serem devolvidos ao aplicativo e solucionados por ele. Isso acontece porque a frequ�ncia desses erros pode encher o log de um evento ou o manipulador de um aplicativo.

Os t�picos a seguir descrevem os diferentes aspectos de log de erro de API de HTTP:

Configurar o log de erro de API de HTTP
As configura��es de registro controlam os erros de log das APIs de HTTP, o tamanho m�ximo permitido para os arquivos de log e o local dos arquivos de log.
Formato dos logs de erro das APIs de HTTP
A API de HTTP cria arquivos de log que est�o em conformidade com as conven��es de arquivo de log do World Wide Web Consortium (W3C). Voc� pode usar ferramentas padr�o para analisar esses arquivos de log. No entanto, ao contr�rio dos arquivos de log do W3C, os arquivos de log das APIs de HTTP n�o cont�m os nomes das colunas.
Tipos de erros que a API de HTTP registra
A API de HTTP registra uma variedade de erros comuns.

Voltar para o in�cio

Mais Informa��es

Configurar erro de log no API HTTP

Para que possamos configurar o log de erros HTTP API para voc�, v� para a se��o "Sorrigir para mim". Se voc� preferir configurar o log de erros das APIs de HTTP sozinho, v� para a se��o "Desejo corrigir sozinho".

Corrigir para mim

Para corrigir esse problema automaticamente, clique no bot�o ou no link Corrigir. Na caixa de di�logo Download de Arquivos, clique em Executar e siga as etapas no Assistente Fix it.

Desabilitar log de erro das�APIs de HTTP
Microsoft Fix it 50635

Habilitar log de erro de APIs de HTTP
Microsoft Fix it 50634

Observa��es

Este assistente pode estar apenas em ingl�s. No entanto, a corre��o autom�tica tamb�m funciona em vers�es do Windows em outros idiomas.
Se voc� n�o estiver usando o computador que apresenta o problema, salve a solu��o Fix it em uma unidade flash ou em um CD e execute-a no computador que apresenta o problema.

Desejo corrigir sozinho

Tr�s valores de registro em uma chave HTTP \Parameters controlam o log de erro de APIs de HTTP. Essas chaves est�o localizadas na seguinte chave de registro:

HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\HTTP\Parameters

Observa��o O local e a forma dos valores de configura��o podem ser alterados em vers�es posteriores do sistema operacional Microsoft Windows.

Voc� deve possuir credenciais de Administrador/Sistema Local para alterar os valores de registro e para visualizar ou modificar os arquivos de log e a pasta que os cont�m.

As informa��es de configura��o para os valores do registro s�o lidas quando o driver de API de HTTP � iniciado. Portanto, se voc� alterar as configura��es, dever� parar e reiniciar o driver para ler os novos valores. Para isso, digite os seguintes comandos de console:

net stop http

net start http

A seguinte conven��o � usada para nomear os arquivos de log:

httperr + n�mero de sequencia��o + .log
Exemplo: httperr4.log

Os arquivos de log s�o alternados quando atingem o tamanho m�ximo especificado pelo valor de registro ErrorLogFileTruncateSize. Esse valor n�o pode ser menor que um megabyte (MB).

Se a configura��o do log de erro n�o for v�lida ou se ocorrer algum tipo de falha enquanto a API de HTTP est� gravando nos arquivos de log, a API de HTTP usar� o log de eventos para avisar aos administradores que o log de erro n�o est� sendo realizado.

A tabela a seguir descreve os valores de configura��o do registro.

Recolher esta tabelaExpandir esta tabela

Valor do Registro	Descri��o
EnableErrorLogging	Uma DWORD que pode ser definida como TRUE para a habilita��o do log de erro ou como FALSE para sua desabilita��o. O valor padr�o � TRUE.
ErrorLogFileTruncateSize	Uma DWORD que especifica o tamanho m�ximo de um arquivo de log de erro, em bytes. O valor padr�o � um MB (0x100000). Observa��o O valor especificado n�o pode ser menor que o valor padr�o.
ErrorLoggingDir	Uma sequ�ncia de caracteres que especifica a pasta em que a API de HTTP coloca seus arquivos de log. A API de HTTP cria uma subpasta HTTPERR na pasta especificada e armazena os arquivos de log na subpasta. Essa subpasta e os arquivos de log recebem as mesmas configura��es de permiss�o. O administrador e as contas do Sistema Local t�m acesso total. Outros usu�rios n�o t�m acesso. Esta ser� a pasta padr�o quando n�o for especificada uma pasta no registro: %SystemRoot%\System32\LogFiles Observa��o O valor da sequ�ncia de caracteres ErrorLoggingDir deve ser um caminho local totalmente qualificado. No entanto, ele pode conter %SystemRoot%. Uma unidade de rede ou compartilhamento de rede n�o pode ser usado.

Voltar para o in�cio

Formato dos logs de erro das APIs de HTTP

Geralmente, os arquivos de log de erro das APIs de HTTP t�m o mesmo formato que os logs de erro W3C, exceto pelo fato que os arquivos de log de erro das APIs de HTTP n�o cont�m t�tulos das colunas. Cada linha de um log de erro de API de HTTP registra um erro. Os campos aparecem em uma ordem espec�fica. Um caractere de espa�o simples (0x0020) separa cada campo do campo anterior. Em cada campo, os sinais de adi��o (0x002B) substituem os espa�os, tabula��es e caracteres de controle n�o imprim�veis.

A tabela a seguir identifica os campos e a ordem dos campos em um registro de log de erro.

Recolher esta tabelaExpandir esta tabela

Campo	Descri��o
data	O campo Data segue o formato W3C. Este campo baseia-se no tempo Universal Coordenado (UTC). O campo de Data ser� sempre de dez caracteres, no formato aaaa-mm-dd. Por exemplo, 1� de maio de 2003 ser� 2003-05-01.
hora	O campo Hora segue o formato W3C. Este campo baseia-se em UTC. O campo de tempo ter� sempre oito caracteres na forma MM:HH:SS. Por exemplo, 5:30 PM (UTC) � expresso como 17:30:00.
Endere�o IP do cliente	O endere�o IP do cliente afetado. O valor neste campo pode ser um endere�o IPv4 ou um endere�o IPv6. Se o endere�o IP do cliente for um endere�o IPv6, o campo ScopeId tamb�m estar� inclu�do no endere�o.
Porta do cliente	O n�mero da porta do cliente afetado.
Endere�o IP do servidor	O endere�o IP do servidor afetado. O valor neste campo pode ser um endere�o IPv4 ou um endere�o IPv6. Se o endere�o IP do servidor for um endere�o IPv6, o campo ScopeId tamb�m estar� inclu�do no endere�o.
Porta do servidor	O n�mero da porta do servidor afetado.
Vers�o do protocolo	A vers�o do protocolo que est� sendo usado. Se a conex�o n�o foi analisada o suficiente para determinar a vers�o do protocolo, um h�fen (0x002D) ser� usado como espa�o reservado para o campo vazio. Se o maior n�mero de vers�o ou o menor n�mero de vers�o analisado for maior ou igual a 10, a vers�o ser� registrada como HTTP/?.?.
Verbo	O estado do verbo que a �ltima solicita��o a ser analisada passa. Verbos desconhecidos est�o inclu�dos, mas qualquer verbo com mais de 255 bytes ser� truncado para esse comprimento. Se um verbo n�o estiver dispon�vel, um h�fen (0x002D) ser� usado como um espa�o reservado para o campo vazio.
CookedURL + consulta	A URL e qualquer consulta associada a ela s�o registrados como um campo separado por um ponto de interroga��o (0x3F). Este campo ser� truncado no limite de comprimento de 4096 bytes. Se esta URL foi analisada (processada), ela est� registrada com a convers�o de p�gina de c�digo local e � tratada como um campo Unicode. Se esta URL n�o foi analisada (processada) no momento do registro, ela ser� copiada exatamente igual, sem convers�o para Unicode. Se a API de HTTP n�o conseguir analisar esta URL, um h�fen (0x002D) ser� usado como um espa�o reservado para o campo vazio.
Status de protocolo	O status do protocolo n�o pode ser maior que 999. Se o status do protocolo da resposta a uma solicita��o estiver dispon�vel, ele estar� registrado neste campo. Se o status do protocolo n�o estiver dispon�vel, um h�fen (0x002D) ser� usado como um espa�o reservado para o campo vazio.
SiteId	N�o usada nesta vers�o da API de HTTP. Um h�fen (0x002D) de espa�o reservado sempre aparece neste campo.
Frase de motivo	Este campo cont�m uma sequ�ncia de caracteres que identifica o tipo de erro que est� sendo registrado. Este campo nunca estar� vazio.
Nome da Fila	Este � o nome de fila de solicita��o.

As linhas de exemplo a seguir s�o de um log de erro de API de 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

Voltar para o in�cio

Tipos de erros que a API de HTTP registra

A API de HTTP registra respostas de erros a clientes, tempos limite da conex�o, solicita��es �rf�s e conex�es interrompidas que foram manipulados incorretamente.

A seguinte lista identifica os tipos de erros que a API de HTTP registra:

Respostas a clientes A API de HTTP envia uma resposta de erro a um cliente. Por exemplo, um erro 400 causado por um erro de an�lise na �ltima solicita��o recebida. Depois que a API de HTTP envia a resposta de erro, ela encerra a conex�o.
Tempos limite de conex�o A API de HTTP encerra uma conex�o. Se uma solicita��o estiver pendente no momento em que a conex�o atingir o tempo limite, ela ser� usada para fornecer mais informa��es sobre a conex�o no log de erros.
Solicita��es �rf�s Um processo de modo de usu�rio � encerrado inesperadamente enquanto ainda h� solicita��es na fila a serem encaminhadas para o processo. A API de HTTP registra as solicita��es �rf�s no log de erros.

Tipos de erros espec�ficos s�o designados pelas sequ�ncias de caracteres Frase de motivo que sempre aparecem no �ltimo campo de cada linha de erro. A tabela a seguir identifica as frases de motivo da API de HTTP.

Recolher esta tabelaExpandir esta tabela

Frase de motivo	Descri��o
AppOffline	Erro de servi�o indispon�vel (um erro 503 de HTTP). O servi�o n�o est� dispon�vel porque os erros do aplicativo fizeram com que o aplicativo fosse colocado off-line.
AppPoolTimer	Erro de servi�o indispon�vel (um erro 503 de HTTP). O servi�o n�o est� dispon�vel porque o processo de pool de aplicativos est� muito ocupado para manipular a solicita��o.
AppShutdown	Erro de servi�o indispon�vel (um erro 503 de HTTP). O servi�o n�o est� dispon�vel porque o aplicativo desligou-se automaticamente em resposta � diretiva do administrador.
BadRequest	Erro de an�lise ao processar uma solicita��o.
Client_Reset	A conex�o entre o cliente e o servidor foi encerrada antes que a solicita��o fosse atribu�da a um processo de trabalho. A causa mais comum para esse comportamento � o cliente encerrar prematuramente a conex�o com o servidor.
Connection_Abandoned_By_AppPool	Um processo de trabalho do pool de aplicativos foi encerrado inesperadamente ou deixou �rf� uma solicita��o pendente, fechando o manipulador que a conduzia.
Connection_Abandoned_By_ReqQueue	Um processo de trabalho do pool de aplicativos foi encerrado inesperadamente ou deixou �rf� uma solicita��o pendente, fechando o manipulador que a conduzia. Espec�fico para Windows Vista e Windows Server 2008.
Connection_Dropped	A conex�o entre o cliente e o servidor foi encerrada antes que o servidor enviasse o pacote de resposta final. A causa mais comum para esse comportamento � o cliente encerrar prematuramente a conex�o com o servidor.
Connection_Dropped_List_Full	A lista de queda de conex�es entre clientes e o servidor est� cheia. Espec�fico para Windows Vista e Windows Server 2008.
ConnLimit	Erro de servi�o indispon�vel (um erro 503 de HTTP). O servi�o n�o est� dispon�vel porque o limite de conex�es no n�vel do site foi atingido ou excedido.
Connections_Refused	A mem�ria NonPagedPool do kernel caiu abaixo de 20 MB e o http.sys parou de receber novas conex�es
Desativado	Erro de servi�o indispon�vel (um erro 503 de HTTP). O servi�o n�o est� dispon�vel porque um administrador assumiu o aplicativo off-line.
EntityTooLarge	Uma entidade excedeu o tamanho m�ximo permitido.
FieldLength	Um limite de comprimento de campo foi excedido.
Proibido	Um elemento ou sequ�ncia proibida foi encontrado durante a an�lise.
Cabe�alho	Erro de an�lise em um cabe�alho.
Nome do host	Erro de an�lise ao processar um nome do host.
Interno	Erro de servidor interno (um erro 500 de HTTP).
Invalid_CR/LF.	Ocorreu um retorno de carro ou alimenta��o de linha ilegal.
LengthRequired	Um valor de comprimento necess�rio estava ausente.
N/A	Erro de servi�o indispon�vel (um erro 503 de HTTP). O servi�o n�o est� dispon�vel por causa de um erro interno (como, por exemplo, uma falha de aloca��o de mem�ria).
N/I	Erro n�o implementado (um erro 501 de HTTP) ou erro de servi�o indispon�vel (um erro 503 de HTTP) por conta de uma codifica��o de transfer�ncia desconhecida.
N�mero	Erro de an�lise ao processar um n�mero.
Pr�-condi��o	Uma pr�-condi��o necess�ria estava ausente.
QueueFull	Erro de servi�o indispon�vel (um erro 503 de HTTP). O servi�o n�o est� dispon�vel porque a fila de solicita��es do aplicativo est� cheia.
RequestLength	Um limite de comprimento de solicita��es foi excedido.
Timer_AppPool	A conex�o expirou porque uma solicita��o atingiu o tempo limite em uma fila de pool de aplicativos antes que um aplicativo de servidor a retirasse da fila e a processasse. A dura��o do tempo limite � ConnectionTimeout. Por padr�o, esse valor � definido para dois minutos.
Timer_ConnectionIdle	A conex�o expirou e permanece ociosa. A dura��o padr�o ConnectionTimeout � de dois minutos.
Timer_EntityBody	A conex�o expirou antes que o corpo da entidade de solicita��o chegasse. Quando est� claro que uma solicita��o tem um corpo de entidade, a API de HTTP ativa o timer Timer_EntityBody. Inicialmente, o limite do temporizador � definido para o valor ConnectionTimeout (normalmente de 2 minutos). Sempre que outra indica��o de dados for recebida nesta solicita��o, a API de HTTP redefine o timer para fornecer � conex�o dois minutos (ou o que estiver especificado em ConnectionTimeout).
Timer_HeaderWait	A conex�o expirou porque a an�lise do cabe�alho de uma solicita��o demorou mais que o limite padr�o de dois minutos.
Timer_MinBytesPerSecond	A conex�o expirou porque o cliente n�o recebeu uma resposta a uma velocidade razo�vel. A taxa de envio de resposta foi mais lenta do que o padr�o de 240 bytes por segundo. Isso pode ser controlado com a propriedade de metabase MinFileBytesPerSec.
Timer_ReqQueue	A conex�o expirou porque uma solicita��o atingiu o tempo limite em uma fila de pool de aplicativos antes que um aplicativo de servidor a retirasse da fila. A dura��o do tempo limite � ConnectionTimeout. Por padr�o, esse valor � definido para dois minutos. Espec�fico para Windows Vista e Windows Server 2008.
Timer_Response	Reservado. N�o usado no momento.
URL	Erro de an�lise ao processar uma URL.
URL_Length	Uma URL excedeu o tamanho m�ximo permitido.
Verbo	Erro de an�lise ao processar um verbo.
Version_N/S.	Erro de vers�o n�o suportada (um erro 505 de HTTP).

Voltar para o in�cio

Refer�ncias

Para obter mais informa��es sobre como adicionar campos para o log de erros de HTTP do IIS, clique no n�mero de artigo abaixo na Base de Dados de Conhecimento Microsoft :

832975� (http://support.microsoft.com/kb/832975/pt-br/ ) As propriedades adicionais est�o dispon�veis para registro no arquivo Httperr#.log no IIS 6.0 e IIS 7.0

Voltar para o in�cio

kbhttphandlers kbhttp kbapi kberrmsg kbinfo kbfixme kbmsifixme KB820729

Voltar para o in�cio