Versioni e cronologia degli schemi di configurazione dell'estensione di Diagnostica di AzureAzure Diagnostics extention configuration schema versions and history

Questa pagina rappresenta l'indice delle versioni degli schemi di estensione di Diagnostica di Azure forniti con Microsoft Azure SDK.This page indexes Azure Diagnostics extension schema versions shipped as part of the Microsoft Azure SDK.

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.

L'estensione di Diagnostica di Azure viene usata con altri prodotti di diagnostica Microsoft, come Monitoraggio di Azure, Application Insights e Log Analytics.The Azure Diagnostics extension is used with other Microsoft diagnostics products like Azure Monitor, Application Insights, and Log Analytics. Per altre informazioni vedere Panoramica degli strumenti di monitoraggio Microsoft.For more information see Microsoft Monitoring Tools Overview.

Grafico delle versioni fornite per Azure SDK e DiagnosticaAzure SDK and diagnostics versions shipping chart

Versione di Azure SDKAzure SDK version Versione dell'estensione di DiagnosticaDiagnostics extension version ModelloModel
1.x1.x 1.01.0 plug-inplug-in
2.0 - 2.42.0 - 2.4 1.01.0 plug-inplug-in
2.52.5 1.21.2 estensioneextension
2.62.6 1.31.3 ""
2.72.7 1.41.4 ""
2.82.8 1,51.5 ""
2,92.9 1.61.6 ""
2.962.96 1.71.7 ""
2.962.96 1.81.8 ""
2.962.96 1.8.11.8.1 ""
2.962.96 1.91.9 ""

Diagnostica di Azure versione 1.0 era inizialmente disponibile in un modello plug-in, vale a dire che con l'installazione del pacchetto Azure SDK si otteneva la versione di Diagnostica di Azure disponibile al suo interno.Azure Diagnostics version 1.0 first shipped in a plug-in model -- meaning that when you installed the Azure SDK, you got the version of Azure diagnostics shipped with it.

A partire dall'SDK 2.5 (diagnostica versione 1.2) lo strumento Diagnostica di Azure è passata a un modello di estensione.Starting with SDK 2.5 (diagnostics version 1.2), Azure diagnostics went to an extension model. Gli strumenti per usare le nuove funzionalità erano disponibili solo nei pacchetti Azure SDK più recenti, ma qualsiasi servizio che usava Diagnostica di Azure prelevava la versione più recente direttamente da Azure.The tools to utilize new features were only available in newer Azure SDKs, but any service using Azure diagnostics would pick up the latest shipping version directly from Azure. Gli utenti che ancora usano SDK 2.5 caricano la versione più recente indicata nella tabella precedente, a prescindere dalla circostanza che usino o meno le funzionalità più recenti.For example, anyone still using SDK 2.5 would be loading the latest version shown in the previous table, regardless if they are using the newer features.

Indice degli schemiSchemas index

Versioni diverse di Diagnostica di Azure usano schemi di configurazione diversi.Different versions of Azure diagnostics use different configuration schemas.

Schema di configurazione di Diagnostica 1.0Diagnostics 1.0 Configuration Schema

Schema di configurazione di Diagnostica 1.2Diagnostics 1.2 Configuration Schema

Schema di configurazione di Diagnostica 1.3 e versioni successiveDiagnostics 1.3 and later Configuration Schema

Cronologia delle versioniVersion history

Estensione di Diagnostica 1.9Diagnostics extension 1.9

Aggiunta del supporto Docker.Added Docker support.

Estensione di Diagnostica 1.8.1Diagnostics extension 1.8.1

Possibilità di specificare un token di firma di accesso condiviso anziché una chiave dell'account di archiviazione in PrivateConfig. Se viene fornito un token di firma di accesso condiviso, la chiave dell'account di archiviazione viene ignorata.Can specify a SAS token instead of a storage account key in the private config. If a SAS token is provided, the storage account key is ignored.

{
    "storageAccountName": "diagstorageaccount",
    "storageAccountEndPoint": "https://core.windows.net",
    "storageAccountSasToken": "{sas token}",
    "SecondaryStorageAccounts": {
        "StorageAccount": [
            {
                "name": "secondarydiagstorageaccount",
                "endpoint": "https://core.windows.net",
                "sasToken": "{sas token}"
            }
        ]
    }
}
<PrivateConfig>
    <StorageAccount name="diagstorageaccount" endpoint="https://core.windows.net" sasToken="{sas token}" />
    <SecondaryStorageAccounts>
        <StorageAccount name="secondarydiagstorageaccount" endpoint="https://core.windows.net" sasToken="{sas token}" />
    </SecondaryStorageAccounts>
