Log <log>

Artigo
03/21/2024

Visão geral

O elemento <log> especifica várias opções de registro em log global para o IIS (Serviços de Informações da Internet) 7. Por exemplo, o atributo centralLogFileMode especifica se o registro em log no nível do site, o registro em log W3C central ou o registro em log binário central estão habilitados.

O registro em log no nível do site cria diretórios de arquivos de log individuais para cada site no servidor, onde cada pasta contém apenas os arquivos de log para esse site. O registro em log central permite o uso de um único arquivo de log para todos os sites para o período de tempo especificado pelo período atributo para o elemento <centralBinaryLogFile> ou <centralW3CLogFile>. O período de tempo pode ser diário, semanal, mensal, por hora ou um tamanho máximo de arquivo.

Observação

Arquivos de log no formato W3C são arquivos baseados em texto que a maioria dos utilitários de análise de log pode processar. Os arquivos de log binários usam um formato de armazenamento proprietário que requer o uso de um aplicativo que possa processar arquivos de log nesse formato, como o utilitário LogParser da Microsoft.

Compatibilidade

Versão	Observações
IIS 10.0	O elemento `<log>` não foi modificado no IIS 10.0.
IIS 8.5	O elemento `<log>` não foi modificado no IIS 8.5.
IIS 8.0	O elemento `<log>` não foi modificado no IIS 8.0.
IIS 7.5	O elemento `<log>` não foi modificado no IIS 7.5.
IIS 7.0	O elemento `<log>` foi introduzido no IIS 7.0.
IIS 6,0	O elemento `<log>` substitui os seguintes atributos do IIS 6.0: CentralBinaryLoggingEnabled CentralW3CLoggingEnabled LogInUTF8

Instalação

O elemento <log> está incluído na instalação padrão do IIS 7.

Instruções

Como habilitar o registro em log binário central para um servidor

Abra o Gerenciador dos Serviços de Informações da Internet (IIS):
- Caso você esteja usando o Windows Server 2012 ou o Windows Server 2012 R2:
  - Na barra de tarefas, clique em Gerenciador do Servidor, em Ferramentas e em Gerenciador dos Serviços de Informações da Internet (IIS).
- Se você estiver usando o Windows 8 ou Windows 8.1:
  - Mantenha pressionada a tecla Windows, pressione a letra X e clique em Painel de Controle.
  - Clique em Ferramentas Administrativas e clique duas vezes em Gerenciador dos Serviços de Informações da Internet (IIS).
- Caso você esteja usando o Windows Server 2008 ou o Windows Server 2008 R2:
  - Na barra de tarefas, clique em Iniciar, vá para Ferramentas Administrativas e clique em Gerenciador dos Serviços de Informações da Internet (IIS).
- Se você estiver usando o Windows Vista ou Windows 7:
  - Na barra de tarefas, clique em Iniciar e, depois, em Painel de Controle.
  - Clique duas vezes em Ferramentas Administrativas e clique duas vezes em Gerenciador dos Serviços de Informações da Internet (IIS).
No painel Conexões, clique no nome do servidor.
No painel Página Inicial do servidor, clique duas vezes em Registro em Log.
Na página Registro em Log, em Um arquivo de log por, selecione Servidor na lista suspensa e escolha Binário na lista suspensa Formatar.
Clique em Aplicar no painel Ações.

Como habilitar o registro em log W3C central para um servidor

Abra o Gerenciador dos Serviços de Informações da Internet (IIS):
- Caso você esteja usando o Windows Server 2012 ou o Windows Server 2012 R2:
  - Na barra de tarefas, clique em Gerenciador do Servidor, em Ferramentas e em Gerenciador dos Serviços de Informações da Internet (IIS).
- Se você estiver usando o Windows 8 ou Windows 8.1:
  - Mantenha pressionada a tecla Windows, pressione a letra X e clique em Painel de Controle.
  - Clique em Ferramentas Administrativas e clique duas vezes em Gerenciador dos Serviços de Informações da Internet (IIS).
- Caso você esteja usando o Windows Server 2008 ou o Windows Server 2008 R2:
  - Na barra de tarefas, clique em Iniciar, vá para Ferramentas Administrativas e clique em Gerenciador dos Serviços de Informações da Internet (IIS).
- Se você estiver usando o Windows Vista ou Windows 7:
  - Na barra de tarefas, clique em Iniciar e, depois, em Painel de Controle.
  - Clique duas vezes em Ferramentas Administrativas e clique duas vezes em Gerenciador dos Serviços de Informações da Internet (IIS).
