Versioni e cronologia dello schema di configurazione di Windows Diagnostica di Azure (WAD)

  • Articolo

Questo articolo fornisce la cronologia delle versioni dell'estensione Diagnostica di Azure per le versioni dello schema windows (WAD) fornite come parte dell'SDK di Microsoft Azure.

Grafico delle versioni fornite per Azure SDK e Diagnostica

Versione di Azure SDK Versione dell'estensione di Diagnostica Modellare
1.x 1,0 plug-in
2.0 - 2.4 1,0 plug-in
2,5 1.2 estensione
2.6 1.3 "
2.7 1.4 "
2.8 1.5 "
2,9 1.6 "
2.96 1,7 "
2.96 1.8 "
2.96 1.8.1 "
2.96 1,9 "
2.96 1.11 "
2.96 1.21 "

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.

A partire dall'SDK 2.5 (diagnostica versione 1.2) lo strumento Diagnostica di Azure è passata a un modello di estensione. 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. 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.

Indice degli schemi

Versioni diverse di Diagnostica di Azure usano schemi di configurazione diversi. Lo schema 1.0 e 1.2 sono stati deprecati. Per altre informazioni sulla versione 1.3 e versioni successive, vedere Diagnostica 1.3 e versioni successive dello schema di configurazione

Cronologia delle versioni

Estensione di Diagnostica 1.11

Aggiunta del supporto per il sink di Monitoraggio di Azure. Questo sink è applicabile solo ai contatori delle prestazioni. Consente di inviare i contatori delle prestazioni raccolti nella macchina virtuale, VMSS o servizio cloud a Monitoraggio di Azure come metriche personalizzate. Il sink di Monitoraggio di Azure supporta:

  • Il recupero di tutti i contatori delle prestazioni inviati a Monitoraggio di Azure tramite le API di metrica di Monitoraggio di Azure.
  • La visualizzazione di avvisi su tutti i contatori delle prestazioni inviati a Monitoraggio di Azure tramite la nuova esperienza di avvisi unificati in Monitoraggio di Azure
  • La considerazione dell'operatore carattere jolly nei contatori delle prestazioni come la dimensione "Istanza" per la metrica. Ad esempio, se è stato raccolto il contatore "LogicalDisk(*)/DiskWrites/sec" è possibile filtrare e suddividere la dimensione "Istanza" per tracciare o inviare avvisi in Scrittura disco/sec per ogni disco logico (C:, D:, ecc.)

Definire Monitoraggio di Azure come un nuovo sink nella configurazione dell'estensione di diagnostica

"SinksConfig": {
    "Sink": [
        {
            "name": "AzureMonitorSink",
            "AzureMonitor": {}
        },
    ]
}

<SinksConfig>  
  <Sink name="AzureMonitorSink">
      <AzureMonitor/>
  </Sink>
</SinksConfig>

Nota

La configurazione del sink di Monitoraggio di Azure per le macchine virtuali e per il servizio cloud classico richiede la definizione di più parametri nella configurazione privata dell'estensione Diagnostica.

Per altri dettagli, consultare la documentazione dello schema dell'estensione diagnostica dettagliata.

Successivamente, è possibile configurare i contatori delle prestazioni da instradare al sink di Monitoraggio di Azure.

"PerformanceCounters": {
    "scheduledTransferPeriod": "PT1M",
    "sinks": "AzureMonitorSink",
    "PerformanceCounterConfiguration": [
        {
            "counterSpecifier": "\\Processor(_Total)\\% Processor Time",
            "sampleRate": "PT1M",
            "unit": "percent"
        }
    ]
},

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

Estensione di Diagnostica 1.9

Aggiunta del supporto Docker.

Estensione di Diagnostica 1.8.1

Può specificare un token di firma di accesso condiviso anziché una chiave dell'account di archiviazione nella configurazione privata. Se viene fornito un token di firma di accesso condiviso, la chiave dell'account di archiviazione viene ignorata.