</PrivateConfig>

Estensione di Diagnostica 1.8Diagnostics extension 1.8

Aggiunta del tipo di archiviazione in PublicConfig.Added Storage Type to PublicConfig. Il tipo di archiviazione può essere Table, Blob e TableAndBlob.StorageType can be Table, Blob, TableAndBlob. Table è l'impostazione predefinita.Table is the default.

{
    "WadCfg": {
    },
    "StorageAccount": "diagstorageaccount",
    "StorageType": "TableAndBlob"
}
<PublicConfig>
    <WadCfg />
    <StorageAccount>diagstorageaccount</StorageAccount>
    <StorageType>TableAndBlob</StorageType>
</PublicConfig>

Estensione di Diagnostica 1.7Diagnostics extension 1.7

Aggiunta della possibilità di eseguire l'indirizzamento a EventHub.Added the ability to route to EventHub.

Estensione di Diagnostica 1.5Diagnostics extension 1.5

L'aggiunta dell'elemento sink e la possibilità di inviare dati di diagnostica ad Application Insights semplificano la diagnosi dei problemi nell'intera applicazione, a livello di sistema e infrastruttura.Added the sinks element and the ability to send diagnostics data to Application Insights making it easier to diagnose issues across your application as well as the system and infrastructure level.

Azure SDK 2.6 ed estensione di Diagnostica 1.3Azure SDK 2.6 and diagnostics extension 1.3

Sono state apportate le modifiche seguenti ai progetti dei servizi cloud in Visual Studio.For Cloud Service projects in Visual Studio, the following changes were made. Queste modifiche sono applicabili anche alle versioni successive di Azure SDK.(These changes also apply to later versions of Azure SDK.)

  • L'emulatore locale supporta ora la diagnostica.The local emulator now supports diagnostics. È quindi possibile raccogliere dati di diagnostica e assicurare che l'applicazione crei le tracce corrette durante lo sviluppo e il testing in Visual Studio.This means you can collect diagnostics data and ensure your application is creating the right traces while you're developing and testing in Visual Studio. La stringa di connessione UseDevelopmentStorage=true abilita la raccolta di dati di diagnostica durante l'esecuzione del progetto servizio cloud in Visual Studio mediante l'emulatore di archiviazione di Azure.The connection string UseDevelopmentStorage=true enables diagnostics data collection while you're running your cloud service project in Visual Studio by using the Azure storage emulator. Tutti i dati di diagnostica vengono raccolti nell'account di archiviazione (archivio di sviluppo).All diagnostics data is collected in the (Development Storage) storage account.
  • La stringa di connessione dell'account di archiviazione di diagnostica (Microsoft.WindowsAzure.Plugins.Diagnostics.ConnectionString) viene archiviata ancora una volta nel file di configurazione (.cscfg) del servizio.The diagnostics storage account connection string (Microsoft.WindowsAzure.Plugins.Diagnostics.ConnectionString) is stored once again in the service configuration (.cscfg) file. In Azure SDK 2.5 l'account di archiviazione di diagnostica viene specificato nel file diagnostics.wadcfgx.In Azure SDK 2.5 the diagnostics storage account was specified in the diagnostics.wadcfgx file.

