Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Общие сведения
Элемент <centralBinaryLogFile> задает параметры центрального двоичного журнала для всех сайтов на сервере.
Примечание
Необходимо задать для атрибута centralLogFileMode родительского <log> элемента значение CentralBinary , чтобы атрибуты <centralW3CLogFile> элемента имели эффект. Если атрибут <log>centralLogFileMode элемента имеет значение CentralW3C или Site, атрибуты <centralW3CLogFile> элемента будут игнорироваться.
Примечание
Файлы журналов в формате W3C — это текстовые файлы, которые могут обрабатываться большинством служебных программ анализа журналов. Двоичные файлы журналов используют собственный формат хранилища, который требует использования приложения, которое может обрабатывать файлы журналов в этом формате, например служебную программу LogParser корпорации Майкрософт .
Совместимость
| Версия | Примечания |
|---|---|
| IIS 10.0 | Элемент <centralBinaryLogFile> не был изменен в IIS 10.0. |
| IIS 8,5 | Элемент <centralBinaryLogFile> не был изменен в IIS 8.5. |
| IIS 8,0 | Элемент <centralBinaryLogFile> не был изменен в IIS 8.0. |
| IIS 7,5 | Элемент <centralBinaryLogFile> не был изменен в IIS 7.5. |
| IIS 7.0 | Элемент <centralBinaryLogFile> элемента появился <log> в IIS 7.0. |
| IIS 6,0 | Элемент <log> заменяет флаг IIS 6.0 CentralBinaryLoggingEnabled . |
Настройка
Элемент <centralBinaryLogFile><log> элемента включен в установку IIS 7 по умолчанию.
Инструкции
Включение централизованного двоичного ведения журнала для сервера
Откройте диспетчер служб IIS.
Если вы используете Windows Server 2012 или Windows Server 2012 R2:
- На панели задач щелкните диспетчер сервера, инструменты, а затем диспетчер служб IIS.
Если вы используете Windows 8 или Windows 8.1:
- Удерживая нажатой клавишу Windows, нажмите букву X и щелкните панель управления.
- Щелкните Администрирование, а затем дважды щелкните диспетчер служб IIS.
Если вы используете Windows Server 2008 или Windows Server 2008 R2:
- На панели задач нажмите кнопку Пуск, наведите указатель на пункт Администрирование, а затем щелкните Диспетчер служб IIS.
Если вы используете Windows Vista или Windows 7:
- На панели задач нажмите кнопку Пуск, а затем выберите пункт панель управления.
- Дважды щелкните элемент Администрирование, а затем дважды щелкните диспетчер служб IIS.
В области Подключения щелкните имя сервера.
На панели Главная сервера дважды щелкните ведение журнала.
На странице Ведение журнала в разделе Один файл журнала в раскрывающемся списке выберите Сервер, а затем в раскрывающемся списке Формат выберите Двоичный файл.
Щелкните Применить в области Действия.
Конфигурация
Атрибуты
| Атрибут | Описание | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
directory |
Необязательный строковый атрибут. Указывает каталог, в который записываются записи журнала. |
||||||||||||
enabled |
Дополнительный логический атрибут. Указывает, включено ли централизованное двоичное ведение журнала. Кроме того, для параметра centralLogFileMode необходимо задать значение CentralBinary , чтобы полностью включить централизованное двоичное ведение журнала. Значение по умолчанию — false. |
||||||||||||
localTimeRollover |
Дополнительный логический атрибут. Указывает, создается ли новый файл журнала на основе местного времени или времени в формате UTC. Значение true означает, что новый файл журнала основан на местном времени; Значение false означает, что оно основано на формате UTC. Значение по умолчанию — false. |
||||||||||||
period |
Необязательный атрибут перечисления. Указывает, как часто следует очищать содержимое файла журнала. Атрибут period может иметь одно из следующих возможных значений. Значение по умолчанию — Daily.
|
||||||||||||
truncateSize |
Необязательный атрибут int64. Указывает размер, при котором содержимое файла журнала должно быть усечено. Этот атрибут необходимо задать, если значение атрибута period равно maxSize. Размер должен быть от 1048576 (1 мегабайт) до 4294967295 (4 гигабайта). Значение по умолчанию — 20971520 (20 мегабайт). |
Дочерние элементы
Отсутствует.
Образец конфигурации
В следующем примере конфигурации указано, что службы IIS будут использовать централизованное ведение журнала двоичных файлов и ежедневно настраивают смену двоичных файлов журнала.
<log centralLogFileMode="CentralBinary">
<centralBinaryLogFile enabled="true" directory="%SystemDrive%\inetpub\logs\LogFiles" period="Daily" />
<centralW3CLogFile enabled="true" directory="%SystemDrive%\inetpub\logs\LogFiles" />
</log>
Пример кода
В следующих примерах кода указывается, что СЛУЖБЫ IIS будут использовать централизованное двоичное ведение журнала и настраивать смену файлов двоичных журналов на ежедневной основе.
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
Примечание
При использовании AppCmd.exe для настройки этих параметров для параметра apphostфиксации необходимо задать значение . Это зафиксирует параметры конфигурации в соответствующем разделе расположения в файле 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()