Compartilhar via

Configurar o log de erros da API do servidor HTTP

O log de erros da API do servidor HTTP é controlado por três valores do registro em uma chave HTTP\Parameters localizada em:

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 futuras do sistema operacional Windows.

Um usuário deve ter privilégios de Administrador/Sistema Local para modificar os valores do registro e exibir ou modificar os arquivos de log e a pasta que os contém.

As informações de configuração nos valores do registro são lidas quando o driver da API do servidor HTTP é iniciado. Como resultado, se as configurações forem alteradas, o driver deverá ser interrompido e reiniciado para ler os novos valores. Isso pode ser feito usando os seguintes comandos do console:

net stop http

net start http

Os arquivos de log são nomeados usando a seguinte convenção:

httperr + SequenceNumber + .log

Por exemplo: "httperr4.log".

Os arquivos de log são alternados quando atingem o tamanho máximo especificado pelo valor do registro ErrorLogFileTruncateSize e o valor não pode ser inferior a um megabyte (MB).

Se a configuração do log de erros for inválida ou ocorrer qualquer tipo de falha durante a gravação nos arquivos de log, a API do servidor HTTP usará o log de eventos para notificar os administradores de que o log de erros não ocorreu.

Os valores de configuração do registro são descritos na tabela a seguir.

Valor do Registro Descrição
EnableErrorLogging Um DWORD que pode ser definido como 1 (significa True) para habilitar o log de erros ou 0 (significa False) para desabilitá-lo. O valor padrão é 1.
ErrorLogFileTruncateSize Um DWORD que especifica o tamanho máximo de um arquivo de log de erros, em bytes. O valor padrão é 1 MB (0x100000).
Nota: o valor especificado não pode ser menor que o valor padrão.
ErrorLoggingDir Uma string que especifica a pasta na qual a API do servidor HTTP coloca seus arquivos de log.
A API do servidor HTTP cria uma subpasta chamada "HTTPERR" na pasta especificada na qual os arquivos de log são colocados. Essa subpasta e os arquivos de log recebem as mesmas configurações de permissão, o que significa que as contas de administrador e do sistema local têm acesso total, enquanto outros usuários não têm acesso.
Se uma pasta não for especificada no registro, a pasta padrão será a seguinte:
"%SystemRoot%\System32\LogFiles"
Observação: o valor da cadeia de caracteres ErrorLoggingDir deve ser um caminho totalmente qualificado, mas pode conter "%SystemRoot%".
  • Last updated on