Схема конфигурации системы диагностики Azure версии 1.0Azure Diagnostics 1.0 Configuration Schema

Примечание

Система диагностики Azure — это компонент, который используется для сбора данных счетчиков производительности и других статистических данных из виртуальных машин Azure, масштабируемых наборов виртуальных машин, Service Fabric и облачных служб.Azure Diagnostics is the component used to collect performance counters and other statistics from Azure Virtual Machines, Virtual Machine Scale Sets, Service Fabric, and Cloud Services. Данная страница применяется только в том случае, если вы используете одну из этих служб.This page is only relevant if you are using one of these services.

Система диагностики Azure используется с другими продуктами диагностики корпорации Майкрософт, такими как Azure Monitor, Application Insights и Log Analytics.Azure Diagnostics is used with other Microsoft diagnostics products like Azure Monitor, Application Insights, and Log Analytics.

Файл конфигурации системы диагностики Azure определяет значения, которые используются для инициализации монитора диагностики.The Azure Diagnostics configuration file defines values that are used to initialize the Diagnostics Monitor. Этот файл используется для инициализации параметров конфигурации диагностики при запуске монитора диагностики.This file is used to initialize diagnostic configuration settings when the diagnostics monitor starts.

По умолчанию файл схемы конфигурации системы диагностики Azure устанавливается в каталог C:\Program Files\Microsoft SDKs\Azure\.NET SDK\<version>\schemas.By default, the Azure Diagnostics configuration schema file is installed to the C:\Program Files\Microsoft SDKs\Azure\.NET SDK\<version>\schemas directory. Замените <version> установленной версией пакета SDK для Azure.Replace <version> with the installed version of the Azure SDK.

Примечание

Файл конфигурации диагностики обычно используется в задачах запуска, переда запуском которых должны быть собраны нужные им диагностические данные.The diagnostics configuration file is typically used with startup tasks that require diagnostic data to be collected earlier in the startup process. Дополнительные сведения об использовании системы диагностики Azure см. в статье Включение системы диагностики Azure в облачных службах Azure.For more information about using Azure Diagnostics, see Collect Logging Data by Using Azure Diagnostics.

Пример файла конфигурации диагностикиExample of the diagnostics configuration file

В следующем примере показан типичный файл конфигурации диагностики.The following example shows a typical diagnostics configuration file:

<?xml version="1.0" encoding="utf-8"?>
<DiagnosticMonitorConfiguration xmlns="http://schemas.microsoft.com/ServiceHosting/2010/10/DiagnosticsConfiguration"  
      configurationChangePollInterval="PT1M"  
      overallQuotaInMB="4096">  
   <DiagnosticInfrastructureLogs bufferQuotaInMB="1024"  
      scheduledTransferLogLevelFilter="Verbose"  
      scheduledTransferPeriod="PT1M" />  
   <Logs bufferQuotaInMB="1024"  
      scheduledTransferLogLevelFilter="Verbose"  
      scheduledTransferPeriod="PT1M" />  

   <Directories bufferQuotaInMB="1024"   
      scheduledTransferPeriod="PT1M">  

      <!-- These three elements specify the special directories   
           that are set up for the log types -->  
      <CrashDumps container="wad-crash-dumps" directoryQuotaInMB="256" />  
      <FailedRequestLogs container="wad-frq" directoryQuotaInMB="256" />  
      <IISLogs container="wad-iis" directoryQuotaInMB="256" />  

      <!-- For regular directories the DataSources element is used -->  
      <DataSources>  
         <DirectoryConfiguration container="wad-panther" directoryQuotaInMB="128">  
            <!-- Absolute specifies an absolute path with optional environment expansion -->  
            <Absolute expandEnvironment="true" path="%SystemRoot%\system32\sysprep\Panther" />  
         </DirectoryConfiguration>  
         <DirectoryConfiguration container="wad-custom" directoryQuotaInMB="128">  
            <!-- LocalResource specifies a path relative to a local   
                 resource defined in the service definition -->  
            <LocalResource name="MyLoggingLocalResource" relativePath="logs" />  
         </DirectoryConfiguration>  
      </DataSources>  
   </Directories>  

   <PerformanceCounters bufferQuotaInMB="512" scheduledTransferPeriod="PT1M">  
      <!-- The counter specifier is in the same format as the imperative   
           diagnostics configuration API -->  
      <PerformanceCounterConfiguration   
         counterSpecifier="\Processor(_Total)\% Processor Time" sampleRate="PT5S" />  
   </PerformanceCounters>  

   <WindowsEventLog bufferQuotaInMB="512"  
      scheduledTransferLogLevelFilter="Verbose"  
      scheduledTransferPeriod="PT1M">  
      <!-- The event log name is in the same format as the imperative   
           diagnostics configuration API -->  
      <DataSource name="System!*" />  
   </WindowsEventLog>  
