Esquema de Configuração do Azure Diagnostics 1.0Azure Diagnostics 1.0 Configuration Schema

Observação

Diagnóstico do Azure é o componente usado para coletar contadores de desempenho e outras estatísticas de Máquinas Virtuais do Azure, Conjuntos de Escala de Máquina Virtual, Service Fabric e Serviços de Nuvem.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. Esta página só é relevante se você estiver usando um desses serviços.This page is only relevant if you are using one of these services.

O Diagnóstico do Azure é usado com outros produtos de diagnóstico da Microsoft, como Azure Monitor, Application Insights e Log Analytics.Azure Diagnostics is used with other Microsoft diagnostics products like Azure Monitor, Application Insights, and Log Analytics.

O arquivo de configuração do Diagnóstico do Azure define os valores que são usados para inicializar o Monitor de Diagnóstico.The Azure Diagnostics configuration file defines values that are used to initialize the Diagnostics Monitor. Esse arquivo é usado para inicializar as definições de configuração de diagnóstico quando o monitor de diagnóstico é iniciado.This file is used to initialize diagnostic configuration settings when the diagnostics monitor starts.

Por padrão, o arquivo de esquema de configuração do Diagnóstico do Azure é instalado no diretório 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. Substitua <version> pela versão instalada do SDK do Azure.Replace <version> with the installed version of the Azure SDK.

Observação

O arquivo de configuração de diagnóstico é normalmente usado com tarefas de inicialização que exigem a coleta prévia de dados de diagnóstico no processo de inicialização.The diagnostics configuration file is typically used with startup tasks that require diagnostic data to be collected earlier in the startup process. Para obter mais informações sobre como usar o Diagnóstico do Azure, consulte Coletar dados do log usando o Diagnóstico do Azure.For more information about using Azure Diagnostics, see Collect Logging Data by Using Azure Diagnostics.

Exemplo do arquivo de configuração de diagnósticoExample of the diagnostics configuration file

O exemplo a seguir mostra um arquivo de configuração de diagnóstico típico: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>  

Namespace DiagnosticsConfigurationDiagnosticsConfiguration Namespace

O namespace XML para o arquivo de configuração de diagnóstico é:The XML namespace for the diagnostics configuration file is:

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

Elementos de esquemaSchema Elements

O arquivo de configuração de diagnóstico inclui os elementos a seguir.The diagnostics configuration file includes the following elements.

Elemento DiagnosticMonitorConfigurationDiagnosticMonitorConfiguration Element

O elemento de nível superior do arquivo de configuração de diagnóstico.The top-level element of the diagnostics configuration file.

Atributos:Attributes:

AtributoAttribute TipoType ObrigatórioRequired PadrãoDefault DescriçãoDescription
configurationChangePollIntervalconfigurationChangePollInterval durationduration OpcionalOptional PT1MPT1M Especifica o intervalo no qual o monitor de diagnóstico sonda em busca de alterações de configuração de diagnóstico.Specifies the interval at which the diagnostic monitor polls for diagnostic configuration changes.
overallQuotaInMBoverallQuotaInMB unsignedIntunsignedInt OpcionalOptional 4000 MB.4000 MB. Se você fornecer um valor, ele não deverá exceder esse valorIf you provide a value, it must not exceed this amount A quantidade total de armazenamento de sistema de arquivos alocado para todos os buffers de registro em log.The total amount of file system storage allocated for all logging buffers.

Elemento DiagnosticInfrastructureLogsDiagnosticInfrastructureLogs Element

Define a configuração de buffer para os logs gerados pela infraestrutura de diagnóstico subjacente.Defines the buffer configuration for the logs that are generated by the underlying diagnostics infrastructure.

Elemento pai: elemento DiagnosticMonitorConfiguration.Parent Element: DiagnosticMonitorConfiguration Element.

Atributos:Attributes:

AtributoAttribute TipoType DescriçãoDescription
bufferQuotaInMBbufferQuotaInMB unsignedIntunsignedInt Opcional.Optional. Especifica a quantidade máxima de armazenamento do sistema de arquivos disponível para os dados especificados.Specifies the maximum amount of file system storage that is available for the specified data.

O padrão é 0.The default is 0.
scheduledTransferLogLevelFilterscheduledTransferLogLevelFilter stringstring Opcional.Optional. Especifica o nível de severidade mínimo para as entradas de log transferidas.Specifies the minimum severity level for log entries that are transferred. O valor padrão é Indefinido.The default value is Undefined. Outros possíveis valores são Detalhado, Informação, Aviso, Erro e Crítico.Other possible values are Verbose, Information, Warning, Error, and Critical.
scheduledTransferPeriodscheduledTransferPeriod durationduration Opcional.Optional. Especifica o intervalo entre as transferências agendadas de dados, arredondado para o minuto mais próximo.Specifies the interval between scheduled transfers of data, rounded up to the nearest minute.

O padrão é PT0S.The default is PT0S.

Elemento LogsLogs Element