No painel Conexões, clique no nome do servidor.
No painel Página Inicial do servidor, clique duas vezes em Registro em Log.
Na página Registro em Log, em Um arquivo de log por, selecione Servidor na lista suspensa e escolha W3C na lista suspensa Formatar.
Clique em Aplicar no painel Ações.

Configuração

Atributos

Atributo Descrição

centralLogFileMode

Atributo de enumeração opcional.

Especifica o modo de registro em log central para o servidor.

O atributo centralLogFileMode pode ter um dos valores possíveis a seguir. O padrão é Site.

Valor	Descrição
`Site`	Configura todos os sites para usar o registro em log do site em vez do registro em log central. Esta é a configuração padrão. O valor numérico é 0.
`CentralBinary`	Cria um arquivo de log para todos os sites em um servidor Web. Os dados no arquivo de log são dados não formatados baseados em binário que não são personalizáveis. O valor numérico é 1.
`CentralW3C`	Registra solicitações de todos os sites em um servidor Web para um único arquivo de log central em um formato ASCII personalizável baseado em texto. O valor numérico é 2.

logInUTF8 Atributo booliano opcional.

Especifica se o IIS deve registrar em log todas as cadeias de caracteres no UTF-8. Essa configuração aplica todo o servidor a todos os registros em log de modo de texto.

O valor padrão é true.

Elementos filho

Elemento	Descrição
`centralBinaryLogFile`	Elemento opcional. Especifica as configurações de log binário central para todos os sites em um servidor.
`centralW3CLogFile`	Elemento opcional. Especifica as configurações de log W3C central para todos os sites em um servidor.

Exemplo de configuração

O exemplo de configuração a seguir especifica que o IIS usará o registro em log no nível do site.

<log centralLogFileMode="Site">
   <centralBinaryLogFile enabled="true" directory="%SystemDrive%\inetpub\logs\LogFiles" />
   <centralW3CLogFile enabled="true" directory="%SystemDrive%\inetpub\logs\LogFiles" />
</log>

O exemplo de configuração a seguir especifica que o IIS usará o registro em log binário central e configurará a rotação de arquivos de log binários diariamente.

<log centralLogFileMode="CentralBinary">
   <centralBinaryLogFile enabled="true" directory="%SystemDrive%\inetpub\logs\LogFiles" period="Daily" />
   <centralW3CLogFile enabled="true" directory="%SystemDrive%\inetpub\logs\LogFiles" />
</log>

O exemplo de configuração a seguir especifica que o IIS usará o registro em log W3C central e configurará a rotação de arquivos de log W3C diariamente.

<log centralLogFileMode="CentralW3C">
   <centralBinaryLogFile enabled="true" directory="%SystemDrive%\inetpub\logs\LogFiles" />
   <centralW3CLogFile enabled="true" directory="%SystemDrive%\inetpub\logs\LogFiles" period="Daily" />
</log>

Exemplo de código

Os exemplos de código a seguir especificam que o IIS usará o log de registro binário central e configurará a rotação de arquivos de log binários diariamente.

AppCmd.exe

appcmd.exe set config -section:system.applicationHost/log /centralLogFileMode:"CentralBinary" /commit:apphost

appcmd.exe set config -section:system.applicationHost/log /centralBinaryLogFile.period:"Daily" /commit:apphost

Observação

Defina o parâmetro commit para apphost quando usar AppCmd.exe para definir essas configurações. Isso confirma as definições de configuração para a seção de local apropriado no arquivo ApplicationHost.config.

C#

using System;
using System.Text;
using Microsoft.Web.Administration;

internal static class Sample
{
   private static void Main()
   {
      using (ServerManager serverManager = new ServerManager())
      {
         Configuration config = serverManager.GetApplicationHostConfiguration();

         ConfigurationSection logSection = config.GetSection("system.applicationHost/log");
         logSection["centralLogFileMode"] = @"CentralBinary";
         ConfigurationElement centralBinaryLogFileElement = logSection.GetChildElement("centralBinaryLogFile");
         centralBinaryLogFileElement["period"] = @"Daily";

         serverManager.CommitChanges();
      }
   }
}

VB.NET

Imports System
Imports System.Text
Imports Microsoft.Web.Administration

Module Sample

   Sub Main()
      Dim serverManager As ServerManager = New ServerManager
      Dim config As Configuration = serverManager.GetApplicationHostConfiguration

      Dim logSection As ConfigurationSection = config.GetSection("system.applicationHost/log")
      logSection("centralLogFileMode") = "CentralBinary"
      Dim centralBinaryLogFileElement As ConfigurationElement = logSection.GetChildElement("centralBinaryLogFile")
      centralBinaryLogFileElement("period") = "Daily"

      serverManager.CommitChanges()
   End Sub

