Schema di configurazione di Diagnostica di Azure 1.3 e versioni successiveAzure Diagnostics 1.3 and later configuration schema

Nota

Il componente estensione di Diagnostica di Azure viene usato per raccogliere i contatori delle prestazioni e altre statistiche da:The Azure Diagnostics extension is the component used to collect performance counters and other statistics from:

  • Macchine virtuali di AzureAzure Virtual Machines
  • Set di scalabilità di macchine virtualiVirtual Machine Scale Sets
  • Service FabricService Fabric
  • Servizi cloudCloud Services
  • Gruppi di sicurezza di reteNetwork Security Groups

Questa pagina è utile solo se si usa uno di questi servizi.This page is only relevant if you are using one of these services.

Questa pagina è valida per le versioni 1.3 e più recenti (Azure SDK 2.4 e versioni più recenti).This page is valid for versions 1.3 and newer (Azure SDK 2.4 and newer). Le sezioni di configurazione più recenti hanno commenti per indicare in quale versione sono state aggiunte.Newer configuration sections are commented to show in what version they were added.

Il file di configurazione descritto qui viene usato per definire le impostazioni di configurazione della diagnostica all'avvio del monitor di diagnostica.The configuration file described here is used to set diagnostic configuration settings when the diagnostics monitor starts.

L'estensione viene usata in combinazione con altri prodotti di diagnostica Microsoft, come Monitoraggio di Azure, Application Insights e Log Analytics.The extension is used in conjunction with other Microsoft diagnostics products like Azure Monitor, Application Insights, and Log Analytics.

Scaricare la definizione dello schema del file di configurazione pubblico eseguendo il comando PowerShell seguente:Download the public configuration file schema definition by executing the following PowerShell command:

(Get-AzureServiceAvailableExtension -ExtensionName 'PaaSDiagnostics' -ProviderNamespace 'Microsoft.Azure.Diagnostics').PublicConfigurationSchema | Out-File –Encoding utf8 -FilePath 'C:\temp\WadConfig.xsd'  

Per altre informazioni su Diagnostica di Azure, vedere Estensione di Diagnostica di Azure.For more information about using Azure Diagnostics, see Azure Diagnostics Extension.

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"?>  
<DiagnosticsConfiguration  xmlns="http://schemas.microsoft.com/ServiceHosting/2010/10/DiagnosticsConfiguration">   
  <PublicConfig>  
    <WadCfg>  
      <DiagnosticMonitorConfiguration overallQuotaInMB="10000">  

        <PerformanceCounters scheduledTransferPeriod="PT1M">  
          <PerformanceCounterConfiguration counterSpecifier="\Processor(_Total)\% Processor Time" sampleRate="PT1M" unit="percent" />  
        </PerformanceCounters>  

        <Directories scheduledTransferPeriod="PT5M">  
          <IISLogs containerName="iislogs" />  
          <FailedRequestLogs containerName="iisfailed" />  

          <DataSources>  
            <DirectoryConfiguration containerName="mynewprocess">  
              <Absolute path="C:\MyNewProcess" expandEnvironment="false" />  
            </DirectoryConfiguration>  
            <DirectoryConfiguration containerName="badapp">  
              <Absolute path="%SYSTEMDRIVE%\BadApp" expandEnvironment="true" />  
            </DirectoryConfiguration>  
            <DirectoryConfiguration containerName="goodapp">  
              <LocalResource name="Skippy" relativePath="..\PeanutButter"/>  
            </DirectoryConfiguration>  
          </DataSources>  

        </Directories>  

        <EtwProviders>  
          <EtwEventSourceProviderConfiguration   
                       provider="MyProviderClass"   
                       scheduledTransferPeriod="PT5M">  
            <Event id="0"/>  
            <Event id="1" eventDestination="errorTable"/>  
            <DefaultEvents />  
          </EtwEventSourceProviderConfiguration>  
          <EtwManifestProviderConfiguration provider="5974b00b-84c2-44bc-9e58-3a2451b4e3ad" scheduledTransferLogLevelFilter="Information" scheduledTransferPeriod="PT2M">  
            <Event id="0"/>  
            <DefaultEvents eventDestination="defaultTable"/>  
          </EtwManifestProviderConfiguration>  
        </EtwProviders>  

        <WindowsEventLog scheduledTransferPeriod="PT5M">  
          <DataSource name="System!*[System[Provider[@Name='Microsoft Antimalware']]]"/>  
          <DataSource name="System!*[System[Provider[@Name='NTFS'] and (EventID=55)]]" />  
          <DataSource name="System!*[System[Provider[@Name='disk'] and (EventID=7 or EventID=52 or EventID=55)]]" />  
        </WindowsEventLog>  

        <Logs  bufferQuotaInMB="1024"   
             scheduledTransferPeriod="PT1M"   
             scheduledTransferLogLevelFilter="Verbose"   
             sinks="ApplicationInsights.AppLogs"/>  <!-- sinks attribute added in 1.5 -->  

        <CrashDumps containerName="wad-crashdumps" directoryQuotaPercentage="30" dumpType="Mini">  
          <CrashDumpConfiguration processName="mynewprocess.exe" />  
          <CrashDumpConfiguration processName="badapp.exe"/>  
        </CrashDumps>  

        <DockerSources> <!-- Added in 1.9 --> 
          <Stats enabled="true" sampleRate="PT1M" scheduledTransferPeriod="PT1M" />
        </DockerSources>

      </DiagnosticMonitorConfiguration>  

      <SinksConfig>   <!-- Added in 1.5 -->  
        <Sink name="ApplicationInsights">   
          <ApplicationInsights>{Insert InstrumentationKey}</ApplicationInsights>   
          <Channels>   
            <Channel logLevel="Error" name="Errors"  />   
            <Channel logLevel="Verbose" name="AppLogs"  />   
          </Channels>   
        </Sink>   
        <Sink name="EventHub"> <!-- Added in 1.7 -->
          <EventHub Url="https://myeventhub-ns.servicebus.windows.net/diageventhub" SharedAccessKeyName="SendRule" usePublisherId="false" />
        </Sink>
        <Sink name="secondaryEventHub"> <!-- Added in 1.7 -->
          <EventHub Url="https://myeventhub-ns.servicebus.windows.net/secondarydiageventhub" SharedAccessKeyName="SendRule" usePublisherId="false" />
        </Sink>
        <Sink name="secondaryStorageAccount"> <!-- Added in 1.7 -->
          <StorageAccount name="secondarydiagstorageaccount" endpoint="https://core.windows.net" />
        </Sink>
   </SinksConfig>

  </WadCfg>  

  <StorageAccount>diagstorageaccount</StorageAccount>
  <StorageType>TableAndBlob</StorageType> <!-- Added in 1.8 -->  
  </PublicConfig>  

  <PrivateConfig>  <!-- Added in 1.3 -->  
    <StorageAccount name="" key="" endpoint="" sasToken="{sas token}"  />  <!-- sasToken in Private config added in 1.8.1 -->  
    <EventHub Url="https://myeventhub-ns.servicebus.windows.net/diageventhub" SharedAccessKeyName="SendRule" SharedAccessKey="{base64 encoded key}" />

    <SecondaryStorageAccounts>
       <StorageAccount name="secondarydiagstorageaccount" key="{base64 encoded key}" endpoint="https://core.windows.net" sasToken="{sas token}" />
    </SecondaryStorageAccounts>

    <SecondaryEventHubs>
       <EventHub Url="https://myeventhub-ns.servicebus.windows.net/secondarydiageventhub" SharedAccessKeyName="SendRule" SharedAccessKey="{base64 encoded key}" />
    </SecondaryEventHubs>

  </PrivateConfig>  
  <IsEnabled>true</IsEnabled>  