Define a configuração de buffer para logs básicos do Azure.Defines the buffer configuration for basic Azure logs.

Elemento pai: elemento DiagnosticMonitorConfiguration.Parent element: DiagnosticMonitorConfiguration Element.

Atributos:Attributes:

AtributoAttribute TipoType DescriçãoDescription
bufferQuotaInMBbufferQuotaInMB unsignedIntunsignedInt Opcional.Optional. Especifica a quantidade máxima de armazenamento do sistema de arquivos disponível para os dados especificados.Specifies the maximum amount of file system storage that is available for the specified data.

O padrão é 0.The default is 0.
scheduledTransferLogLevelFilterscheduledTransferLogLevelFilter stringstring Opcional.Optional. Especifica o nível de severidade mínimo para as entradas de log transferidas.Specifies the minimum severity level for log entries that are transferred. O valor padrão é Indefinido.The default value is Undefined. Outros possíveis valores são Detalhado, Informação, Aviso, Erro e Crítico.Other possible values are Verbose, Information, Warning, Error, and Critical.
scheduledTransferPeriodscheduledTransferPeriod durationduration Opcional.Optional. Especifica o intervalo entre as transferências agendadas de dados, arredondado para o minuto mais próximo.Specifies the interval between scheduled transfers of data, rounded up to the nearest minute.

O padrão é PT0S.The default is PT0S.

Elemento DirectoriesDirectories Element

Define a configuração de buffer para logs baseados em arquivo que você pode definir.Defines the buffer configuration for file-based logs that you can define.

Elemento pai: elemento DiagnosticMonitorConfiguration.Parent element: DiagnosticMonitorConfiguration Element.

Atributos:Attributes:

AtributoAttribute TipoType DescriçãoDescription
bufferQuotaInMBbufferQuotaInMB unsignedIntunsignedInt Opcional.Optional. Especifica a quantidade máxima de armazenamento do sistema de arquivos disponível para os dados especificados.Specifies the maximum amount of file system storage that is available for the specified data.

O padrão é 0.The default is 0.
scheduledTransferPeriodscheduledTransferPeriod durationduration Opcional.Optional. Especifica o intervalo entre as transferências agendadas de dados, arredondado para o minuto mais próximo.Specifies the interval between scheduled transfers of data, rounded up to the nearest minute.

O padrão é PT0S.The default is PT0S.

Elemento CrashDumpsCrashDumps Element

Define o diretório de despejos de falha.Defines the crash dumps directory.

Elemento pai: elemento Directories.Parent Element: Directories Element.

Atributos:Attributes:

AtributoAttribute TipoType DescriçãoDescription
contêinercontainer stringstring O nome do contêiner para onde o conteúdo do diretório será transferido.The name of the container where the contents of the directory is to be transferred.
directoryQuotaInMBdirectoryQuotaInMB unsignedIntunsignedInt Opcional.Optional. Especifica o tamanho máximo do diretório em megabytes.Specifies the maximum size of the directory in megabytes.

O padrão é 0.The default is 0.

Elemento FailedRequestLogsFailedRequestLogs Element

Define o diretório de log de solicitação com falha.Defines the failed request log directory.

Elemento pai elemento Directories.Parent Element Directories Element.

Atributos:Attributes:

AtributoAttribute TipoType DescriçãoDescription
contêinercontainer stringstring O nome do contêiner para onde o conteúdo do diretório será transferido.The name of the container where the contents of the directory is to be transferred.
directoryQuotaInMBdirectoryQuotaInMB unsignedIntunsignedInt Opcional.Optional. Especifica o tamanho máximo do diretório em megabytes.Specifies the maximum size of the directory in megabytes.

O padrão é 0.The default is 0.

Elemento IISLogsIISLogs Element

Define o diretório de log do IIS.Defines the IIS log directory.

Elemento pai elemento Directories.Parent Element Directories Element.

Atributos:Attributes:

AtributoAttribute TipoType DescriçãoDescription
contêinercontainer stringstring O nome do contêiner para onde o conteúdo do diretório será transferido.The name of the container where the contents of the directory is to be transferred.
directoryQuotaInMBdirectoryQuotaInMB unsignedIntunsignedInt Opcional.Optional. Especifica o tamanho máximo do diretório em megabytes.Specifies the maximum size of the directory in megabytes.

O padrão é 0.The default is 0.

Elemento DataSourcesDataSources Element

Define zero ou mais diretórios de log adicionais.Defines zero or more additional log directories.

Elemento pai: elemento Directories.Parent Element: Directories Element.

Elemento DirectoryConfigurationDirectoryConfiguration Element

Define o diretório de arquivos de log a ser monitorado.Defines the directory of log files to monitor.

Elemento pai: elemento DataSources.Parent Element: DataSources Element.

Atributos:Attributes:

AtributoAttribute TipoType DescriçãoDescription
contêinercontainer stringstring O nome do contêiner para onde o conteúdo do diretório será transferido.The name of the container where the contents of the directory is to be transferred.
directoryQuotaInMBdirectoryQuotaInMB unsignedIntunsignedInt Opcional.Optional. Especifica o tamanho máximo do diretório em megabytes.Specifies the maximum size of the directory in megabytes.