End Module

JavaScript

var adminManager = new ActiveXObject('Microsoft.ApplicationHost.WritableAdminManager');
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST";

var logSection = adminManager.GetAdminSection("system.applicationHost/log", "MACHINE/WEBROOT/APPHOST");
logSection.Properties.Item("centralLogFileMode").Value = "CentralBinary";
var centralBinaryLogFileElement = logSection.ChildElements.Item("centralBinaryLogFile");
centralBinaryLogFileElement.Properties.Item("period").Value = "Daily";

adminManager.CommitChanges();

VBScript

Set adminManager = WScript.CreateObject("Microsoft.ApplicationHost.WritableAdminManager")
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST"

Set logSection = adminManager.GetAdminSection("system.applicationHost/log", "MACHINE/WEBROOT/APPHOST")
logSection.Properties.Item("centralLogFileMode").Value = "CentralBinary"
Set centralBinaryLogFileElement = logSection.ChildElements.Item("centralBinaryLogFile")
centralBinaryLogFileElement.Properties.Item("period").Value = "Daily"

adminManager.CommitChanges()

Os exemplos de código a seguir especificam que o IIS usará o registro em log W3C central e configurará a rotação do arquivos de log W3C diariamente.

AppCmd.exe

appcmd.exe set config -section:system.applicationHost/log /centralLogFileMode:"CentralW3C" /commit:apphost

appcmd.exe set config -section:system.applicationHost/log /centralW3CLogFile.period:"Daily" /commit:apphost

Observação

C#

using System;
using System.Text;
using Microsoft.Web.Administration;

internal static class Sample
{
   private static void Main()
   {
      using (ServerManager serverManager = new ServerManager())
      {
         Configuration config = serverManager.GetApplicationHostConfiguration();

         ConfigurationSection logSection = config.GetSection("system.applicationHost/log");
         logSection["centralLogFileMode"] = @"CentralW3C";
         ConfigurationElement centralW3CLogFileElement = logSection.GetChildElement("centralW3CLogFile");
         centralW3CLogFileElement["period"] = @"Daily";

         serverManager.CommitChanges();
      }
   }
}

VB.NET

Imports System
Imports System.Text
Imports Microsoft.Web.Administration

Module Sample

   Sub Main()
      Dim serverManager As ServerManager = New ServerManager
      Dim config As Configuration = serverManager.GetApplicationHostConfiguration

      Dim logSection As ConfigurationSection = config.GetSection("system.applicationHost/log")
      logSection("centralLogFileMode") = "CentralW3C"
      Dim centralW3CLogFileElement As ConfigurationElement = logSection.GetChildElement("centralW3CLogFile")
      centralW3CLogFileElement("period") = "Daily"

      serverManager.CommitChanges()
   End Sub

End Module

JavaScript

var adminManager = new ActiveXObject('Microsoft.ApplicationHost.WritableAdminManager');
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST";

var logSection = adminManager.GetAdminSection("system.applicationHost/log", "MACHINE/WEBROOT/APPHOST");
logSection.Properties.Item("centralLogFileMode").Value = "CentralW3C";
var centralW3CLogFileElement = logSection.ChildElements.Item("centralW3CLogFile");
centralW3CLogFileElement.Properties.Item("period").Value = "Daily";

adminManager.CommitChanges();

VBScript

Set adminManager = WScript.CreateObject("Microsoft.ApplicationHost.WritableAdminManager")
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST"

Set logSection = adminManager.GetAdminSection("system.applicationHost/log", "MACHINE/WEBROOT/APPHOST")
logSection.Properties.Item("centralLogFileMode").Value = "CentralW3C"
Set centralW3CLogFileElement = logSection.ChildElements.Item("centralW3CLogFile")
centralW3CLogFileElement.Properties.Item("period").Value = "Daily"

adminManager.CommitChanges()

Compartilhar via

Log <log>

Visão geral

Compatibilidade

Instalação

Instruções

Como habilitar o registro em log binário central para um servidor

Como habilitar o registro em log W3C central para um servidor

Configuração

Atributos

Elementos filho

Exemplo de configuração

Exemplo de código

AppCmd.exe

C#

VB.NET

JavaScript

VBScript

AppCmd.exe

C#

VB.NET

JavaScript

VBScript

Comentários

Recursos adicionais