{
    "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.8

Aggiunta del tipo di archiviazione in PublicConfig. Il tipo di archiviazione può essere Table, Blob e TableAndBlob. Table è l'impostazione predefinita.

{
    "WadCfg": {
    },
    "StorageAccount": "diagstorageaccount",
    "StorageType": "TableAndBlob"
}

<PublicConfig>
    <WadCfg />
    <StorageAccount>diagstorageaccount</StorageAccount>
    <StorageType>TableAndBlob</StorageType>
</PublicConfig>

Estensione di Diagnostica 1.7

Aggiunta della possibilità di eseguire l'indirizzamento a EventHub.

Estensione di Diagnostica 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.

Azure SDK 2.6 ed estensione di Diagnostica 1.3

Sono state apportate le modifiche seguenti ai progetti dei servizi cloud in Visual Studio. Queste modifiche sono applicabili anche alle versioni successive di Azure SDK.

  • L'emulatore locale supporta ora la diagnostica. È quindi possibile raccogliere dati di diagnostica e assicurare che l'applicazione crei le tracce corrette durante lo sviluppo e il testing in Visual Studio. La stringa UseDevelopmentStorage=true di connessione consente la raccolta dati di diagnostica durante l'esecuzione del progetto di servizio cloud in Visual Studio usando l'emulatore di Archiviazione di Azure. Tutti i dati di diagnostica vengono raccolti nell'account di archiviazione (archivio di sviluppo).
  • 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. In Azure SDK 2.5 l'account di archiviazione di diagnostica viene specificato nel file diagnostics.wadcfgx.

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.

  • In Azure SDK 2.4 e versioni precedenti, la stringa di connessione viene usata in fase di 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.6 e versioni successive, Visual Studio usa la stringa di connessione di diagnostica per configurare l'estensione di diagnostica con le informazioni appropriate sull'account di archiviazione durante la pubblicazione. 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. 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. È necessario abilitare l'estensione separatamente tramite strumenti quali Visual Studio o 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. Visual Studio usa la stringa di connessione di diagnostica per popolare le informazioni sull'account di archiviazione presenti nella configurazione pubblica. I file di configurazione pubblici vengono creati nella cartella Estensioni e seguono il modello PaaSDiagnostics.<RoleName>.PubConfig.xml. Eventuali distribuzioni basate su PowerShell possono usare questo modello per il mapping di ogni configurazione a un ruolo.
  • La stringa di connessione nel file con estensione cscfg viene usata anche dal portale di Azure per accedere ai dati di diagnostica in modo che venga visualizzata nella scheda Monitoraggio. La stringa di connessione è necessaria per configurare il servizio per visualizzare i dati di monitoraggio dettagliato nel portale.

Migrazione di progetti in Azure SDK 2.6 e versioni successive

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. 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. 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. È tuttavia opportuno notare la diversa modalità di gestione delle stringhe di connessione in Azure SDK 2.6, come illustrato nella sezione precedente.

Modalità di determinazione dell'account di archiviazione di diagnostica da parte di Visual Studio

  • 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.
  • 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.
  • La stringa di connessione di diagnostica nel file .cscfg ha la priorità rispetto all'account di archiviazione specificato nel file con estensione wadcfgx. 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.

Qual è la funzione della casella di controllo "Aggiorna le stringhe di connessione dell'archivio di sviluppo"?

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 permette di aggiornare con facilità eventuali stringhe di connessione di account di archiviazione di sviluppo con l'account di archiviazione di Azure specificato durante la pubblicazione.

Ad esempio, si supponga di selezionare questa casella di controllo e che la stringa di connessione di diagnostica specifichi 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. Se, tuttavia, un account di archiviazione effettivo è stato specificato come stringa di connessione di diagnostica, verrà usato invece tale account.

Differenze della funzionalità di diagnostica tra Azure SDK 2.4 e versioni precedenti e Azure SDK 2.5 e versioni successive

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.

  • 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. 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. Il file di configurazione della diagnostica per Azure SDK 2.4 è diagnostics.wadcfg, mentre è diagnostics.wadcfgx per Azure SDK 2.5 e versioni successive.
  • La diagnostica per le applicazioni del servizio cloud può essere configurata solo a livello di ruolo, non a livello di istanza.
  • 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.
  • In Azure SDK 2.5 e versioni successive, i dump di arresto anomalo del sistema sono configurati nel file di configurazione diagnostica, non nel codice: se i dump di arresto anomalo del sistema sono stati 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 ad Azure SDK 2.6.