Schema di configurazione di Diagnostica di Azure 1.0Azure Diagnostics 1.0 Configuration Schema

Nota

Diagnostica di Azure è il componente usato per raccogliere i contatori delle prestazioni e altre statistiche da Macchine virtuali, set di scalabilità di macchine virtuali, Service Fabric e Servizi cloud di Azure.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. Questa pagina è utile solo se si usa uno di questi servizi.This page is only relevant if you are using one of these services.

Lo strumento Diagnostica di Azure viene usato con altri prodotti di diagnostica Microsoft, quali Monitoraggio di Azure, Application Insights e Log Analytics.Azure Diagnostics is used with other Microsoft diagnostics products like Azure Monitor, Application Insights, and Log Analytics.

Il file di configurazione di Diagnostica di Azure definisce i valori usati per inizializzare il monitor di diagnostica.The Azure Diagnostics configuration file defines values that are used to initialize the Diagnostics Monitor. Il file viene usato per inizializzare le impostazioni di diagnostica quando viene avviato il monitor di diagnostica.This file is used to initialize diagnostic configuration settings when the diagnostics monitor starts.

Per impostazione predefinita, il file dello schema di configurazione di Diagnostica di Azure viene installato nella directory 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. Sostituire <version> con la versione installata di Azure SDK.Replace <version> with the installed version of the Azure SDK.

Nota

Il file di configurazione della diagnostica viene generalmente usato con le attività di avvio che richiedono la raccolta dei dati di diagnostica in una fase precedente del processo di avvio.The diagnostics configuration file is typically used with startup tasks that require diagnostic data to be collected earlier in the startup process. Per altre informazioni sull'uso di Diagnostica di Azure, vedere Raccogliere dati di registrazione usando Diagnostica di Azure.For more information about using Azure Diagnostics, see Collect Logging Data by Using Azure Diagnostics.

Esempio del file di configurazione della diagnosticaExample of the diagnostics configuration file

L'esempio seguente illustra un tipico file di configurazione della diagnostica: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>  

Spazio dei nomi DiagnosticsConfigurationDiagnosticsConfiguration Namespace

Lo spazio dei nomi XML per il file di configurazione della diagnostica è il seguente:The XML namespace for the diagnostics configuration file is:

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

Elementi dello schemaSchema Elements

Il file di configurazione della diagnostica include gli elementi seguenti.The diagnostics configuration file includes the following elements.

Elemento DiagnosticMonitorConfigurationDiagnosticMonitorConfiguration Element

Elemento di livello superiore del file di configurazione della diagnostica.The top-level element of the diagnostics configuration file.

Attributi:Attributes:

AttributoAttribute TypeType ObbligatorioRequired DefaultDefault DescrizioneDescription
configurationChangePollIntervalconfigurationChangePollInterval durationduration FacoltativoOptional PT1MPT1M Specifica l'intervallo con cui il monitor di diagnostica esegue il polling per le modifiche della configurazione di diagnostica.Specifies the interval at which the diagnostic monitor polls for diagnostic configuration changes.
overallQuotaInMBoverallQuotaInMB unsignedIntunsignedInt FacoltativoOptional 4000 MB.4000 MB. Se si specifica un valore, non deve superare la quantitàIf you provide a value, it must not exceed this amount Spazio totale di archiviazione del file system allocato per tutti i buffer di registrazione.The total amount of file system storage allocated for all logging buffers.

Elemento DiagnosticInfrastructureLogsDiagnosticInfrastructureLogs Element

Definisce la configurazione del buffer per i log generati dall'infrastruttura di diagnostica sottostante.Defines the buffer configuration for the logs that are generated by the underlying diagnostics infrastructure.

Elemento padre: elemento DiagnosticMonitorConfiguration.Parent Element: DiagnosticMonitorConfiguration Element.

Attributi:Attributes:

AttributoAttribute TipoType DescrizioneDescription
bufferQuotaInMBbufferQuotaInMB unsignedIntunsignedInt Facoltativa.Optional. Specifica lo spazio massimo di archiviazione del file system disponibile per i dati specificati.Specifies the maximum amount of file system storage that is available for the specified data.

Il valore predefinito è 0.The default is 0.
scheduledTransferLogLevelFilterscheduledTransferLogLevelFilter stringstring Facoltativa.Optional. Specifica il livello di gravità minimo per le voci di log trasferite.Specifies the minimum severity level for log entries that are transferred. Il valore predefinito è Non definito.The default value is Undefined. Altri valori possibili sono Dettagli, Informazioni, Avviso, Errore e Critico.Other possible values are Verbose, Information, Warning, Error, and Critical.
scheduledTransferPeriodscheduledTransferPeriod durationduration Facoltativa.Optional. Specifica l'intervallo tra trasferimenti di dati pianificati, arrotondato per eccesso al minuto più vicino.Specifies the interval between scheduled transfers of data, rounded up to the nearest minute.

Il valore predefinito è PT0S.The default is PT0S.

Elemento LogsLogs Element