</DiagnosticMonitorConfiguration>  

Пространство имен DiagnosticsConfigurationDiagnosticsConfiguration Namespace

Пространство имен XML для файла конфигурации диагностики:The XML namespace for the diagnostics configuration file is:

http://schemas.microsoft.com/ServiceHosting/2010/10/DiagnosticsConfiguration  

Элементы схемыSchema Elements

Файл конфигурации диагностики содержит следующие элементы.The diagnostics configuration file includes the following elements.

Элемент DiagnosticMonitorConfigurationDiagnosticMonitorConfiguration Element

Элемент верхнего уровня в файле конфигурации диагностики.The top-level element of the diagnostics configuration file.

Атрибуты:Attributes:

АтрибутAttribute ТипType ОбязательноRequired значение по умолчаниюDefault ОписаниеDescription
configurationChangePollIntervalconfigurationChangePollInterval длительностьduration НеобязательноOptional PT1MPT1M Указывает интервал, с которым монитор диагностики опрашивает наличие изменений конфигурации диагностики.Specifies the interval at which the diagnostic monitor polls for diagnostic configuration changes.
overallQuotaInMBoverallQuotaInMB unsignedIntunsignedInt НеобязательноOptional 4000 МБ.4000 MB. Если указать значение, оно не должно превышать эту величину.If you provide a value, it must not exceed this amount Общий объем хранилища файловой системы, выделенный для всех буферов ведения журнала.The total amount of file system storage allocated for all logging buffers.

Элемент DiagnosticInfrastructureLogsDiagnosticInfrastructureLogs Element

Определяет конфигурацию буфера для журналов, которые создает базовая инфраструктура диагностики.Defines the buffer configuration for the logs that are generated by the underlying diagnostics infrastructure.

Родительский элемент: DiagnosticMonitorConfiguration.Parent Element: DiagnosticMonitorConfiguration Element.

Атрибуты:Attributes:

АтрибутAttribute ТипType ОписаниеDescription
bufferQuotaInMBbufferQuotaInMB unsignedIntunsignedInt необязательный параметр.Optional. Указывает максимальный объем хранилища файловой системы, который доступен для указанных данных.Specifies the maximum amount of file system storage that is available for the specified data.

Значение по умолчанию — 0.The default is 0.
scheduledTransferLogLevelFilterscheduledTransferLogLevelFilter строкаstring необязательный параметр.Optional. Указывает минимальный уровень серьезности для передаваемых записей журнала.Specifies the minimum severity level for log entries that are transferred. По умолчанию используется значение Undefined.The default value is Undefined. Другие возможные значения: Verbose, Information, Warning, Error и Critical.Other possible values are Verbose, Information, Warning, Error, and Critical.
scheduledTransferPeriodscheduledTransferPeriod длительностьduration необязательный параметр.Optional. Указывает интервал между запланированными передачами данных, округленный с точностью до ближайшей минуты.Specifies the interval between scheduled transfers of data, rounded up to the nearest minute.

По умолчанию используется значение PT0S.The default is PT0S.

Элемент LogsLogs Element

Определяет конфигурацию буфера для базовых журналов Azure.Defines the buffer configuration for basic Azure logs.

Родительский элемент: DiagnosticMonitorConfiguration.Parent element: DiagnosticMonitorConfiguration Element.

Атрибуты:Attributes:

АтрибутAttribute ТипType ОписаниеDescription
bufferQuotaInMBbufferQuotaInMB unsignedIntunsignedInt необязательный параметр.Optional. Указывает максимальный объем хранилища файловой системы, который доступен для указанных данных.Specifies the maximum amount of file system storage that is available for the specified data.

Значение по умолчанию — 0.The default is 0.
scheduledTransferLogLevelFilterscheduledTransferLogLevelFilter строкаstring необязательный параметр.Optional. Указывает минимальный уровень серьезности для передаваемых записей журнала.Specifies the minimum severity level for log entries that are transferred. По умолчанию используется значение Undefined.The default value is Undefined. Другие возможные значения: Verbose, Information, Warning, Error и Critical.Other possible values are Verbose, Information, Warning, Error, and Critical.
scheduledTransferPeriodscheduledTransferPeriod длительностьduration необязательный параметр.Optional. Указывает интервал между запланированными передачами данных, округленный с точностью до ближайшей минуты.Specifies the interval between scheduled transfers of data, rounded up to the nearest minute.