</DiagnosticsConfiguration>  

Equivalente JSON del file di configurazione XML precedente.JSON equivalent of the previous XML configuration file.

PublicConfig e PrivateConfig sono separati perché vengono passati come variabili differenti nella maggior parte dei casi in cui viene usato il formato JSON.The PublicConfig and PrivateConfig are separated because in most json usage cases, they are passed as different variables. Alcuni esempi sono i modelli di Resource Manager, i set di scalabilità di macchine virtuali PowerShell e Visual Studio.These cases include Resource Manager templates, Virtual Machine Scale set PowerShell, and Visual Studio.

"PublicConfig" {
    "WadCfg": {
        "DiagnosticMonitorConfiguration": {
            "overallQuotaInMB": 10000,
            "DiagnosticInfrastructureLogs": {
                "scheduledTransferLogLevelFilter": "Error"
            },
            "PerformanceCounters": {
                "scheduledTransferPeriod": "PT1M",
                "PerformanceCounterConfiguration": [
                    {
                        "counterSpecifier": "\\Processor(_Total)\\% Processor Time",
                        "sampleRate": "PT1M",
                        "unit": "percent"
                    }
                ]
            },
            "Directories": {
                "scheduledTransferPeriod": "PT5M",
                "IISLogs": {
                    "containerName": "iislogs"
                },
                "FailedRequestLogs": {
                    "containerName": "iisfailed"
                },
                "DataSources": [
                    {
                        "containerName": "mynewprocess",
                        "Absolute": {
                            "path": "C:\\MyNewProcess",
                            "expandEnvironment": false
                        }
                    },
                    {
                        "containerName": "badapp",
                        "Absolute": {
                            "path": "%SYSTEMDRIVE%\\BadApp",
                            "expandEnvironment": true
                        }
                    },
                    {
                        "containerName": "goodapp",
                        "LocalResource": {
                            "relativePath": "..\\PeanutButter",
                            "name": "Skippy"
                        }
                    }
                ]
            },
            "EtwProviders": {
                "sinks": "",
                "EtwEventSourceProviderConfiguration": [
                    {
                        "scheduledTransferPeriod": "PT5M",
                        "provider": "MyProviderClass",
                        "Event": [
                            {
                                "id": 0
                            },
                            {
                                "id": 1,
                                "eventDestination": "errorTable"
                            }
                        ],
                        "DefaultEvents": {
                        }
                    }
                ],
                "EtwManifestProviderConfiguration": [
                    {
                        "scheduledTransferPeriod": "PT2M",
                        "scheduledTransferLogLevelFilter": "Information",
                        "provider": "5974b00b-84c2-44bc-9e58-3a2451b4e3ad",
                        "Event": [
                            {
                                "id": 0
                            }
                        ],
                        "DefaultEvents": {
                        }
                    }
                ]
            },
            "WindowsEventLog": {
                "scheduledTransferPeriod": "PT5M",
                "DataSource": [
                    {
                        "name": "System!*[System[Provider[@Name='Microsoft Antimalware']]]"
                    },
                    {
                        "name": "System!*[System[Provider[@Name='NTFS'] and (EventID=55)]]"
                    },
                    {
                        "name": "System!*[System[Provider[@Name='disk'] and (EventID=7 or EventID=52 or EventID=55)]]"
                    }
                ]
            },
            "Logs": {
                "scheduledTransferPeriod": "PT1M",
                "scheduledTransferLogLevelFilter": "Verbose",
                "sinks": "ApplicationInsights.AppLogs"
            },
            "CrashDumps": {
                "directoryQuotaPercentage": 30,
                "dumpType": "Mini",
                "containerName": "wad-crashdumps",
                "CrashDumpConfiguration": [
                    {
                        "processName": "mynewprocess.exe"
                    },
                    {
                        "processName": "badapp.exe"
                    }
                ]
            }
        },
        "SinksConfig": {
            "Sink": [
                {
                    "name": "ApplicationInsights",
                    "ApplicationInsights": "{Insert InstrumentationKey}",
                    "Channels": {
                        "Channel": [
                            {
                                "logLevel": "Error",
                                "name": "Errors"
                            },
                            {
                                "logLevel": "Verbose",
                                "name": "AppLogs"
                            }
                        ]
                    }
                },
                {
                    "name": "EventHub",
                    "EventHub": {
                        "Url": "https://myeventhub-ns.servicebus.windows.net/diageventhub",
                        "SharedAccessKeyName": "SendRule",
                        "usePublisherId": false
                    }
                },
                {
                    "name": "secondaryEventHub",
                    "EventHub": {
                        "Url": "https://myeventhub-ns.servicebus.windows.net/secondarydiageventhub",
                        "SharedAccessKeyName": "SendRule",
                        "usePublisherId": false
                    }
                },
                {
                    "name": "secondaryStorageAccount",
                    "StorageAccount": {
                        "name": "secondarydiagstorageaccount",
                        "endpoint": "https://core.windows.net"
                    }
                }
            ]
        }
    },
    "StorageAccount": "diagstorageaccount",
    "StorageType": "TableAndBlob"
}
"PrivateConfig" {
    "storageAccountName": "diagstorageaccount",
    "storageAccountKey": "{base64 encoded key}",
    "storageAccountEndPoint": "https://core.windows.net",
    "storageAccountSasToken": "{sas token}",
    "EventHub": {
        "Url": "https://myeventhub-ns.servicebus.windows.net/diageventhub",
        "SharedAccessKeyName": "SendRule",
        "SharedAccessKey": "{base64 encoded key}"
    },
    "SecondaryStorageAccounts": {
        "StorageAccount": [
            {
                "name": "secondarydiagstorageaccount",
                "key": "{base64 encoded key}",
                "endpoint": "https://core.windows.net",
                "sasToken": "{sas token}"
            }
        ]
    },
    "SecondaryEventHubs": {
        "EventHub": [
            {
                "Url": "https://myeventhub-ns.servicebus.windows.net/secondarydiageventhub",
                "SharedAccessKeyName": "SendRule",
                "SharedAccessKey": "{base64 encoded key}"
            }
        ]
    }
}

