Versioni e cronologia dello schema di configurazione dell'estensione microsoft Diagnostica di Azure (WAD)

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

grafico di spedizione delle versioni di Azure SDK e diagnostica

Diagnostica di Azure versione 1.0 fornita per la prima volta in un modello plug-in, ovvero quando è stato installato il Azure SDK, è stata fornita la versione di Azure diagnostics fornita con esso.

A partire da SDK 2.5 (versione di diagnostica 1.2), Azure diagnostica è passata a un modello di estensione. Gli strumenti per utilizzare nuove funzionalità erano disponibili solo nelle Azure SDK più recenti, ma qualsiasi servizio che usa la diagnostica Azure preleva la versione di spedizione più recente direttamente da Azure. Ad esempio, chiunque usi ancora SDK 2.5 caricherebbe la versione più recente illustrata nella tabella precedente, indipendentemente dal fatto che usino le funzionalità più recenti.

Indice degli schemi

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

Cronologia versioni

Le sezioni seguenti descrivono le modifiche apportate in ogni versione dell'estensione di diagnostica.

Estensione di Diagnostica 1.11

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

• Recupero di tutti i contatori delle prestazioni inviati a Monitoraggio di Azure tramite le API Monitoraggio di Azure metriche.
• 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 il contatore "LogicalDisk(*)/DiskWrites/sec" è possibile filtrare e dividere la dimensione "Instance". Consente di tracciare o avvisare le scritture su disco/sec per ogni disco logico. Ad esempio, C:, D:e così via.

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

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

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

Successivamente, è possibile configurare i contatori delle prestazioni da instradare al sink 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

È stata aggiunta la possibilità di instradare a Hub eventi di Azure.

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 e l'estensione di diagnostica 1.3

Per i progetti di servizio cloud in Visual Studio sono state apportate le modifiche seguenti. Queste modifiche si applicano anche alle versioni successive di Azure SDK.

• L'emulatore locale supporta ora la diagnostica. Questa modifica significa che è possibile raccogliere i dati di diagnostica e assicurarsi che l'applicazione crei le tracce corrette durante lo sviluppo e il test in Visual Studio. Il stringa di connessione UseDevelopmentStorage=true abilita la raccolta dei dati di diagnostica durante l'esecuzione del progetto di servizio cloud in Visual Studio usando l'emulatore Archiviazione di Azure. Tutti i dati di diagnostica vengono raccolti nell'account di archiviazione (archivio di sviluppo).
• L'account di archiviazione di diagnostica stringa di connessione (Microsoft. WindowsAzure.Plugins.Diagnostics.ConnectionString) viene archiviato nuovamente nel file di configurazione del servizio (con estensione cscfg). In Azure SDK 2.5 l'account di archiviazione di diagnostica è stato specificato nel file diagnostics.wadcfgx.

Esistono alcune differenze significative tra il funzionamento del stringa di connessione in Azure SDK 2.4 e versioni precedenti e il funzionamento in Azure SDK 2.6 e versioni successive.

• In Azure SDK 2.4 e versioni precedenti, il stringa di connessione è stato usato in fase di esecuzione 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 il stringa di connessione di diagnostica per configurare l'estensione di diagnostica con le informazioni appropriate sull'account di archiviazione durante la pubblicazione. Il stringa di connessione consente di definire account di archiviazione diversi per diverse configurazioni del servizio usate Visual Studio durante la pubblicazione. Tuttavia, poiché il plug-in di diagnostica non è più disponibile (dopo Azure SDK 2.5), il file con estensione cscfg non può abilitare l'estensione diagnostica. È necessario abilitare l'estensione separatamente tramite strumenti come Visual Studio o PowerShell.
• Per semplificare il processo di configurazione dell'estensione di diagnostica con PowerShell, l'output del pacchetto di Visual Studio contiene anche il codice XML di configurazione pubblico per l'estensione di diagnostica per ogni ruolo. Visual Studio usa il 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.
• Il stringa di connessione nel file con estensione cscfg viene usato anche dal portale di Azure per accedere ai dati di diagnostica in modo che possa essere visualizzato nella scheda Monitoring. Il stringa di connessione è necessario per configurare il servizio per visualizzare i dati di monitoraggio dettagliato nel portale.