Definisce la configurazione del buffer per i log di base di Azure.Defines the buffer configuration for basic Azure logs.

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

Attributi:Attributes:

AttributoAttribute TipoType DescrizioneDescription
bufferQuotaInMBbufferQuotaInMB unsignedIntunsignedInt Facoltativa.Optional. Specifica lo spazio massimo di archiviazione del file system disponibile per i dati specificati.Specifies the maximum amount of file system storage that is available for the specified data.

Il valore predefinito è 0.The default is 0.
scheduledTransferLogLevelFilterscheduledTransferLogLevelFilter stringstring Facoltativa.Optional. Specifica il livello di gravità minimo per le voci di log trasferite.Specifies the minimum severity level for log entries that are transferred. Il valore predefinito è Non definito.The default value is Undefined. Altri valori possibili sono Dettagli, Informazioni, Avviso, Errore e Critico.Other possible values are Verbose, Information, Warning, Error, and Critical.
scheduledTransferPeriodscheduledTransferPeriod durationduration Facoltativa.Optional. Specifica l'intervallo tra trasferimenti di dati pianificati, arrotondato per eccesso al minuto più vicino.Specifies the interval between scheduled transfers of data, rounded up to the nearest minute.

Il valore predefinito è PT0S.The default is PT0S.

Elemento DirectoriesDirectories Element

Definisce la configurazione del buffer per i log basati su file che è possibile definire.Defines the buffer configuration for file-based logs that you can define.

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

Attributi:Attributes:

AttributoAttribute TipoType DescrizioneDescription
bufferQuotaInMBbufferQuotaInMB unsignedIntunsignedInt Facoltativa.Optional. Specifica lo spazio massimo di archiviazione del file system disponibile per i dati specificati.Specifies the maximum amount of file system storage that is available for the specified data.

Il valore predefinito è 0.The default is 0.
scheduledTransferPeriodscheduledTransferPeriod durationduration Facoltativa.Optional. Specifica l'intervallo tra trasferimenti di dati pianificati, arrotondato per eccesso al minuto più vicino.Specifies the interval between scheduled transfers of data, rounded up to the nearest minute.

Il valore predefinito è PT0S.The default is PT0S.

Elemento CrashDumpsCrashDumps Element

Definisce la directory dei dump di arresto anomalo del sistema.Defines the crash dumps directory.

Elemento padre: elemento Directories.Parent Element: Directories Element.

Attributi:Attributes:

AttributoAttribute TipoType DescrizioneDescription
containercontainer stringstring Nome del contenitore in cui dovrà essere trasferito il contenuto della directory.The name of the container where the contents of the directory is to be transferred.
directoryQuotaInMBdirectoryQuotaInMB unsignedIntunsignedInt Facoltativa.Optional. Specifica le dimensioni massime della directory in MB.Specifies the maximum size of the directory in megabytes.

Il valore predefinito è 0.The default is 0.

Elemento FailedRequestLogsFailedRequestLogs Element

Definisce la directory dei log di richieste non riuscite.Defines the failed request log directory.

Elemento padre: elemento Directories.Parent Element Directories Element.

Attributi:Attributes:

AttributoAttribute TipoType DescrizioneDescription
containercontainer stringstring Nome del contenitore in cui dovrà essere trasferito il contenuto della directory.The name of the container where the contents of the directory is to be transferred.
directoryQuotaInMBdirectoryQuotaInMB unsignedIntunsignedInt Facoltativa.Optional. Specifica le dimensioni massime della directory in MB.Specifies the maximum size of the directory in megabytes.

Il valore predefinito è 0.The default is 0.

Elemento IISLogsIISLogs Element

Definisce la directory di log IIS.Defines the IIS log directory.

Elemento padre: elemento Directories.Parent Element Directories Element.

Attributi:Attributes:

AttributoAttribute TipoType DescrizioneDescription
containercontainer stringstring Nome del contenitore in cui dovrà essere trasferito il contenuto della directory.The name of the container where the contents of the directory is to be transferred.
directoryQuotaInMBdirectoryQuotaInMB unsignedIntunsignedInt Facoltativa.Optional. Specifica le dimensioni massime della directory in MB.Specifies the maximum size of the directory in megabytes.

Il valore predefinito è 0.The default is 0.

Elemento DataSourcesDataSources Element

Definisce zero o più directory di log aggiuntivi.Defines zero or more additional log directories.

Elemento padre: elemento Directories.Parent Element: Directories Element.

Elemento DirectoryConfigurationDirectoryConfiguration Element

Definisce la directory di file di log da monitorare.Defines the directory of log files to monitor.

Elemento padre: elemento DataSources.Parent Element: DataSources Element.

Attributi:Attributes:

AttributoAttribute TipoType DescrizioneDescription
containercontainer stringstring Nome del contenitore in cui dovrà essere trasferito il contenuto della directory.The name of the container where the contents of the directory is to be transferred.
directoryQuotaInMBdirectoryQuotaInMB unsignedIntunsignedInt Facoltativa.Optional. Specifica le dimensioni massime della directory in MB.Specifies the maximum size of the directory in megabytes.