Come leggere questa paginaReading this page

I tag seguenti sono più o meno nell'ordine indicato nell'esempio precedente.The tags following are roughly in order shown in the preceding example. Se non si trova rapidamente la descrizione completa, cercare l'elemento o l'attributo nella pagina.If you don't see a full description where you expect it, search the page for the element or attribute.

Tipi di attributi comuniCommon Attribute Types

L'attributo scheduledTransferPeriod è presente in diversi elementi.scheduledTransferPeriod attribute appears in several elements. Si tratta dell'intervallo tra trasferimenti pianificati per l'archivio, arrotondato per eccesso al minuto più vicino.It is the interval between scheduled transfers to storage rounded up to the nearest minute. Il valore è un "Tipo di dati di durata" XML.The value is an XML “Duration Data Type.”

Elemento DiagnosticsConfigurationDiagnosticsConfiguration Element

Albero: radice - DiagnosticsConfigurationTree: Root - DiagnosticsConfiguration

Aggiunto nella versione 1.3.Added in version 1.3.

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

Attributo xmlns: lo spazio dei nomi XML per il file di configurazione della diagnostica è il seguente:Attribute xmlns - The XML namespace for the diagnostics configuration file is:
http://schemas.microsoft.com/ServiceHosting/2010/10/DiagnosticsConfigurationhttp://schemas.microsoft.com/ServiceHosting/2010/10/DiagnosticsConfiguration

Elementi figlioChild Elements DescrizioneDescription
PublicConfigPublicConfig Obbligatorio.Required. Vedere la descrizione altrove in questa pagina.See description elsewhere on this page.
PrivateConfigPrivateConfig Facoltativa.Optional. Vedere la descrizione altrove in questa pagina.See description elsewhere on this page.
IsEnabledIsEnabled Booleano.Boolean. Vedere la descrizione altrove in questa pagina.See description elsewhere on this page.

Elemento PublicConfigPublicConfig Element

Albero: radice - DiagnosticsConfiguration - PublicConfigTree: Root - DiagnosticsConfiguration - PublicConfig

Descrive la configurazione della diagnostica pubblica.Describes the public diagnostics configuration.