Migrazione di progetti a Azure SDK 2.6 e versioni successive

Quando si esegue la migrazione da Azure SDK 2.5 a Azure SDK 2.6 o versione successiva, se si dispone di un account di archiviazione di diagnostica specificato nel file wadcfgx, rimane lì. Per sfruttare la flessibilità di usare account di archiviazione diversi per diverse configurazioni di archiviazione, è necessario aggiungere manualmente il stringa di connessione al progetto. Se si esegue la migrazione di un progetto da Azure SDK 2.4 o versioni precedenti a Azure SDK 2.6, le stringhe di connessione di diagnostica vengono mantenute. Si notino tuttavia le modifiche apportate alla modalità di trattamento delle stringhe di connessione in Azure SDK 2.6 come specificato nella sezione precedente.

Come Visual Studio determina l'account di archiviazione di diagnostica

• Se un stringa di connessione di diagnostica viene specificato nel file con estensione cscfg, Visual Studio lo usa per configurare l'estensione di diagnostica durante la pubblicazione e quando si generano i file XML di configurazione pubblici durante la creazione del pacchetto.
• Se non viene specificata alcuna stringa di connessione di diagnostica nel file con estensione cscfg, Visual Studio esegue il fallback all'uso dell'account di archiviazione specificato nel file con estensione wadcfgx. Usa questo account di archiviazione per configurare l'estensione di diagnostica durante la pubblicazione e per generare i file XML di configurazione pubblici durante la creazione del pacchetto.
• La diagnostica stringa di connessione nel file con estensione cscfg ha la precedenza sull'account di archiviazione nel file wadcfgx. Se un stringa di connessione di diagnostica viene specificato nel file con estensione cscfg, Visual Studio usa tale account e ignora l'account di archiviazione in wadcfgx.

Informazioni sulle stringhe di connessione di archiviazione per lo sviluppo di aggiornamenti checkbox does does

La casella di controllo per Aggiornare le stringhe di connessione dell'archiviazione di sviluppo per diagnostica e memorizzazione nella cache con le credenziali dell'account di archiviazione Microsoft Azure durante la pubblicazione in Microsoft Azure consente di aggiornare le stringhe di connessione dell'account di archiviazione di sviluppo con l'account di archiviazione Azure specificato durante la pubblicazione.

Si supponga, ad esempio, di selezionare la casella di controllo e la stringa di connessione di diagnostica specifica UseDevelopmentStorage=true. Quando si pubblica il progetto in Azure, Visual Studio aggiorna automaticamente i stringa di connessione di diagnostica con l'account di archiviazione specificato nella pubblicazione guidata. Tuttavia, se un account di archiviazione reale è stato specificato come stringa di connessione di diagnostica, tale account viene invece usato.

Differenze di 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 a Azure SDK 2.5 o versione successiva, è necessario tenere presenti le differenze di funzionalità di diagnostica seguenti.

• Le API di configurazione sono deprecate: la configurazione programmatica 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, è necessario riconfigurare tali impostazioni da zero nel progetto migrato affinché la diagnostica continui a funzionare. Il file di configurazione di diagnostica per Azure SDK 2.4 è diagnostics.wadcfg e 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, la configurazione di diagnostica viene aggiornata : può causare problemi di parità se si modifica la configurazione di diagnostica da Esplora server e quindi ridistribuire l'app.
• In Azure SDK 2.5 e versioni successive, i dump di arresto anomalo del sistema vengono configurati nel file di configurazione della diagnostica, non nel codice: se nel codice sono configurati dump di arresto anomalo del sistema, è 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 a Azure SDK 2.6.