Schéma de configuration Azure Diagnostics 1.0Azure Diagnostics 1.0 Configuration Schema

Note

Azure Diagnostics est le composant utilisé pour collecter les compteurs de performances et d’autres statistiques d’Azure Virtual Machines, de Virtual Machine Scale Sets, de Service Fabric et de Cloud Services.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. Cette page vous concerne uniquement si vous utilisez l’un de ces services.This page is only relevant if you are using one of these services.

Azure Diagnostics est utilisé avec d’autres produits de diagnostic Microsoft tels que Azure Monitor, Application Insights et Log Analytics.Azure Diagnostics is used with other Microsoft diagnostics products like Azure Monitor, Application Insights, and Log Analytics.

Le fichier de configuration Azure Diagnostics définit les valeurs qui sont utilisées pour initialiser le moniteur de diagnostics.The Azure Diagnostics configuration file defines values that are used to initialize the Diagnostics Monitor. Ce fichier est utilisé pour initialiser les paramètres de configuration de diagnostic lorsque le moniteur de diagnostic démarre.This file is used to initialize diagnostic configuration settings when the diagnostics monitor starts.

Par défaut, le fichier de schéma de configuration Azure Diagnostics est installé dans le répertoire 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. Remplacez <version> par la version installée du Kit de développement logiciel (SDK) Azure.Replace <version> with the installed version of the Azure SDK.

Note

Le fichier de configuration de diagnostic est généralement utilisé avec les tâches de démarrage qui requièrent la collecte de données de diagnostic au début du processus de démarrage.The diagnostics configuration file is typically used with startup tasks that require diagnostic data to be collected earlier in the startup process. Pour plus d’informations sur l’utilisation d’Azure Diagnostics, consultez Collect Logging Data by Using Azure Diagnostics (Collecte de données de journalisation à l’aide d’Azure Diagnostics).For more information about using Azure Diagnostics, see Collect Logging Data by Using Azure Diagnostics.

Exemple du fichier de configuration des diagnosticsExample of the diagnostics configuration file

L’exemple suivant montre un fichier de configuration de diagnostic standard :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>  

Espace de noms DiagnosticsConfigurationDiagnosticsConfiguration Namespace

L’espace de noms XML du fichier de configuration des diagnostics est :The XML namespace for the diagnostics configuration file is:

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

Éléments du schémaSchema Elements

Le fichier de configuration de diagnostic inclut les éléments suivants.The diagnostics configuration file includes the following elements.

Élément DiagnosticMonitorConfigurationDiagnosticMonitorConfiguration Element

Élément de niveau supérieur du fichier de configuration de diagnostic.The top-level element of the diagnostics configuration file.

Attributs :Attributes:

AttributAttribute TypeType RequisRequired DefaultDefault DescriptionDescription
configurationChangePollIntervalconfigurationChangePollInterval durationduration FacultatifOptional PT1MPT1M Spécifie l’intervalle auquel le moniteur de diagnostic s’enquiert des modifications de configuration de diagnostic.Specifies the interval at which the diagnostic monitor polls for diagnostic configuration changes.
overallQuotaInMBoverallQuotaInMB unsignedIntunsignedInt FacultatifOptional 4 000 Mo.4000 MB. La valeur indiquée ne doit pas dépasser ce montantIf you provide a value, it must not exceed this amount Quantité totale de stockage du système de fichiers allouée pour la journalisation de toutes les mémoires tampons.The total amount of file system storage allocated for all logging buffers.

Élément DiagnosticInfrastructureLogsDiagnosticInfrastructureLogs Element

Définit la configuration de la mémoire tampon pour les journaux générés par l’infrastructure de diagnostic sous-jacente.Defines the buffer configuration for the logs that are generated by the underlying diagnostics infrastructure.

Élément parent : Élément DiagnosticMonitorConfiguration.Parent Element: DiagnosticMonitorConfiguration Element.

Attributs :Attributes:

AttributAttribute TypeType DescriptionDescription
bufferQuotaInMBbufferQuotaInMB unsignedIntunsignedInt facultatif.Optional. Définit la quantité maximale de stockage du système de fichiers disponible pour les données spécifiées.Specifies the maximum amount of file system storage that is available for the specified data.

La valeur par défaut est 0.The default is 0.
scheduledTransferLogLevelFilterscheduledTransferLogLevelFilter stringstring facultatif.Optional. Définit le niveau de gravité minimal des entrées de journal transférées.Specifies the minimum severity level for log entries that are transferred. La valeur par défaut est Non défini.The default value is Undefined. Les autres valeurs possibles sont Détaillé, Informations, Avertissement, Erreur, et Critique.Other possible values are Verbose, Information, Warning, Error, and Critical.
scheduledTransferPeriodscheduledTransferPeriod durationduration facultatif.Optional. Définit l’intervalle entre les transferts planifiés de données, arrondi à la minute la plus proche.Specifies the interval between scheduled transfers of data, rounded up to the nearest minute.

La valeur par défaut est PT0S.The default is PT0S.

Élément LogsLogs Element