Elementi figlioChild Elements DescrizioneDescription
WadCfgWadCfg Obbligatorio.Required. Vedere la descrizione altrove in questa pagina.See description elsewhere on this page.
StorageAccountStorageAccount Nome dell'account di archiviazione di Azure in cui archiviare i dati.The name of the Azure Storage account to store the data in. Può anche essere specificato come parametro quando si esegue il cmdlet Set-AzureServiceDiagnosticsExtension.May also be specified as a parameter when executing the Set-AzureServiceDiagnosticsExtension cmdlet.
Tipo di archiviazioneStorageType Può essere Table, Blob o TableAndBlob.Can be Table, Blob, or TableAndBlob. Table è il valore predefinito.Table is default. Quando si sceglie TableAndBlob, i dati di diagnostica vengono scritti due volte, una volta per ogni tipo.When TableAndBlob is chosen, diagnostic data is written twice -- once to each type.
LocalResourceDirectoryLocalResourceDirectory Directory nella macchina virtuale in cui l'agente di monitoraggio archivia i dati degli eventi.The directory on the virtual machine where the Monitoring Agent stores event data. Se non impostata, verrà usata la directory predefinita:If not, set, the default directory is used:

Per un ruolo di lavoro/Web: C:\Resources\<guid>\directory\<guid>.<RoleName.DiagnosticStore\For a Worker/web role: C:\Resources\<guid>\directory\<guid>.<RoleName.DiagnosticStore\

Per una macchina virtuale: C:\WindowsAzure\Logs\Plugins\Microsoft.Azure.Diagnostics.IaaSDiagnostics\<WADVersion>\WAD<WADVersion>For a Virtual Machine: C:\WindowsAzure\Logs\Plugins\Microsoft.Azure.Diagnostics.IaaSDiagnostics\<WADVersion>\WAD<WADVersion>

Gli attributi obbligatori sono i seguenti:Required attributes are:

- path: directory nel sistema che dovrà essere usata da Diagnostica di Azure.- path - The directory on the system to be used by Azure Diagnostics.

- expandEnvironment: definisce se le variabili di ambiente vengono espanse nel nome del percorso.- expandEnvironment - Controls whether environment variables are expanded in the path name.

Elemento WadCFGWadCFG Element

Albero: radice - DiagnosticsConfiguration - PublicConfig - WadCFGTree: Root - DiagnosticsConfiguration - PublicConfig - WadCFG

Identifica e configura i dati di telemetria da raccogliere.Identifies and configures the telemetry data to be collected.

Elemento DiagnosticMonitorConfigurationDiagnosticMonitorConfiguration Element

Albero: radice - DiagnosticsConfiguration - PublicConfig - WadCFG - DiagnosticMonitorConfigurationTree: Root - DiagnosticsConfiguration - PublicConfig - WadCFG - DiagnosticMonitorConfiguration

ObbligatorioRequired

AttributiAttributes DescrizioneDescription
overallQuotaInMBoverallQuotaInMB Spazio massimo sul disco locale che può essere usato dai vari tipi di dati di diagnostica raccolti da Diagnostica di Azure.The maximum amount of local disk space that may be consumed by the various types of diagnostic data collected by Azure Diagnostics. L'impostazione predefinita è 5120 MB.The default setting is 5120 MB.
useProxyServeruseProxyServer Configurare Diagnostica di Azure per l'uso delle impostazioni del server proxy definite nelle impostazioni di Internet Explorer.Configure Azure Diagnostics to use the proxy server settings as set in IE settings.



Elementi figlioChild Elements DescrizioneDescription
CrashDumpsCrashDumps Vedere la descrizione altrove in questa pagina.See description elsewhere on this page.
DiagnosticInfrastructureLogsDiagnosticInfrastructureLogs Abilita la raccolta dei log generati da Diagnostica di Azure.Enable collection of logs generated by Azure Diagnostics. I log dell'infrastruttura di diagnostica sono utili per la risoluzione dei problemi del sistema di diagnostica stesso.The diagnostic infrastructure logs are useful for troubleshooting the diagnostics system itself. Gli attributi facoltativi sono i seguenti:Optional attributes are:

- scheduledTransferLogLevelFilter: consente di configurare il livello di gravità minimo dei log raccolti.- scheduledTransferLogLevelFilter - Configures the minimum severity level of the logs collected.

- scheduledTransferPeriod: intervallo tra trasferimenti pianificati per l'archivio, arrotondato per eccesso al minuto più vicino.- scheduledTransferPeriod - The interval between scheduled transfers to storage rounded up to the nearest minute. Il valore è un "Tipo di dati di durata" XML.The value is an XML “Duration Data Type.”
DirectoriesDirectories Vedere la descrizione altrove in questa pagina.See description elsewhere on this page.
EtwProvidersEtwProviders Vedere la descrizione altrove in questa pagina.See description elsewhere on this page.
MetricheMetrics Vedere la descrizione altrove in questa pagina.See description elsewhere on this page.
PerformanceCountersPerformanceCounters Vedere la descrizione altrove in questa pagina.See description elsewhere on this page.
WindowsEventLogWindowsEventLog Vedere la descrizione altrove in questa pagina.See description elsewhere on this page.
DockerSourcesDockerSources Vedere la descrizione altrove in questa pagina.See description elsewhere on this page.

Elemento CrashDumpsCrashDumps Element