Il funzionamento della stringa di connessione presenta alcune differenze sostanziali tra Azure SDK 2.4 e versioni precedenti e Azure SDK 2.6 e versioni successive.There are some notable differences between how the connection string worked in Azure SDK 2.4 and earlier and how it works in Azure SDK 2.6 and later.

  • In Azure SDK 2.4 e versioni precedenti la stringa di connessione viene usata come runtime dal plug-in di diagnostica per ottenere le informazioni sull'account di archiviazione per il trasferimento dei log di diagnostica.In Azure SDK 2.4 and earlier, the connection string was used as a runtime by the diagnostics plugin to get the storage account information for transferring diagnostics logs.
  • In Azure SDK 2.6 e versioni successive la stringa di connessione di diagnostica viene usata da Visual Studio per configurare l'estensione di diagnostica con le informazioni appropriate sull'account di archiviazione durante la pubblicazione.In Azure SDK 2.6 and later, the diagnostics connection string is used by Visual Studio to configure the diagnostics extension with the appropriate storage account information during publishing. La stringa di connessione consente di definire diversi account di archiviazione per diverse configurazioni del servizio, che verranno usate da Visual Studio durante la pubblicazione.The connection string lets you define different storage accounts for different service configurations that Visual Studio will use when publishing. Poiché, tuttavia, il plug-in di diagnostica non è più disponibile (dopo Azure SDK 2.5), il solo file .cscfg non è in grado di abilitare l'estensione di diagnostica.However, because the diagnostics plugin is no longer available (after Azure SDK 2.5), the .cscfg file by itself can't enable the Diagnostics Extension. È necessario abilitare l'estensione separatamente tramite strumenti quali Visual Studio o PowerShell.You have to enable the extension separately through tools such as Visual Studio or PowerShell.
  • Per semplificare il processo di configurazione dell'estensione di diagnostica con PowerShell, l'output del pacchetto da Visual Studio contiene anche il codice XML di configurazione pubblica per l'estensione di diagnostica per ogni ruolo.To simplify the process of configuring the diagnostics extension with PowerShell, the package output from Visual Studio also contains the public configuration XML for the diagnostics extension for each role. Visual Studio usa la stringa di connessione di diagnostica per popolare le informazioni sull'account di archiviazione presenti nella configurazione pubblica.Visual Studio uses the diagnostics connection string to populate the storage account information present in the public configuration. I file di configurazione pubblica vengono creati nella cartella Extensions e seguono il modello PaaSDiagnostics.PubConfig.xml.The public config files are created in the Extensions folder and follow the pattern PaaSDiagnostics..PubConfig.xml. Eventuali distribuzioni basate su PowerShell possono usare questo modello per il mapping di ogni configurazione a un ruolo.Any PowerShell based deployments can use this pattern to map each configuration to a Role.
  • La stringa di connessione nel file .cscfg viene usata anche dal portale di Azure per accedere ai dati di diagnostica, per consentirne la visualizzazione nella scheda Monitoraggio . La stringa di connessione è necessaria per configurare il servizio, in modo da visualizzare i dati dettagliati del monitoraggio nel portale.The connection string in the .cscfg file is also used by the Azure portal to access the diagnostics data so it can appear in the Monitoring tab. The connection string is needed to configure the service to show verbose monitoring data in the portal.

Migrazione di progetti in Azure SDK 2.6 e versioni successiveMigrating projects to Azure SDK 2.6 and later

Quando si esegue la migrazione da Azure SDK 2.5 ad Azure SDK 2.6 o versioni successivi, eventuali account di archiviazione di diagnostica specificati nel file con estensione wadcfgx rimarranno in tale posizione.When migrating from Azure SDK 2.5 to Azure SDK 2.6 or later, if you had a diagnostics storage account specified in the .wadcfgx file, then it will stay there. Per sfruttare la flessibilità di utilizzo di account di archiviazione diversi per configurazioni di archiviazione diverse, è necessario aggiungere manualmente la stringa di connessione al progetto.To take advantage of the flexibility of using different storage accounts for different storage configurations, you'll have to manually add the connection string to your project. Se si sta eseguendo la migrazione di un progetto da Azure SDK 2.4 o versioni precedenti ad Azure SDK 2.6, le stringhe di connessione di diagnostica vengono mantenute.If you're migrating a project from Azure SDK 2.4 or earlier to Azure SDK 2.6, then the diagnostics connection strings are preserved. Occorre tuttavia notare le modifiche relative al modo in cui le stringhe di connessione vengono gestite in Azure SDK 2.6, come illustrato nella sezione precedente.However, please note the changes in how connection strings are treated in Azure SDK 2.6 as specified in the previous section.

Modalità di determinazione dell'account di archiviazione di diagnostica da parte di Visual StudioHow Visual Studio determines the diagnostics storage account

  • Se nel file .cscfg viene specificata una stringa di connessione di diagnostica, Visual Studio la userà per configurare l'estensione di diagnostica durante la pubblicazione e durante la generazione dei file XML di configurazione pubblica nel corso della creazione dei pacchetti.If a diagnostics connection string is specified in the .cscfg file, Visual Studio uses it to configure the diagnostics extension when publishing, and when generating the public configuration xml files during packaging.
  • Se nel file .cscfg non viene specificata alcuna stringa di connessione di diagnostica, Visual Studio userà di nuovo l'account di archiviazione specificato nel file con estensione wadcfgx per configurare l'estensione di diagnostica durante la pubblicazione e durante la generazione dei file XML di configurazione pubblica nel corso della creazione dei pacchetti.If no diagnostics connection string is specified in the .cscfg file, then Visual Studio falls back to using the storage account specified in the .wadcfgx file to configure the diagnostics extension when publishing, and generating the public configuration xml files when packaging.
  • La stringa di connessione di diagnostica nel file .cscfg ha la priorità rispetto all'account di archiviazione specificato nel file con estensione wadcfgx.The diagnostics connection string in the .cscfg file takes precedence over the storage account in the .wadcfgx file. Se nel file .cscfg viene specificata una stringa di connessione di diagnostica, Visual Studio userà tale stringa e ignorerà l'account di archiviazione specificato nel file con estensione wadcfgx.If a diagnostics connection string is specified in the .cscfg file, then Visual Studio uses that and ignores the storage account in .wadcfgx.