Définit la configuration de la mémoire tampon des journaux Azure de base.Defines the buffer configuration for basic Azure logs.

Élément parent : Élément DiagnosticMonitorConfiguration.Parent element: DiagnosticMonitorConfiguration Element.

Attributs :Attributes:

AttributAttribute TypeType DescriptionDescription
bufferQuotaInMBbufferQuotaInMB unsignedIntunsignedInt facultatif.Optional. Définit la quantité maximale de stockage du système de fichiers disponible pour les données spécifiées.Specifies the maximum amount of file system storage that is available for the specified data.

La valeur par défaut est 0.The default is 0.
scheduledTransferLogLevelFilterscheduledTransferLogLevelFilter stringstring facultatif.Optional. Définit le niveau de gravité minimal des entrées de journal transférées.Specifies the minimum severity level for log entries that are transferred. La valeur par défaut est Non défini.The default value is Undefined. Les autres valeurs possibles sont Détaillé, Informations, Avertissement, Erreur, et Critique.Other possible values are Verbose, Information, Warning, Error, and Critical.
scheduledTransferPeriodscheduledTransferPeriod durationduration facultatif.Optional. Définit l’intervalle entre les transferts planifiés de données, arrondi à la minute la plus proche.Specifies the interval between scheduled transfers of data, rounded up to the nearest minute.

La valeur par défaut est PT0S.The default is PT0S.

Élément DirectoriesDirectories Element

Définit la configuration de la mémoire tampon pour les journaux basés sur des fichiers que vous pouvez définir.Defines the buffer configuration for file-based logs that you can define.

Élément parent : Élément DiagnosticMonitorConfiguration.Parent element: DiagnosticMonitorConfiguration Element.

Attributs :Attributes:

AttributAttribute TypeType DescriptionDescription
bufferQuotaInMBbufferQuotaInMB unsignedIntunsignedInt facultatif.Optional. Définit la quantité maximale de stockage du système de fichiers disponible pour les données spécifiées.Specifies the maximum amount of file system storage that is available for the specified data.

La valeur par défaut est 0.The default is 0.
scheduledTransferPeriodscheduledTransferPeriod durationduration facultatif.Optional. Définit l’intervalle entre les transferts planifiés de données, arrondi à la minute la plus proche.Specifies the interval between scheduled transfers of data, rounded up to the nearest minute.

La valeur par défaut est PT0S.The default is PT0S.

Élément CrashDumpsCrashDumps Element

Définit le répertoire de vidages sur incident.Defines the crash dumps directory.

Élément parent : élément Directories.Parent Element: Directories Element.

Attributs :Attributes:

AttributAttribute TypeType DescriptionDescription
containercontainer stringstring Nom du conteneur dans lequel le contenu du répertoire doit être transféré.The name of the container where the contents of the directory is to be transferred.
directoryQuotaInMBdirectoryQuotaInMB unsignedIntunsignedInt facultatif.Optional. Définit la taille maximale du répertoire en mégaoctets.Specifies the maximum size of the directory in megabytes.

La valeur par défaut est 0.The default is 0.

Élément FailedRequestLogsFailedRequestLogs Element

Définit le répertoire de journaux des demandes ayant échoué.Defines the failed request log directory.

Élément parent : élément Directories.Parent Element Directories Element.

Attributs :Attributes:

AttributAttribute TypeType DescriptionDescription
containercontainer stringstring Nom du conteneur dans lequel le contenu du répertoire doit être transféré.The name of the container where the contents of the directory is to be transferred.
directoryQuotaInMBdirectoryQuotaInMB unsignedIntunsignedInt facultatif.Optional. Définit la taille maximale du répertoire en mégaoctets.Specifies the maximum size of the directory in megabytes.

La valeur par défaut est 0.The default is 0.

Élément IISLogsIISLogs Element

Définit le répertoire des journaux IIS.Defines the IIS log directory.

Élément parent : élément Directories.Parent Element Directories Element.

Attributs :Attributes:

AttributAttribute TypeType DescriptionDescription
containercontainer stringstring Nom du conteneur dans lequel le contenu du répertoire doit être transféré.The name of the container where the contents of the directory is to be transferred.
directoryQuotaInMBdirectoryQuotaInMB unsignedIntunsignedInt facultatif.Optional. Définit la taille maximale du répertoire en mégaoctets.Specifies the maximum size of the directory in megabytes.

La valeur par défaut est 0.The default is 0.

Élément DataSourcesDataSources Element

Définit zéro ou plusieurs répertoires de journaux supplémentaires.Defines zero or more additional log directories.

Élément parent : élément Directories.Parent Element: Directories Element.

Élément DirectoryConfigurationDirectoryConfiguration Element

Définit le répertoire de fichiers journaux à surveiller.Defines the directory of log files to monitor.

Élément parent : élément DataSources.Parent Element: DataSources Element.

Attributs :Attributes:

