Archivo de registro binario central <centralBinaryLogFile>
Información general
El elemento <centralBinaryLogFile> especifica la configuración central del registro binario para todos los sitios de un servidor.
Nota:
Debe establecer el atributo centralLogFileMode del elemento <log> primario en CentralBinary para que los atributos del elemento <centralW3CLogFile> tengan efecto. Si el atributo centralLogFileMode del elemento <log> se establece en CentralW3C o Site, se omitirán los atributos del elemento <centralW3CLogFile>.
Nota:
Los archivos de registro en formato W3C son archivos basados en texto que la mayoría de las utilidades de análisis de registros pueden procesar. Los archivos de registro binarios usan un formato de almacenamiento propietario que requiere el uso de una aplicación que puede procesar archivos de registro en ese formato, como la utilidad LogParser de Microsoft.
Compatibilidad
| Versión | Notas |
|---|---|
| IIS 10.0 | El elemento <centralBinaryLogFile> no se modificó en IIS 10.0. |
| IIS 8.5 | El elemento <centralBinaryLogFile> no se modificó en IIS 8.5. |
| IIS 8.0 | El elemento <centralBinaryLogFile> no se modificó en IIS 8.0. |
| IIS 7.5 | El elemento <centralBinaryLogFile> no se modificó en IIS 7.5. |
| IIS 7.0 | El elemento <centralBinaryLogFile> del elemento <log> se introdujo en IIS 7.0. |
| IIS 6,0 | El elemento <log> reemplaza la marca CentralBinaryLoggingEnabled de IIS 6.0. |
Configuración
El elemento <centralBinaryLogFile> del elemento <log> se incluye en la instalación predeterminada de IIS 7.
Procedimientos
Habilitación del registro binario central para un servidor
Abra el Administrador de Internet Information Services (IIS):
Si usa Windows Server 2012 o Windows Server 2012 R2:
- En la barra de tareas, haga clic en Administrador del servidor, en Herramientas y, a continuación, en Administrador de Internet Information Services (IIS).
Si usa Windows 8 o Windows 8.1:
- Mantenga presionada la tecla Windows, presione la letra X y haga clic en Panel de control.
- En Panel de control, haga clic en Herramientas administrativas y, a continuación, haga doble clic en Administrador de Internet Information Services (IIS).
Si usa Windows Server 2008 o Windows Server 2008 R2:
- En la barra de tareas, haga clic en Inicio, seleccione Herramientas administrativas y, a continuación, haga clic en Administrador de Internet Information Services (IIS).
Si usa Windows Vista o Windows 7:
- En la barra de tareas, haga clic en Inicio y, luego, haga clic en Panel de control.
- Haga doble clic en Herramientas administrativas y, a continuación, haga doble clic en Administrador de Internet Information Services (IIS).
En el panel Conexiones, haga clic en el nombre del servidor.
En el panel Inicio del servidor, haga doble clic en Registro.
En la página Registro, en Un archivo de registro por día, seleccione Servidor en la lista desplegable y, a continuación, elija Binario en la lista desplegable Formato.
Haga clic en Aplicar en el panel Acciones.
Configuración
Atributos
| Atributo | Descripción | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
directory |
Atributo de cadena opcional. Especifica el directorio en el que se escriben las entradas del registro. |
||||||||||||
enabled |
Atributo Boolean opcional. Especifica si está habilitado el registro binario central. Además, centralLogFileMode debe establecerse en CentralBinary para habilitar completamente el registro binario central. El valor predeterminado es false. |
||||||||||||
localTimeRollover |
Atributo Boolean opcional. Especifica si se crea un nuevo archivo de registro en función de la hora local o de la hora universal coordinada (UTC). Un valor true significa que el nuevo archivo de registro se basa en la hora local; false significa que se basa en UTC. El valor predeterminado es false. |
||||||||||||
period |
Atributo enum opcional. Especifica la frecuencia con la que se debe borrar el contenido del archivo de registro. El atributo period puede ser uno de los siguientes valores posibles. El valor predeterminado es Daily.
|
||||||||||||
truncateSize |
Atributo int64 opcional. Especifica el tamaño en el que se debe truncar el contenido del archivo de registro. Este atributo debe establecerse cuando el valor del atributo period es maxSize. El tamaño debe estar entre 1048576 (1 megabyte) y 4294967295 (4 gigabytes). El valor predeterminado es 20971520 (20 megabytes). |
Elementos secundarios
Ninguno.
Ejemplo de configuración
En el ejemplo de configuración siguiente se especifica que IIS usará el registro binario central y configura la rotación de archivos de registro binario diariamente.
<log centralLogFileMode="CentralBinary">
<centralBinaryLogFile enabled="true" directory="%SystemDrive%\inetpub\logs\LogFiles" period="Daily" />
<centralW3CLogFile enabled="true" directory="%SystemDrive%\inetpub\logs\LogFiles" />
</log>
Código de ejemplo
Los ejemplos de código siguientes especifican que IIS usará el registro binario central y configurará la rotación de archivos de registro binario 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
Nota:
Debe asegurarse de establecer el parámetro de confirmación en apphost cuando use AppCmd.exe para configurar estas opciones. Esto confirma los valores de configuración en la sección de ubicación adecuada del archivo 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()