Albero: radice - DiagnosticsConfiguration - PublicConfig - WadCFG - DiagnosticMonitorConfiguration - CrashDumpsTree: Root - DiagnosticsConfiguration - PublicConfig - WadCFG - DiagnosticMonitorConfiguration - CrashDumps

Abilitare la raccolta di dump di arresto anomalo del sistema.Enable the collection of crash dumps.

AttributiAttributes DescrizioneDescription
containerNamecontainerName Facoltativa.Optional. Nome del contenitore BLOB dell'account di archiviazione di Azure da usare per archiviare i dump di arresto anomalo del sistema.The name of the blob container in your Azure Storage account to be used to store crash dumps.
crashDumpTypecrashDumpType Facoltativa.Optional. Configura Diagnostica di Azure per la raccolta di dump di arresto anomalo del sistema completi o mini.Configures Azure Diagnostics to collect mini or full crash dumps.
directoryQuotaPercentagedirectoryQuotaPercentage Facoltativa.Optional. Configura la percentuale di overallQuotaInMB da riservare per i dump di arresto anomalo del sistema nella macchina virtuale.Configures the percentage of overallQuotaInMB to be reserved for crash dumps on the VM.
Elementi figlioChild Elements DescrizioneDescription
CrashDumpConfigurationCrashDumpConfiguration Obbligatorio.Required. Definisce i valori di configurazione di ogni processo.Defines configuration values for each process.

Anche l'attributo seguente è obbligatorio:The following attribute is also required:

processName: nome del processo per il quale Diagnostica di Azure dovrà raccogliere un dump di arresto anomalo del sistema.processName - The name of the process you want Azure Diagnostics to collect a crash dump for.

Elemento DirectoriesDirectories Element

Albero: radice - DiagnosticsConfiguration - PublicConfig - WadCFG - DiagnosticMonitorConfiguration - DirectoriesTree: Root - DiagnosticsConfiguration - PublicConfig - WadCFG - DiagnosticMonitorConfiguration - Directories

Abilita la raccolta del contenuto di una directory, dei log delle richieste di accesso IIS non riuscite e/o dei log IIS.Enables the collection of the contents of a directory, IIS failed access request logs and/or IIS logs.

Attributo scheduledTransferPeriod facoltativo.Optional scheduledTransferPeriod attribute. Vedere la spiegazione indicata in precedenza.See explanation earlier.

Elementi figlioChild Elements DescrizioneDescription
IISLogsIISLogs Includendo questo elemento nella configurazione viene abilitata la raccolta di log IIS:Including this element in the configuration enables the collection of IIS logs:

containerName: nome del contenitore BLOB dell'account di archiviazione di Azure da usare per archiviare i log IIS.containerName - The name of the blob container in your Azure Storage account to be used to store the IIS logs.
FailedRequestLogsFailedRequestLogs Con questo elemento nella configurazione è possibile raccogliere i log relativi alle richieste non riuscite per un'applicazione o un sito IIS.Including this element in the configuration enables collection of logs about failed requests to an IIS site or application. È anche necessario abilitare le opzioni di traccia sotto system.WebServer in Web.config.You must also enable tracing options under system.WebServer in Web.config.
DataSourcesDataSources Elenco di directory da monitorare.A list of directories to monitor.

Elemento DataSourcesDataSources Element

Albero: radice - DiagnosticsConfiguration - PublicConfig - WadCFG - DiagnosticMonitorConfiguration - Directories - DataSourcesTree: Root - DiagnosticsConfiguration - PublicConfig - WadCFG - DiagnosticMonitorConfiguration - Directories - DataSources

Elenco di directory da monitorare.A list of directories to monitor.

Elementi figlioChild Elements DescrizioneDescription
DirectoryConfigurationDirectoryConfiguration Obbligatorio.Required. Attributo obbligatorio:Required attribute:

containerName: nome del contenitore BLOB dell'account di archiviazione di Azure da usare per archiviare i file log.containerName - The name of the blob container in your Azure Storage account that to be used to store the log files.

Elemento DirectoryConfigurationDirectoryConfiguration Element

Albero: radice - DiagnosticsConfiguration - PublicConfig - WadCFG - DiagnosticMonitorConfiguration - Directories - DataSources - DirectoryConfigurationTree: Root - DiagnosticsConfiguration - PublicConfig - WadCFG - DiagnosticMonitorConfiguration - Directories - DataSources - DirectoryConfiguration

Può includere l'elemento Absolute o LocalResource, ma non entrambi.May include either the Absolute or LocalResource element but not both.

Elementi figlioChild Elements DescrizioneDescription
AbsoluteAbsolute Percorso assoluto della directory da monitorare.The absolute path to the directory to monitor. Gli attributi seguenti sono obbligatori:The following attributes are required:

- Path: percorso assoluto della directory da monitorare.- Path - The absolute path to the directory to monitor.

- expandEnvironment: definisce se le variabili di ambiente vengono espanse in Path.- expandEnvironment - Configures whether environment variables in Path are expanded.
LocalResourceLocalResource Percorso relativo di una risorsa locale da monitorare.The path relative to a local resource to monitor. Gli attributi obbligatori sono i seguenti:Required attributes are:

- Name: nome della risorsa locale che contiene la directory da monitorare- Name - The local resource that contains the directory to monitor

- relativePath: percorso relativo del nome che contiene la directory da monitorare- relativePath - The path relative to Name that contains the directory to monitor