Il valore predefinito è 0.The default is 0.

Elemento AbsoluteAbsolute Element

Definisce un percorso assoluto della directory da monitorare con espansione dell'ambiente facoltativa.Defines an absolute path of the directory to monitor with optional environment expansion.

Elemento padre: elemento DirectoryConfiguration.Parent Element: DirectoryConfiguration Element.

Attributi:Attributes:

AttributoAttribute TipoType DescrizioneDescription
pathpath stringstring Obbligatorio.Required. Percorso assoluto della directory da monitorare.The absolute path to the directory to monitor.
expandEnvironmentexpandEnvironment booleanboolean Obbligatorio.Required. Se impostato su true, le variabili di ambiente nel percorso verranno espanse.If set to true, environment variables in the path are expanded.

Elemento LocalResourceLocalResource Element

Definisce un percorso relativo a una risorsa locale nella definizione del servizio.Defines a path relative to a local resource defined in the service definition.

Elemento padre: elemento DirectoryConfiguration.Parent Element: DirectoryConfiguration Element.

Attributi:Attributes:

AttributoAttribute TipoType DescrizioneDescription
nomename stringstring Obbligatorio.Required. Nome della risorsa locale che contiene la directory da monitorare.The name of the local resource that contains the directory to monitor.
relativePathrelativePath stringstring Obbligatorio.Required. Percorso relativo della risorsa locale da monitorare.The path relative to the local resource to monitor.

Elemento PerformanceCountersPerformanceCounters Element

Definisce il percorso del contatore delle prestazioni da raccogliere.Defines the path to the performance counter to collect.

Elemento padre: elemento DiagnosticMonitorConfiguration.Parent Element: DiagnosticMonitorConfiguration Element.

Attributi:Attributes:

AttributoAttribute TipoType DescrizioneDescription
bufferQuotaInMBbufferQuotaInMB unsignedIntunsignedInt Facoltativa.Optional. Specifica lo spazio massimo di archiviazione del file system disponibile per i dati specificati.Specifies the maximum amount of file system storage that is available for the specified data.

Il valore predefinito è 0.The default is 0.
scheduledTransferPeriodscheduledTransferPeriod durationduration Facoltativa.Optional. Specifica l'intervallo tra trasferimenti di dati pianificati, arrotondato per eccesso al minuto più vicino.Specifies the interval between scheduled transfers of data, rounded up to the nearest minute.

Il valore predefinito è PT0S.The default is PT0S.

Elemento PerformanceCounterConfigurationPerformanceCounterConfiguration Element

Definisce il contatore delle prestazioni da raccogliere.Defines the performance counter to collect.

Elemento principale: PerformanceCounters Element.Parent Element: PerformanceCounters Element.

Attributi:Attributes:

AttributoAttribute TipoType DescrizioneDescription
counterSpecifiercounterSpecifier stringstring Obbligatorio.Required. Percorso del contatore delle prestazioni da raccogliere.The path to the performance counter to collect.
sampleRatesampleRate durationduration Obbligatorio.Required. Frequenza con la quale raccogliere il contatore delle prestazioni.The rate at which the performance counter should be collected.

Elemento WindowsEventLogWindowsEventLog Element

Definisce i registri eventi da monitorare.Defines the event logs to monitor.

Elemento padre: elemento DiagnosticMonitorConfiguration.Parent Element: DiagnosticMonitorConfiguration Element.

Attributi:Attributes:

AttributoAttribute TipoType DescrizioneDescription
bufferQuotaInMBbufferQuotaInMB unsignedIntunsignedInt Facoltativa.Optional. Specifica lo spazio massimo di archiviazione del file system disponibile per i dati specificati.Specifies the maximum amount of file system storage that is available for the specified data.

Il valore predefinito è 0.The default is 0.
scheduledTransferLogLevelFilterscheduledTransferLogLevelFilter stringstring Facoltativa.Optional. Specifica il livello di gravità minimo per le voci di log trasferite.Specifies the minimum severity level for log entries that are transferred. Il valore predefinito è Non definito.The default value is Undefined. Altri valori possibili sono Dettagli, Informazioni, Avviso, Errore e Critico.Other possible values are Verbose, Information, Warning, Error, and Critical.
scheduledTransferPeriodscheduledTransferPeriod durationduration Facoltativa.Optional. Specifica l'intervallo tra trasferimenti di dati pianificati, arrotondato per eccesso al minuto più vicino.Specifies the interval between scheduled transfers of data, rounded up to the nearest minute.

Il valore predefinito è PT0S.The default is PT0S.

Elemento DataSourceDataSource Element

Definisce il registro eventi da monitorare.Defines the event log to monitor.

Elemento principale: elemento WindowsEventLog.Parent Element: WindowsEventLog Element.

Attributi:Attributes:

AttributoAttribute TipoType DescrizioneDescription
nomename stringstring Obbligatorio.Required. Espressione XPath che specifica il log da raccogliere.An XPath expression specifying the log to collect.