Arquivo de log binário central <centralBinaryLogFile>
Visão geral
O elemento <centralBinaryLogFile> especifica as configurações de log binário central para todos os sites em um servidor.
Observação
Você precisa definir o atributo centralLogFileMode do elemento pai <log> como CentralBinary para que os atributos no elemento <centralW3CLogFile> tenham efeito. Se o atributo centralLogFileMode do elemento <log> for definido como CentralW3C ou Site, os atributos no elemento <centralW3CLogFile> serão ignorados.
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 <centralBinaryLogFile> não foi modificado no IIS 10.0. |
| IIS 8.5 | O elemento <centralBinaryLogFile> não foi modificado no IIS 8.5. |
| IIS 8.0 | O elemento <centralBinaryLogFile> não foi modificado no IIS 8.0. |
| IIS 7.5 | O elemento <centralBinaryLogFile> não foi modificado no IIS 7.5. |
| IIS 7.0 | O elemento <centralBinaryLogFile> do elemento <log> foi introduzido no IIS 7.0. |
| IIS 6,0 | O elemento <log> substitui o sinalizador CentralBinaryLoggingEnabled do IIS 6.0. |
Instalação
O elemento <centralBinaryLogFile> do 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.
Configuração
Atributos
| Atributo | Descrição | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
directory |
Atributo de cadeia de caracteres opcional. Especifica o diretório em que as entradas de log são gravadas. |
||||||||||||
enabled |
Atributo booliano opcional. Especifica se o log binário central é habilitado. Além disso, centralLogFileMode deve ser definido como CentralBinary para habilitar totalmente o registro em log binário central. O valor padrão é false. |
||||||||||||
localTimeRollover |
Atributo booliano opcional. Especifica se um novo arquivo de log é criado com base na hora local ou UTC (Tempo Universal Coordenado). Um valor True significa que o novo arquivo de log é baseado na hora local; False significa que ele é baseado no UTC. O valor padrão é false. |
||||||||||||
period |
Atributo de enumeração opcional. Especifica com que frequência o conteúdo do arquivo de log deve ser limpo. O atributo period pode ser um dos valores possíveis a seguir. O valor padrão é Daily.
|
||||||||||||
truncateSize |
Atributo int64 opcional. Especifica o tamanho em que o conteúdo do arquivo de log deve ser truncado. Esse atributo deve ser definido quando o valor do atributo de período for maxSize. O tamanho deverá estar entre 1048576 (1 megabyte) e 4294967295 (4 gigabytes). O valor padrão é 20971520 (20 megabytes). |
Elementos filho
Nenhum.
Exemplo de configuração
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>
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()