Elemento EtwProvidersEtwProviders Element

Albero: radice - DiagnosticsConfiguration - PublicConfig - WadCFG - DiagnosticMonitorConfiguration - EtwProvidersTree: Root - DiagnosticsConfiguration - PublicConfig - WadCFG - DiagnosticMonitorConfiguration - EtwProviders

Configura la raccolta di eventi ETW da EventSource e/o da provider basati su manifesti ETW.Configures collection of ETW events from EventSource and/or ETW Manifest based providers.

Elementi figlioChild Elements DescrizioneDescription
EtwEventSourceProviderConfigurationEtwEventSourceProviderConfiguration Configura la raccolta di eventi generati dalla classe EventSource.Configures collection of events generated from EventSource Class. Attributo obbligatorio:Required attribute:

provider: nome della classe dell'evento EventSource.provider - The class name of the EventSource event.

Gli attributi facoltativi sono i seguenti:Optional attributes are:

- scheduledTransferLogLevelFilter: livello di gravità minimo per il trasferimento nell'account di archiviazione.- scheduledTransferLogLevelFilter - The minimum severity level to transfer to your storage account.

- scheduledTransferPeriod: intervallo tra trasferimenti pianificati per l'archivio, arrotondato per eccesso al minuto più vicino.- scheduledTransferPeriod - The interval between scheduled transfers to storage rounded up to the nearest minute. Il valore è un "Tipo di dati di durata" XML.The value is an XML “Duration Data Type.”
EtwManifestProviderConfigurationEtwManifestProviderConfiguration Attributo obbligatorio:Required attribute:

provider: GUID del provider di eventiprovider - The GUID of the event provider

Gli attributi facoltativi sono i seguenti:Optional attributes are:

- scheduledTransferLogLevelFilter: livello di gravità minimo per il trasferimento nell'account di archiviazione.- scheduledTransferLogLevelFilter - The minimum severity level to transfer to your storage account.

- scheduledTransferPeriod: intervallo tra trasferimenti pianificati per l'archivio, arrotondato per eccesso al minuto più vicino.- scheduledTransferPeriod - The interval between scheduled transfers to storage rounded up to the nearest minute. Il valore è un "Tipo di dati di durata" XML.The value is an XML “Duration Data Type.”

Elemento EtwEventSourceProviderConfigurationEtwEventSourceProviderConfiguration Element

Albero: radice - DiagnosticsConfiguration - PublicConfig - WadCFG - DiagnosticMonitorConfiguration - EtwProviders- EtwEventSourceProviderConfigurationTree: Root - DiagnosticsConfiguration - PublicConfig - WadCFG - DiagnosticMonitorConfiguration - EtwProviders- EtwEventSourceProviderConfiguration

Configura la raccolta di eventi generati dalla classe EventSource.Configures collection of events generated from EventSource Class.

Elementi figlioChild Elements DescrizioneDescription
DefaultEventsDefaultEvents Attributo facoltativo:Optional attribute:

eventDestination: nome della tabella nella quale archiviare gli eventieventDestination - The name of the table to store the events in
EventEvent Attributo obbligatorio:Required attribute:

id: ID dell'evento.id - The id of the event.

Attributo facoltativo:Optional attribute:

eventDestination: nome della tabella nella quale archiviare gli eventieventDestination - The name of the table to store the events in

Elemento EtwManifestProviderConfigurationEtwManifestProviderConfiguration Element

Albero: radice - DiagnosticsConfiguration - PublicConfig - WadCFG - DiagnosticMonitorConfiguration - EtwProviders - EtwManifestProviderConfigurationTree: Root - DiagnosticsConfiguration - PublicConfig - WadCFG - DiagnosticMonitorConfiguration - EtwProviders - EtwManifestProviderConfiguration

Elementi figlioChild Elements DescrizioneDescription
DefaultEventsDefaultEvents Attributo facoltativo:Optional attribute:

eventDestination: nome della tabella nella quale archiviare gli eventieventDestination - The name of the table to store the events in
EventEvent Attributo obbligatorio:Required attribute:

id: ID dell'evento.id - The id of the event.

Attributo facoltativo:Optional attribute:

eventDestination: nome della tabella nella quale archiviare gli eventieventDestination - The name of the table to store the events in

Elemento MetricsMetrics Element

Albero: radice - DiagnosticsConfiguration - PublicConfig - WadCFG - DiagnosticMonitorConfiguration - MetricsTree: Root - DiagnosticsConfiguration - PublicConfig - WadCFG - DiagnosticMonitorConfiguration - Metrics

Consente di generare una tabella di contatori delle prestazioni ottimizzata per le query veloci.Enables you to generate a performance counter table that is optimized for fast queries. Ogni contatore delle prestazioni definito nell'elemento PerformanceCounters viene archiviato nella tabella delle metriche oltre che nella tabella dei contatori delle prestazioni.Each performance counter that is defined in the PerformanceCounters element is stored in the Metrics table in addition to the Performance Counter table.

L'attributo resourceId è obbligatorio.The resourceId attribute is required. L'ID risorsa della macchina virtuale o del set di scalabilità di macchine virtuali in cui si distribuisce Diagnostica di Azure.The resource ID of the Virtual Machine or Virtual Machine Scale Set you are deploying Azure Diagnostics to. Ottenere l'attributo resourceID dal portale di Azure.Get the resourceID from the Azure portal. Selezionare Esplora -> Gruppi di risorse -> <Nome>.Select Browse -> Resource Groups -> <Name>. Fare clic sul riquadro Proprietà e copiare il valore del campo ID.Click the Properties tile and copy the value from the ID field.