Funzione della casella di controllo "Aggiorna le stringhe di connessione dell'archivio di sviluppoWhat does the "Update development storage connection strings…" …"checkbox do?

La casella di controllo Aggiorna le stringhe di connessione dell'archivio di sviluppo per la diagnostica e la memorizzazione nella cache con le credenziali dell'account di archiviazione di Microsoft Azure quando si esegue la pubblicazione in Microsoft Azure offre un modo semplice per aggiornare eventuali stringhe di connessione dell'account di archiviazione con l'account di archiviazione di Azure specificato durante la pubblicazione.The checkbox for Update development storage connection strings for Diagnostics and Caching with Microsoft Azure storage account credentials when publishing to Microsoft Azure gives you a convenient way to update any development storage account connection strings with the Azure storage account specified during publishing.

Ad esempio, si supponga di selezionare questa casella di controllo e che la stringa di connessione di diagnostica specifichi UseDevelopmentStorage=true.For example, suppose you select this checkbox and the diagnostics connection string specifies UseDevelopmentStorage=true. Quando si pubblica il progetto in Azure, Visual Studio aggiornerà automaticamente la stringa di connessione di diagnostica con l'account di archiviazione specificato nella Pubblicazione guidata.When you publish the project to Azure, Visual Studio will automatically update the diagnostics connection string with the storage account you specified in the Publish wizard. Se, tuttavia, un account di archiviazione effettivo è stato specificato come stringa di connessione di diagnostica, verrà usato invece tale account.However, if a real storage account was specified as the diagnostics connection string, then that account is used instead.

Differenze della funzionalità di diagnostica tra Azure SDK 2.4 e versioni precedenti e Azure SDK 2.5 e versioni successiveDiagnostics functionality differences between Azure SDK 2.4 and earlier and Azure SDK 2.5 and later

Se si aggiorna il progetto da Azure SDK 2.4 ad Azure SDK 2.5 o versioni successive, è consigliabile ricordare le differenze seguenti a livello di funzionalità di diagnostica.If you're upgrading your project from Azure SDK 2.4 to Azure SDK 2.5 or later, you should bear in mind the following diagnostics functionality differences.

  • Le API di configurazione sono deprecate : la configurazione a livello di codice della diagnostica è disponibile in Azure SDK 2.4 o versioni precedenti, ma è deprecata in Azure SDK 2.5 e versioni successive.Configuration APIs are deprecated – Programmatic configuration of diagnostics is available in Azure SDK 2.4 or earlier versions, but is deprecated in Azure SDK 2.5 and later. Se la configurazione di diagnostica è attualmente definita nel codice, sarà necessario riconfigurare completamente tali impostazioni nel progetto sottoposto a migrazione, in modo da mantenere il funzionamento della diagnostica.If your diagnostics configuration is currently defined in code, you'll need to reconfigure those settings from scratch in the migrated project in order for diagnostics to keep working. Il file di configurazione della diagnostica per Azure SDK 2.4 è diagnostics.wadcfg, mentre è diagnostics.wadcfgx per Azure SDK 2.5 e versioni successive.The diagnostics configuration file for Azure SDK 2.4 is diagnostics.wadcfg, and diagnostics.wadcfgx for Azure SDK 2.5 and later.
  • La diagnostica per le applicazioni del servizio cloud può essere configurata solo a livello di ruolo, non a livello di istanza.Diagnostics for cloud service applications can only be configured at the role level, not at the instance level.
  • Ogni volta che si distribuisce l'app, le configurazioni di diagnostica vengono aggiornate : ciò può provocare problemi di parità se si modifica la configurazione di diagnostica da Esplora server e quindi si ridistribuisce l'app.Every time you deploy your app, the diagnostics configuration is updated – This can cause parity issues if you change your diagnostics configuration from Server Explorer and then redeploy your app.
  • In Azure SDK 2.5 e versioni successive i dump di arresto anomalo del sistema sono configurati nel file di configurazione, non nel codice : se i dump di arresto anomalo del sistema sono configurati nel codice, sarà necessario trasferire manualmente la configurazione dal codice al file di configurazione, perché i dump di arresto anomalo del sistema non vengono trasferiti durante la migrazione in Azure SDK 2.6.In Azure SDK 2.5 and later, crash dumps are configured in the diagnostics configuration file, not in code – If you have crash dumps configured in code, you'll have to manually transfer the configuration from code to the configuration file, because the crash dumps aren't transferred during the migration to Azure SDK 2.6.