AttributAttribute TypeType DescriptionDescription
containercontainer stringstring Nom du conteneur dans lequel le contenu du répertoire doit être transféré.The name of the container where the contents of the directory is to be transferred.
directoryQuotaInMBdirectoryQuotaInMB unsignedIntunsignedInt facultatif.Optional. Définit la taille maximale du répertoire en mégaoctets.Specifies the maximum size of the directory in megabytes.

La valeur par défaut est 0.The default is 0.

Élément AbsoluteAbsolute Element

Définit un chemin d’accès absolu du répertoire à surveiller avec une extension d’environnement facultative.Defines an absolute path of the directory to monitor with optional environment expansion.

Élément parent : élément DirectoryConfiguration.Parent Element: DirectoryConfiguration Element.

Attributs :Attributes:

AttributAttribute TypeType DescriptionDescription
pathpath stringstring Obligatoire.Required. Chemin d’accès absolu au répertoire à surveiller.The absolute path to the directory to monitor.
expandEnvironmentexpandEnvironment booléenneboolean Obligatoire.Required. Si la valeur true est attribuée, les variables d’environnement du chemin d’accès sont développées.If set to true, environment variables in the path are expanded.

Élément LocalResourceLocalResource Element

Définit un chemin d’accès relatif à une ressource locale spécifiée dans la définition de service.Defines a path relative to a local resource defined in the service definition.

Élément parent : élément DirectoryConfiguration.Parent Element: DirectoryConfiguration Element.

Attributs :Attributes:

AttributAttribute TypeType DescriptionDescription
namename stringstring Obligatoire.Required. Nom de la ressource locale qui contient le répertoire à surveiller.The name of the local resource that contains the directory to monitor.
relativePathrelativePath stringstring Obligatoire.Required. Chemin d’accès relatif à la ressource locale à surveiller.The path relative to the local resource to monitor.

Élément PerformanceCountersPerformanceCounters Element

Définit le chemin d’accès au compteur de performance à collecter.Defines the path to the performance counter to collect.

Élément parent : Élément DiagnosticMonitorConfiguration.Parent Element: DiagnosticMonitorConfiguration Element.

Attributs :Attributes:

AttributAttribute TypeType DescriptionDescription
bufferQuotaInMBbufferQuotaInMB unsignedIntunsignedInt facultatif.Optional. Définit la quantité maximale de stockage du système de fichiers disponible pour les données spécifiées.Specifies the maximum amount of file system storage that is available for the specified data.

La valeur par défaut est 0.The default is 0.
scheduledTransferPeriodscheduledTransferPeriod durationduration facultatif.Optional. Définit l’intervalle entre les transferts planifiés de données, arrondi à la minute la plus proche.Specifies the interval between scheduled transfers of data, rounded up to the nearest minute.

La valeur par défaut est PT0S.The default is PT0S.

Élément PerformanceCounterConfigurationPerformanceCounterConfiguration Element

Définit le compteur de performance à collecter.Defines the performance counter to collect.

Élément parent : élément PerformanceCounters.Parent Element: PerformanceCounters Element.

Attributs :Attributes:

AttributAttribute TypeType DescriptionDescription
counterSpecifiercounterSpecifier stringstring Obligatoire.Required. Chemin d’accès au compteur de performance à collecter.The path to the performance counter to collect.
sampleRatesampleRate durationduration Obligatoire.Required. Vitesse à laquelle le compteur de performance doit être collecté.The rate at which the performance counter should be collected.

Élément WindowsEventLogWindowsEventLog Element

Définit les journaux des événements à surveiller.Defines the event logs to monitor.

Élément parent : Élément DiagnosticMonitorConfiguration.Parent Element: DiagnosticMonitorConfiguration Element.

Attributs :Attributes:

AttributAttribute TypeType DescriptionDescription
bufferQuotaInMBbufferQuotaInMB unsignedIntunsignedInt facultatif.Optional. Définit la quantité maximale de stockage du système de fichiers disponible pour les données spécifiées.Specifies the maximum amount of file system storage that is available for the specified data.

La valeur par défaut est 0.The default is 0.
scheduledTransferLogLevelFilterscheduledTransferLogLevelFilter stringstring facultatif.Optional. Définit le niveau de gravité minimal des entrées de journal transférées.Specifies the minimum severity level for log entries that are transferred. La valeur par défaut est Non défini.The default value is Undefined. Les autres valeurs possibles sont Détaillé, Informations, Avertissement, Erreur, et Critique.Other possible values are Verbose, Information, Warning, Error, and Critical.
scheduledTransferPeriodscheduledTransferPeriod durationduration facultatif.Optional. Définit l’intervalle entre les transferts planifiés de données, arrondi à la minute la plus proche.Specifies the interval between scheduled transfers of data, rounded up to the nearest minute.

La valeur par défaut est PT0S.The default is PT0S.

Élément DataSourceDataSource Element

Définit les journaux des événements à surveiller.Defines the event log to monitor.

Élément parent : élément WindowsEventLog.Parent Element: WindowsEventLog Element.

Attributs :Attributes:

AttributAttribute TypeType DescriptionDescription
namename stringstring Obligatoire.Required. Expression XPath spécifiant le journal à collecter.An XPath expression specifying the log to collect.