O padrão é 0.The default is 0.

Elemento AbsoluteAbsolute Element

Define um caminho absoluto do diretório a ser monitorado com opção de expansão de ambiente.Defines an absolute path of the directory to monitor with optional environment expansion.

Elemento pai: elemento DirectoryConfiguration.Parent Element: DirectoryConfiguration Element.

Atributos:Attributes:

AtributoAttribute TipoType DescriçãoDescription
pathpath stringstring Obrigatório.Required. O caminho absoluto para o diretório a ser monitorado.The absolute path to the directory to monitor.
expandEnvironmentexpandEnvironment Boolianoboolean Obrigatório.Required. Se definido como true, as variáveis de ambiente no caminho serão expandidas.If set to true, environment variables in the path are expanded.

Elemento LocalResourceLocalResource Element

Define um caminho relativo para um recurso local indicado na definição do serviço.Defines a path relative to a local resource defined in the service definition.

Elemento pai: elemento DirectoryConfiguration.Parent Element: DirectoryConfiguration Element.

Atributos:Attributes:

AtributoAttribute TipoType DescriçãoDescription
namename stringstring Obrigatório.Required. O nome do recurso local que contém o diretório a ser monitorado.The name of the local resource that contains the directory to monitor.
relativePathrelativePath stringstring Obrigatório.Required. O caminho relativo a um recurso local a ser monitorado.The path relative to the local resource to monitor.

Elemento PerformanceCountersPerformanceCounters Element

Define o caminho para coleta do contador de desempenho.Defines the path to the performance counter to collect.

Elemento pai: elemento DiagnosticMonitorConfiguration.Parent Element: DiagnosticMonitorConfiguration Element.

Atributos:Attributes:

AtributoAttribute TipoType DescriçãoDescription
bufferQuotaInMBbufferQuotaInMB unsignedIntunsignedInt Opcional.Optional. Especifica a quantidade máxima de armazenamento do sistema de arquivos disponível para os dados especificados.Specifies the maximum amount of file system storage that is available for the specified data.

O padrão é 0.The default is 0.
scheduledTransferPeriodscheduledTransferPeriod durationduration Opcional.Optional. Especifica o intervalo entre as transferências agendadas de dados, arredondado para o minuto mais próximo.Specifies the interval between scheduled transfers of data, rounded up to the nearest minute.

O padrão é PT0S.The default is PT0S.

Elemento PerformanceCounterConfigurationPerformanceCounterConfiguration Element

Define o contador de desempenho a ser coletado.Defines the performance counter to collect.

Elemento pai: elemento PerformanceCounters.Parent Element: PerformanceCounters Element.

Atributos:Attributes:

AtributoAttribute TipoType DescriçãoDescription
counterSpecifiercounterSpecifier stringstring Obrigatório.Required. O caminho para coleta do contador de desempenho.The path to the performance counter to collect.
sampleRatesampleRate durationduration Obrigatório.Required. A taxa de coleta do contador de desempenho.The rate at which the performance counter should be collected.

Elemento WindowsEventLogWindowsEventLog Element

Define os logs de eventos a serem monitorados.Defines the event logs to monitor.

Elemento pai: elemento DiagnosticMonitorConfiguration.Parent Element: DiagnosticMonitorConfiguration Element.

Atributos:Attributes:

AtributoAttribute TipoType DescriçãoDescription
bufferQuotaInMBbufferQuotaInMB unsignedIntunsignedInt Opcional.Optional. Especifica a quantidade máxima de armazenamento do sistema de arquivos disponível para os dados especificados.Specifies the maximum amount of file system storage that is available for the specified data.

O padrão é 0.The default is 0.
scheduledTransferLogLevelFilterscheduledTransferLogLevelFilter stringstring Opcional.Optional. Especifica o nível de severidade mínimo para as entradas de log transferidas.Specifies the minimum severity level for log entries that are transferred. O valor padrão é Indefinido.The default value is Undefined. Outros possíveis valores são Detalhado, Informação, Aviso, Erro e Crítico.Other possible values are Verbose, Information, Warning, Error, and Critical.
scheduledTransferPeriodscheduledTransferPeriod durationduration Opcional.Optional. Especifica o intervalo entre as transferências agendadas de dados, arredondado para o minuto mais próximo.Specifies the interval between scheduled transfers of data, rounded up to the nearest minute.

O padrão é PT0S.The default is PT0S.

Elemento DataSourceDataSource Element

Define o log de eventos a ser monitorado.Defines the event log to monitor.

Elemento pai: elemento WindowsEventLog.Parent Element: WindowsEventLog Element.

Atributos:Attributes:

AtributoAttribute TipoType DescriçãoDescription
namename stringstring Obrigatório.Required. Uma expressão XPath que especifica o log para coleta.An XPath expression specifying the log to collect.