Elementi figlioChild Elements DescrizioneDescription
MetricAggregationMetricAggregation Attributo obbligatorio:Required attribute:

scheduledTransferPeriod: intervallo tra trasferimenti pianificati per l'archivio, arrotondato per eccesso al minuto più vicino.scheduledTransferPeriod - The interval between scheduled transfers to storage rounded up to the nearest minute. Il valore è un "Tipo di dati di durata" XML.The value is an XML “Duration Data Type.”

Elemento PerformanceCountersPerformanceCounters Element

Albero: radice - DiagnosticsConfiguration - PublicConfig - WadCFG - DiagnosticMonitorConfiguration - PerformanceCountersTree: Root - DiagnosticsConfiguration - PublicConfig - WadCFG - DiagnosticMonitorConfiguration - PerformanceCounters

Abilita la raccolta dei contatori delle prestazioni.Enables the collection of performance counters.

Attributo facoltativo:Optional attribute:

Attributo scheduledTransferPeriod facoltativo.Optional scheduledTransferPeriod attribute. Vedere la spiegazione indicata in precedenza.See explanation earlier.

Elemento figlioChild Element DescrizioneDescription
PerformanceCounterConfigurationPerformanceCounterConfiguration Gli attributi seguenti sono obbligatori:The following attributes are required:

- counterSpecifier: nome del contatore delle prestazioni.- counterSpecifier - The name of the performance counter. Ad esempio, \Processor(_Total)\% Processor Time.For example, \Processor(_Total)\% Processor Time. Per ottenere un elenco di contatori delle prestazioni nell'host eseguire il comando typeperf.To get a list of performance counters on your host, run the command typeperf.

- sampleRate: frequenza di campionamento del contatore.- sampleRate - How often the counter should be sampled.

Attributo facoltativo:Optional attribute:

unit: unità di misura del contatore.unit - The unit of measure of the counter.

Elemento WindowsEventLogWindowsEventLog Element

Albero: radice - DiagnosticsConfiguration - PublicConfig - WadCFG - DiagnosticMonitorConfiguration - WindowsEventLogTree: Root - DiagnosticsConfiguration - PublicConfig - WadCFG - DiagnosticMonitorConfiguration - WindowsEventLog

Abilita la raccolta dei registri eventi di Windows.Enables the collection of Windows Event Logs.

Attributo scheduledTransferPeriod facoltativo.Optional scheduledTransferPeriod attribute. Vedere la spiegazione indicata in precedenza.See explanation earlier.

Elemento figlioChild Element DescrizioneDescription
DataSourceDataSource Registri eventi di Windows da raccogliere.The Windows Event logs to collect. Attributo obbligatorio:Required attribute:

name: query XPath che descrive gli eventi di Windows da raccogliere.name - The XPath query describing the windows events to be collected. ad esempio:For example:

Application!*[System[(Level <=3)]], System!*[System[(Level <=3)]], System!*[System[Provider[@Name='Microsoft Antimalware']]], Security!*[System[(Level <= 3)]

Per raccogliere tutti gli eventi, specificare ""To collect all events, specify ""

Elemento LogsLogs Element

Albero: radice - DiagnosticsConfiguration - PublicConfig - WadCFG - DiagnosticMonitorConfiguration - LogsTree: Root - DiagnosticsConfiguration - PublicConfig - WadCFG - DiagnosticMonitorConfiguration - Logs

Presente nella versione 1.0 e 1.1.Present in version 1.0 and 1.1. Assente nella versione 1.2.Missing in 1.2. Aggiunto nuovamente nella versione 1.3.Added back in 1.3.

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

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.
scheduledTransferLogLevelFilterrscheduledTransferLogLevelFilterr 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, con il quale verranno trasferiti tutti i log.The default value is Undefined, which transfers all logs. Altri valori possibili (dal più dettagliato al meno dettagliato) sono Dettagli, Informazioni, Avviso, Errore e Critico.Other possible values (in order of most to least information) 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.
sinks aggiunto nella versione 1.5sinks Added in 1.5 stringstring Facoltativa.Optional. Punta a una posizione di sink per l'invio di dati di diagnostica,Points to a sink location to also send diagnostic data. ad esempio Application Insights.For example, Application Insights.

DockerSourcesDockerSources

Albero: radice - DiagnosticsConfiguration - PublicConfig - WadCFG - DiagnosticMonitorConfiguration - DockerSourcesTree: Root - DiagnosticsConfiguration - PublicConfig - WadCFG - DiagnosticMonitorConfiguration - DockerSources

Elementi aggiunti nella versione 1.9.Added in 1.9.

Nome dell'elementoElement Name DescrizioneDescription
StatsStats Indica al sistema di raccogliere statistiche per i contenitori DockerTells the system to collect stats for Docker containers

Elemento SinksConfigSinksConfig Element

Albero: radice - DiagnosticsConfiguration - PublicConfig - WadCFG - SinksConfigTree: Root - DiagnosticsConfiguration - PublicConfig - WadCFG - SinksConfig

Elenco di posizioni a cui inviare i dati di diagnostica e la configurazione associata a tali posizioni.A list of locations to send diagnostics data to and the configuration associated with those locations.

Nome dell'elementoElement Name DescrizioneDescription
SinkSink Vedere la descrizione altrove in questa pagina.See description elsewhere on this page.

Elemento SinkSink Element

Albero: radice - DiagnosticsConfiguration - PublicConfig - WadCFG - SinksConfig - SinkTree: Root - DiagnosticsConfiguration - PublicConfig - WadCFG - SinksConfig - Sink

Aggiunto nella versione 1.5.Added in version 1.5.

Definisce le posizioni a cui inviare i dati di diagnostica,Defines locations to send diagnostic data to. ad esempio il servizio Application Insights.For example, the Application Insights service.

AttributoAttribute TipoType DescrizioneDescription
nomename stringstring Stringa che identifica il nome del sink.A string identifying the sinkname.
ElementoElement TypeType DescrizioneDescription
Application InsightsApplication Insights stringstring Usato solo per inviare dati ad Application Insights.Used only when sending data to Application Insights. Contiene la chiave di strumentazione per un account di Application Insights attivo a cui è possibile accedere.Contain the Instrumentation Key for an active Application Insights account that you have access to.
ChannelsChannels stringstring Uno per ogni filtro aggiuntivo per i flussiOne for each additional filtering that stream that you

Elemento ChannelsChannels Element

Albero: radice - DiagnosticsConfiguration - PublicConfig - WadCFG - SinksConfig - Sink - ChannelsTree: Root - DiagnosticsConfiguration - PublicConfig - WadCFG - SinksConfig - Sink - Channels

Aggiunto nella versione 1.5.Added in version 1.5.

Definisce i filtri per i flussi di dati di log che attraversano un sink.Defines filters for streams of log data passing through a sink.

ElementoElement TypeType DescrizioneDescription
ChannelChannel stringstring Vedere la descrizione altrove in questa pagina.See description elsewhere on this page.

Elemento ChannelChannel Element

Albero: radice - DiagnosticsConfiguration - PublicConfig - WadCFG - SinksConfig - Sink - Channels - ChannelTree: Root - DiagnosticsConfiguration - PublicConfig - WadCFG - SinksConfig - Sink - Channels - Channel

Aggiunto nella versione 1.5.Added in version 1.5.

Definisce le posizioni a cui inviare i dati di diagnostica,Defines locations to send diagnostic data to. ad esempio il servizio Application Insights.For example, the Application Insights service.

AttributiAttributes TypeType DescrizioneDescription
logLevellogLevel stringstring 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, con il quale verranno trasferiti tutti i log.The default value is Undefined, which transfers all logs. Altri valori possibili (dal più dettagliato al meno dettagliato) sono Dettagli, Informazioni, Avviso, Errore e Critico.Other possible values (in order of most to least information) are Verbose, Information, Warning, Error, and Critical.
nomename stringstring Nome univoco per fare riferimento al canaleA unique name of the channel to refer to

Elemento PrivateConfigPrivateConfig Element

Albero: radice - DiagnosticsConfiguration - PrivateConfigTree: Root - DiagnosticsConfiguration - PrivateConfig

Aggiunto nella versione 1.3.Added in version 1.3.

FacoltativoOptional

Archivia le informazioni private dell'account di archiviazione, ovvero nome, chiave ed endpoint.Stores the private details of the storage account (name, key, and endpoint). Queste informazioni vengono inviate alla macchina virtuale, ma non possono essere recuperate dalla macchina virtuale stessa.This information is sent to the virtual machine, but cannot be retrieved from it.

Elementi figlioChild Elements DescrizioneDescription
StorageAccountStorageAccount Account di archiviazione da usare.The storage account to use. Gli attributi seguenti sono obbligatori:The following attributes are required

- name: nome dell'account di archiviazione.- name - The name of the storage account.

- key: chiave dell'account di archiviazione.- key - The key to the storage account.

- endpoint: endpoint per accedere all'account di archiviazione.- endpoint - The endpoint to access the storage account.

-sasToken (elemento aggiunto alla versione 1.8.1): è possibile specificare un token di firma di accesso condiviso anziché una chiave dell'account di archiviazione in PrivateConfig. Se viene fornito, la chiave dell'account di archiviazione viene ignorata.-sasToken (added 1.8.1)- You can specify an SAS token instead of a storage account key in the private config. If provided, the storage account key is ignored.
Requisiti per il token di firma di accesso condiviso:Requirements for the SAS Token:
- Supporta solo il token di firma di accesso condiviso dell'account- Supports account SAS token only
Sono obbligatori i tipi di servizio - b e t.- b, t service types are required.
Sono obbligatorie le autorizzazioni - a, c, u, w.- a, c, u, w permissions are required.
Sono obbligatori i tipi di risorse - c, o.- c, o resource types are required.
- Supporta solo il protocollo HTTPS- Supports the HTTPS protocol only
-I valori dell'ora di inizio e di scadenza devono essere validi.- Start and expiry time must be valid.

Elemento IsEnabledIsEnabled Element

Albero: radice - DiagnosticsConfiguration - IsEnabledTree: Root - DiagnosticsConfiguration - IsEnabled

Booleano.Boolean. Usare true per abilitare la diagnostica o false per disabilitarla.Use true to enable the diagnostics or false to disable the diagnostics.