По умолчанию используется значение PT0S.The default is PT0S.

Элемент DirectoriesDirectories Element

Определяет конфигурацию буфера для журналов на основе файлов, которые можно определить.Defines the buffer configuration for file-based logs that you can define.

Родительский элемент: DiagnosticMonitorConfiguration.Parent element: DiagnosticMonitorConfiguration Element.

Атрибуты:Attributes:

АтрибутAttribute ТипType ОписаниеDescription
bufferQuotaInMBbufferQuotaInMB unsignedIntunsignedInt необязательный параметр.Optional. Указывает максимальный объем хранилища файловой системы, который доступен для указанных данных.Specifies the maximum amount of file system storage that is available for the specified data.

Значение по умолчанию — 0.The default is 0.
scheduledTransferPeriodscheduledTransferPeriod длительностьduration необязательный параметр.Optional. Указывает интервал между запланированными передачами данных, округленный с точностью до ближайшей минуты.Specifies the interval between scheduled transfers of data, rounded up to the nearest minute.

По умолчанию используется значение PT0S.The default is PT0S.

Элемент CrashDumpsCrashDumps Element

Определяет каталог аварийных дампов.Defines the crash dumps directory.

Родительский элемент: Directories.Parent Element: Directories Element.

Атрибуты:Attributes:

АтрибутAttribute ТипType ОписаниеDescription
containercontainer строкаstring Имя контейнера, в который будет передаваться содержимое каталога.The name of the container where the contents of the directory is to be transferred.
directoryQuotaInMBdirectoryQuotaInMB unsignedIntunsignedInt необязательный параметр.Optional. Определяет максимальный размер каталога в мегабайтах.Specifies the maximum size of the directory in megabytes.

Значение по умолчанию — 0.The default is 0.

Элемент FailedRequestLogsFailedRequestLogs Element

Определяет каталог журнала невыполненных запросов.Defines the failed request log directory.

Родительский элемент: Directories.Parent Element Directories Element.

Атрибуты:Attributes:

АтрибутAttribute ТипType ОписаниеDescription
containercontainer строкаstring Имя контейнера, в который будет передаваться содержимое каталога.The name of the container where the contents of the directory is to be transferred.
directoryQuotaInMBdirectoryQuotaInMB unsignedIntunsignedInt необязательный параметр.Optional. Определяет максимальный размер каталога в мегабайтах.Specifies the maximum size of the directory in megabytes.

Значение по умолчанию — 0.The default is 0.

Элемент IISLogsIISLogs Element

Определяет каталог журнала IIS.Defines the IIS log directory.

Родительский элемент: Directories.Parent Element Directories Element.

Атрибуты:Attributes:

АтрибутAttribute ТипType ОписаниеDescription
containercontainer строкаstring Имя контейнера, в который будет передаваться содержимое каталога.The name of the container where the contents of the directory is to be transferred.
directoryQuotaInMBdirectoryQuotaInMB unsignedIntunsignedInt необязательный параметр.Optional. Определяет максимальный размер каталога в мегабайтах.Specifies the maximum size of the directory in megabytes.

Значение по умолчанию — 0.The default is 0.

Элемент DataSourcesDataSources Element

Определяет ноль или более дополнительных каталогов журналов.Defines zero or more additional log directories.

Родительский элемент: Directories.Parent Element: Directories Element.

Элемент DirectoryConfigurationDirectoryConfiguration Element

Определяет каталог файлов журнала для отслеживания.Defines the directory of log files to monitor.

Родительский элемент: DataSources.Parent Element: DataSources Element.

Атрибуты:Attributes:

АтрибутAttribute ТипType ОписаниеDescription
containercontainer строкаstring Имя контейнера, в который будет передаваться содержимое каталога.The name of the container where the contents of the directory is to be transferred.
directoryQuotaInMBdirectoryQuotaInMB unsignedIntunsignedInt необязательный параметр.Optional. Определяет максимальный размер каталога в мегабайтах.Specifies the maximum size of the directory in megabytes.

Значение по умолчанию — 0.The default is 0.

Элемент AbsoluteAbsolute Element

Определяет абсолютный путь к отслеживаемому каталогу с необязательным раскрытием переменных среды.Defines an absolute path of the directory to monitor with optional environment expansion.

Родительский элемент: DirectoryConfiguration.Parent Element: DirectoryConfiguration Element.

Атрибуты:Attributes:

АтрибутAttribute ТипType ОписаниеDescription
pathpath строкаstring обязательный параметр.Required. Абсолютный путь к отслеживаемому каталогу.The absolute path to the directory to monitor.
expandEnvironmentexpandEnvironment Логическоеboolean обязательный параметр.Required. Если задано значение true, то переменные среды в пути раскрываются.If set to true, environment variables in the path are expanded.

Элемент LocalResourceLocalResource Element

Определяет путь относительно локального ресурса, заданного в определении службы.Defines a path relative to a local resource defined in the service definition.

Родительский элемент: DirectoryConfiguration.Parent Element: DirectoryConfiguration Element.

Атрибуты:Attributes:

АтрибутAttribute ТипType ОписаниеDescription
namename строкаstring обязательный параметр.Required. Имя локального ресурса, который содержит каталог для отслеживания.The name of the local resource that contains the directory to monitor.
relativePathrelativePath строкаstring обязательный параметр.Required. Путь относительно отслеживаемого локального ресурса.The path relative to the local resource to monitor.

Элемент PerformanceCountersPerformanceCounters Element

Определяет путь к счетчику производительности, данные которого будут собираться.Defines the path to the performance counter to collect.

Родительский элемент: DiagnosticMonitorConfiguration.Parent Element: DiagnosticMonitorConfiguration Element.

Атрибуты:Attributes:

АтрибутAttribute ТипType ОписаниеDescription
bufferQuotaInMBbufferQuotaInMB unsignedIntunsignedInt необязательный параметр.Optional. Указывает максимальный объем хранилища файловой системы, который доступен для указанных данных.Specifies the maximum amount of file system storage that is available for the specified data.

Значение по умолчанию — 0.The default is 0.
scheduledTransferPeriodscheduledTransferPeriod длительностьduration необязательный параметр.Optional. Указывает интервал между запланированными передачами данных, округленный с точностью до ближайшей минуты.Specifies the interval between scheduled transfers of data, rounded up to the nearest minute.

По умолчанию используется значение PT0S.The default is PT0S.

Элемент PerformanceCounterConfigurationPerformanceCounterConfiguration Element

Определяет счетчик производительности, данные которого будут собираться.Defines the performance counter to collect.

Родительский элемент: PerformanceCounters.Parent Element: PerformanceCounters Element.

Атрибуты:Attributes:

АтрибутAttribute ТипType ОписаниеDescription
counterSpecifiercounterSpecifier строкаstring обязательный параметр.Required. Путь к счетчику производительности, данные которого будут собираться.The path to the performance counter to collect.
sampleRatesampleRate длительностьduration обязательный параметр.Required. Частота сбора данных счетчика производительности.The rate at which the performance counter should be collected.

Элемент WindowsEventLogWindowsEventLog Element

Определяет журналы событий для отслеживания.Defines the event logs to monitor.

Родительский элемент: DiagnosticMonitorConfiguration.Parent Element: DiagnosticMonitorConfiguration Element.

Атрибуты:Attributes:

АтрибутAttribute ТипType ОписаниеDescription
bufferQuotaInMBbufferQuotaInMB unsignedIntunsignedInt необязательный параметр.Optional. Указывает максимальный объем хранилища файловой системы, который доступен для указанных данных.Specifies the maximum amount of file system storage that is available for the specified data.

Значение по умолчанию — 0.The default is 0.
scheduledTransferLogLevelFilterscheduledTransferLogLevelFilter строкаstring необязательный параметр.Optional. Указывает минимальный уровень серьезности для передаваемых записей журнала.Specifies the minimum severity level for log entries that are transferred. По умолчанию используется значение Undefined.The default value is Undefined. Другие возможные значения: Verbose, Information, Warning, Error и Critical.Other possible values are Verbose, Information, Warning, Error, and Critical.
scheduledTransferPeriodscheduledTransferPeriod длительностьduration необязательный параметр.Optional. Указывает интервал между запланированными передачами данных, округленный с точностью до ближайшей минуты.Specifies the interval between scheduled transfers of data, rounded up to the nearest minute.

По умолчанию используется значение PT0S.The default is PT0S.

Элемент DataSourceDataSource Element

Определяет журнал событий для отслеживания.Defines the event log to monitor.

Родительский элемент: WindowsEventLog.Parent Element: WindowsEventLog Element.

Атрибуты:Attributes:

АтрибутAttribute ТипType ОписаниеDescription
namename строкаstring обязательный параметр.Required. Выражение XPath, задающее журнал для сбора.An XPath expression specifying the log to collect.