Configurar Log no IIS
de Keith Newman e Robert McMurray
Você pode configurar registros em log no servidor Web ou site que registra informações sobre solicitações de HTTP e erros. As informações do log podem ajudá-lo a solucionar problemas ou otimizar seu site.
Pré-requisitos
Para aproveitar ao máximo este tutorial, você deve ter acesso a um computador com um dos seguintes sistemas operacionais:
- Windows Server ® 2012
- Windows® 8
Configurar registro em log no nível do site
Você pode executar este procedimento usando a interface do usuário ou editando arquivos de configuração diretamente.
Para configurar registro em log no nível do site usando a interface do usuário
Abra o Gerenciador do IIS.
- Para o Windows Server 2012, na página Inicial, selecione o bloco Gerenciador do Servidor e selecione OK. Em Gerenciador do Servidor, clique no menu Ferramentas e, em seguida, clique em Gerenciador de Serviços de Informações da Internet (IIS).
- Para o Windows 8, na página Iniciar digite Painel de Controle e clique no ícone Painel de Controle nos resultados da pesquisa. Na tela Painel de Controle , clique em Sistema e Segurança, clique em Ferramentas Administrativas, e, em seguida, clique no Gerenciador do Serviços de Informações da Internet (IIS).
Na exibição de árvore Conexões, selecione seu site.
Em Exibição de Recursos, clique duas vezes em Registrar em Log.
Na página Registrar em Log na seção Arquivo de Log em Formatar, selecione um dos seguintes formatos de arquivo de log:
- IIS: para usar o formato de arquivo de log Microsoft IIS para registrar informações sobre um site. Esse formato é manipulado pelo HTTP.sys e consiste em um formato ASCII fixo baseado em texto, o que significa que você não pode personalizar os campos registrados. Os campos são separados por vírgulas e a hora é registrada conforme a hora local. Para obter mais informações sobre formato de arquivo de log IIS, consulte Formato de arquivo de log ISS (IIS 6.0).
- NCSA: para usar o formato de arquivo de log comum NCSA (National Center for Supercomputing Applications) para registrar informações sobre um site. Esse formato é manipulado pelo HTTP.sys e consiste em um formato ASCII fixo baseado em texto, o que significa que você não pode personalizar os campos registrados. Os campos são separados por espaços e a hora é registrada conforme a hora local com a diferença UTC (Tempo Universal Coordenado). Para obter mais informações sobre formato de arquivo de log NCSA, consulte Formato de Arquivo de Log Comum NCSA (IIS 6.0).
- W3C: para usar o formato de arquivo de log W3C centralizado para registrar informações sobre todos os sites no servidor. Esse formato é manipulado pelo HTTP.sys e consiste em um formato ASCII personalizável baseado em texto, o que significa que você pode especificar os campos registrados. Especifique os campos que são registrados na caixa de diálogo Campos de Log do W3C ao clicar em Selecionar Campos na página Log . Os campos são separados por espaços e a hora sempre será registrada em UTC (Tempo Universal Coordenado). Para obter mais informações sobre formato de arquivo de log W3C, consulte Formato de Arquivo de Log Estendido W3C (IIS 6.0).
- Custom: para usar um formato personalizado para um módulo de registro em log personalizado. Quando você seleciona essa opção, a página Registrar em Log fica desabilitada, porque o registro em log personalizado não pode ser configurado no Gerenciador do IIS. Para obter mais informações sobre como usar formatos de arquivo de log personalizados, consulte Módulos de Registro em Log Personalizados (IIS 6.0).
Em Diretório, especifique o caminho onde o arquivo de log deve ser armazenado. O padrão é
%SystemDrive%\inetpub\logs\LogFiles.Observação
Como prática recomendada, armazene arquivos de log, como logs de rastreamento de solicitação com falha, em um diretório que não seja
%systemroot%.Na seção Sobreposição de Arquivo de Log, selecione uma das seguintes opções:
Agendar: para criar um novo arquivo de log baseado em um dos seguintes valores:
- Por hora: um novo arquivo de log é criado a cada hora.
- Por dia: um novo arquivo de log é criado a cada dia.
- Por semana: um novo arquivo de log é criado a cada semana.
- Por mês: um novo arquivo de log é criado a cada mês.
Tamanho Máximo do Arquivo (em bytes): para criar um arquivo de log quando o arquivo atingir determinado tamanho (em bytes). O tamanho mínimo de arquivo é 1048576 bytes. Se esse atributo for definido como um valor menor que 1048576 bytes, o valor padrão será implicitamente considerado como 1048576 bytes.
Não criar um novo arquivo de log: há um único arquivo de log que continua a crescer, conforme a informações são registradas.
Selecione Usar hora local para nomeação de arquivo e sobreposição para especificar que a nomeação do arquivo de log e hora da sobreposição do arquivo usa a hora do servidor local. Quando essa opção não é selecionada, o UTC (Tempo Universal Coordenado) é usado.
Observação
Independente dessa configuração, os carimbos de data/hora no arquivo de log real usarão o formato de hora do formato de log que você selecionar na lista Formato. Por exemplo, os formatos de arquivo de log do NCSA e do W3C usam o formato de hora UTC para os carimbos de data/hora.
Clique em Aplicar no painel Ações.
Configurar registro em log por site no nível do servidor
Você pode executar este procedimento usando a interface do usuário ou editando arquivos de configuração diretamente.
Para configurar registro de log por site no nível do servidor usando a interface do usuário
Na exibição de árvore Conexões do Gerenciador do IIS, selecione o servidor Web.
Em Exibição de Recursos, clique duas vezes em Registrar em Log.
Na página Registrar em Log em Um arquivo de log por site, selecione Site na lista suspensa. Por padrão, o Site é selecionado.
Na página Registrar em Log na seção Arquivo de Log em Formatar, selecione um dos seguintes formatos de arquivo de log:
- IIS: para usar o formato de arquivo de log Microsoft IIS para registrar informações sobre um site. Esse formato é manipulado pelo HTTP.sys e consiste em um formato ASCII fixo baseado em texto, o que significa que você não pode personalizar os campos registrados. Os campos são separados por vírgulas e a hora é registrada conforme a hora local. Para obter mais informações sobre formato de arquivo de log IIS, consulte Formato de arquivo de log ISS (IIS 6.0).
- NCSA: para usar o formato de arquivo de log comum NCSA (National Center for Supercomputing Applications) para registrar informações sobre um site. Esse formato é manipulado pelo HTTP.sys e consiste em um formato ASCII fixo baseado em texto, o que significa que você não pode personalizar os campos registrados. Os campos são separados por espaços e a hora é registrada conforme a hora local com a diferença UTC (Tempo Universal Coordenado). Para obter mais informações sobre formato de arquivo de log NCSA, consulte Formato de Arquivo de Log Comum NCSA (IIS 6.0).
- W3C: para usar o formato de arquivo de log W3C centralizado para registrar informações sobre todos os sites no servidor. Esse formato é manipulado pelo HTTP.sys e consiste em um formato ASCII personalizável baseado em texto, o que significa que você pode especificar os campos registrados. Especifique os campos que são registrados na caixa de diálogo Campos de Log do W3C ao clicar em Selecionar Campos na página Log . Os campos são separados por espaços e a hora sempre será registrada em UTC (Tempo Universal Coordenado). Para obter mais informações sobre formato de arquivo de log W3C, consulte Formato de Arquivo de Log Estendido W3C (IIS 6.0).
- Custom: para usar um formato personalizado para um módulo de registro em log personalizado. Quando você seleciona essa opção, a página Registrar em Log fica desabilitada, porque o registro em log personalizado não pode ser configurado no Gerenciador do IIS. Para obter mais informações sobre como usar formatos de arquivo de log personalizados, consulte Módulos de Registro em Log Personalizados (IIS 6.0).
Em Diretório, especifique o caminho onde o arquivo de log deve ser armazenado. O padrão é
%SystemDrive%\inetpub\logs\LogFiles.Observação
Como prática recomendada, armazene arquivos de log, como logs de rastreamento de solicitação com falha, em um diretório que não seja
%systemroot%.Na seção Sobreposição de Arquivo de Log, selecione uma das seguintes opções:
Agendar: para criar um novo arquivo de log baseado em um dos seguintes valores:
- Por hora: um novo arquivo de log é criado a cada hora.
- Por dia: um novo arquivo de log é criado a cada dia.
- Por semana: um novo arquivo de log é criado a cada semana.
- Por mês: um novo arquivo de log é criado a cada mês.
Tamanho Máximo do Arquivo (em bytes): para criar um arquivo de log quando o arquivo atingir determinado tamanho (em bytes). O tamanho mínimo de arquivo é 1048576 bytes. Se esse atributo for definido como um valor menor que 1048576 bytes, o valor padrão será implicitamente considerado como 1048576 bytes.
Não criar um novo arquivo de log: há um único arquivo de log que continua a crescer, conforme a informações são registradas.
Selecione Usar hora local para nomeação de arquivo e sobreposição para especificar que a nomeação do arquivo de log e hora da sobreposição do arquivo usa a hora do servidor local. Quando essa opção não é selecionada, o UTC (Tempo Universal Coordenado) é usado.
Observação
Independente dessa configuração, os carimbos de data/hora no arquivo de log real usarão o formato de hora do formato de log que você selecionar na lista Formato. Por exemplo, os formatos de arquivo de log do NCSA e do W3C usam o formato de hora UTC para os carimbos de data/hora.
Clique em Aplicar no painel Ações.
Configurar registro em log por servidor no nível do servidor
Você pode executar este procedimento usando a interface do usuário ou editando arquivos de configuração diretamente.
Para configurar registro em log por servidor no nível do servidor usando a interface do usuário
Na exibição de árvore Conexões do Gerenciador do IIS, selecione o servidor Web.
Em Exibição de Recursos, clique duas vezes em Registrar em Log.
Na página Registrar em Log, em Um arquivo de log por site, selecione Servidor na lista suspensa. Por padrão, o Site é selecionado.
Na página Registrar em Log na seção Arquivo de Log em Formatar, selecione um dos seguintes formatos de arquivo de log:
- IIS: para usar o formato de arquivo de log Microsoft IIS para registrar informações sobre um site. Esse formato é manipulado pelo HTTP.sys e consiste em um formato ASCII fixo baseado em texto, o que significa que você não pode personalizar os campos registrados. Os campos são separados por vírgulas e a hora é registrada conforme a hora local. Para obter mais informações sobre formato de arquivo de log IIS, consulte Formato de arquivo de log ISS (IIS 6.0).
- NCSA: para usar o formato de arquivo de log comum NCSA (National Center for Supercomputing Applications) para registrar informações sobre um site. Esse formato é manipulado pelo HTTP.sys e consiste em um formato ASCII fixo baseado em texto, o que significa que você não pode personalizar os campos registrados. Os campos são separados por espaços e a hora é registrada conforme a hora local com a diferença UTC (Tempo Universal Coordenado). Para obter mais informações sobre formato de arquivo de log NCSA, consulte Formato de Arquivo de Log Comum NCSA (IIS 6.0).
- W3C: para usar o formato de arquivo de log W3C centralizado para registrar informações sobre todos os sites no servidor. Esse formato é manipulado pelo HTTP.sys e consiste em um formato ASCII personalizável baseado em texto, o que significa que você pode especificar os campos registrados. Especifique os campos que são registrados na caixa de diálogo Campos de Log do W3C ao clicar em Selecionar Campos na página Log . Os campos são separados por espaços e a hora sempre será registrada em UTC (Tempo Universal Coordenado). Para obter mais informações sobre formato de arquivo de log W3C, consulte Formato de Arquivo de Log Estendido W3C (IIS 6.0).
- Custom: para usar um formato personalizado para um módulo de registro em log personalizado. Quando você seleciona essa opção, a página Registrar em Log fica desabilitada, porque o registro em log personalizado não pode ser configurado no Gerenciador do IIS. Para obter mais informações sobre como usar formatos de arquivo de log personalizados, consulte Módulos de Registro em Log Personalizados (IIS 6.0).
Em Diretório, especifique o caminho onde o arquivo de log deve ser armazenado. O padrão é
%SystemDrive%\inetpub\logs\LogFiles.Observação
Como prática recomendada, armazene arquivos de log, como logs de rastreamento de solicitação com falha, em um diretório que não seja
%systemroot%.Na seção Sobreposição de Arquivo de Log, selecione uma das seguintes opções:
Agendar: para criar um novo arquivo de log baseado em um dos seguintes valores:
- Por hora: um novo arquivo de log é criado a cada hora.
- Por dia: um novo arquivo de log é criado a cada dia.
- Por semana: um novo arquivo de log é criado a cada semana.
- Por mês: um novo arquivo de log é criado a cada mês.
Tamanho Máximo do Arquivo (em bytes): para criar um arquivo de log quando o arquivo atingir determinado tamanho (em bytes). O tamanho mínimo de arquivo é 1048576 bytes. Se esse atributo for definido como um valor menor que 1048576 bytes, o valor padrão será implicitamente considerado como 1048576 bytes.
Não criar um novo arquivo de log: há um único arquivo de log que continua a crescer, conforme a informações são registradas.
Selecione Usar hora local para nomeação de arquivo e sobreposição para especificar que a nomeação do arquivo de log e hora da sobreposição do arquivo usa a hora do servidor local. Quando essa opção não é selecionada, o UTC (Tempo Universal Coordenado) é usado.
Observação
Independente dessa configuração, os carimbos de data/hora no arquivo de log real usarão o formato de hora do formato de log que você selecionar na lista Formato. Por exemplo, os formatos de arquivo de log do NCSA e do W3C usam o formato de hora UTC para os carimbos de data/hora.
Clique em Aplicar no painel Ações.
Selecionar campos W3C para log
Você pode executar este procedimento usando a interface do usuário ou editando arquivos de configuração diretamente.
Para selecionar campos do W3C para registrar usando a interface do usuário
Em Exibição de Recursos do Gerenciador de IIS, clique duas vezes em Registrar em Log.
Na página Registrar em Log, na seção Arquivo de Log em Formatar, clique em Selecionar Campos.
Na caixa de diálogo Campos de Log do W3C, selecione uma ou mais das seguintes opções:
- Data (date): a data em que a solicitação ocorreu.
- Hora (time): a hora, em UTC (Tempo Universal Coordenado), no qual a solicitação ocorreu.
- Endereço IP do Cliente (c-ip): o endereço IP do cliente que fez a solicitação.
- Nome de Usuário (cs-username): o nome do usuário autenticado quem acessou seu servidor. Os usuários anônimos são indicados por um hífen.
- Nome de Serviço (s-sitename): o número da instância preenchido na solicitação.
- Nome do Servidor (s-computername): o nome do servidor no qual a entrada do arquivo de log foi gerada.
- Endereço IP do Servidor (s-IP): o endereço IP do servidor no qual a entrada do arquivo de log foi gerada.
- Porta do Servidor (s-port): o número da porta do servidor configurada para o serviço.
- Método (cs-method): a ação solicitada, por exemplo, um método GET.
- Tronco URI (cs-uri-stem): Universal Resource Identifier ou destino da ação.
- Consulta URI (cs-uri-query): a consulta, se houver, que o cliente estava tentando executar. Um URI (Resource Identifier Universal) consulta é necessário apenas para páginas dinâmico.
- Status do Protocolo (sc-Status): o código de status de HTTP ou FTP.
- Substatus de Protocolo (sc-substatus): o código de substatus de HTTP ou FTP.
- Status Win32 (sc-win32-status): o código de status do Windows.
- Bytes Enviados (sc-bytes): o número de bytes que o servidor enviou.
- Bytes Recebidos (cs-bytes): o número de bytes que o servidor recebeu.
- Tempo Decorrido (time-taken): o período de tempo que a ação tomou em milissegundos.
- Versão do Protocolo (cs-version): a versão do protocolo, HTTP ou FTP, que o cliente usou.
- Host (cs-host): o nome do host, se houver.
- Agente do Usuário (cs(UserAgent)): o tipo de navegador que o cliente usou.
- Cookie (cs(Cookie)): o conteúdo do cookie enviado ou recebido, se houver.
- Referenciador (cs(Referrer)): o site que o usuário acessou pela última vez. Esse site fornece um link para o site atual.
Clique em Aplicar no painel Ações.
Configurar opções de sobreposição do arquivo de log
Você pode executar este procedimento usando a interface do usuário ou editando arquivos de configuração diretamente.
Para configurar opções de sobreposição do arquivo de log usando a interface do usuário
Em Exibição de Recursos do Gerenciador de IIS, clique duas vezes em Registrar em Log.
Na página Registrar em Log, na seção Sobreposição do Arquivo de Log, selecione uma das seguintes opções:
Agendar: para criar um novo arquivo de log baseado em um dos seguintes valores:
- Por hora: um novo arquivo de log é criado a cada hora.
- Por dia: um novo arquivo de log é criado a cada dia.
- Por semana: um novo arquivo de log é criado a cada semana.
- Por mês: um novo arquivo de log é criado a cada mês.
Tamanho Máximo do Arquivo (em bytes): para criar um arquivo de log quando o arquivo atingir determinado tamanho (em bytes). O tamanho mínimo de arquivo é 1048576 bytes. Se esse atributo for definido como um valor menor que 1048576 bytes, o valor padrão será implicitamente considerado como 1048576 bytes.
Não criar um novo arquivo de log: esta opção significa que há um único arquivo de log que continua a crescer, conforme a informações são registradas. Se você usar um único arquivo de log para o site, ele será útil se você usar utilitários de análise de log, mas ele também cria arquivos de log maiores que podem afetar o desempenho geral do servidor.
Selecione Usar hora local para nomeação de arquivo e sobreposição para especificar que a nomeação do arquivo de log e hora da sobreposição do arquivo usa a hora do servidor local. Quando essa opção não é selecionada, o UTC (Tempo Universal Coordenado) é usado.
Observação
Independente dessa configuração, os carimbos de data/hora no arquivo de log real usarão o formato de hora do formato de log que você selecionar na lista Formato. Por exemplo, os formatos de arquivo de log do NCSA e do W3C usam o formato de hora UTC para os carimbos de data/hora.
Clique em Aplicar no painel Ações.