Versioner och historik för konfigurationsscheman för Windows Azure Diagnostics-tillägg (WAD)

  • Artikel

Den här artikeln innehåller versionshistoriken för schemaversionerna Azure Diagnostics för Windows (WAD) som levereras som en del av Microsoft Azure SDK.

Leveransdiagram för Azure SDK och diagnostikversioner

Azure SDK-version Diagnostiktilläggsversion Modell
1.x 1.0 Plug-in
2.0 - 2.4 1.0 Plug-in
2.5 1.2 anknytning
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 "

Azure Diagnostics version 1.0 levererades först i en plugin-modell, vilket innebär att när du installerade Azure SDK fick du versionen av Azure Diagnostics levererad med den.

Från och med SDK 2.5 (diagnostikversion 1.2) gick Azure Diagnostics till en tilläggsmodell. Verktygen för att använda nya funktioner var bara tillgängliga i nyare Azure-SDK:er, men alla tjänster som använder Azure Diagnostics skulle hämta den senaste leveransversionen direkt från Azure. Till exempel skulle alla som fortfarande använder SDK 2.5 läsa in den senaste versionen som visas i föregående tabell, oavsett om de använder de nyare funktionerna.

Schemaindex

Olika versioner av Azure Diagnostics använder olika konfigurationsscheman. Schema 1.0 och 1.2 är inaktuella. Mer information om version 1.3 och senare finns i Diagnostik 1.3 och senare konfigurationsschema

Versionshistorik

Diagnostiktillägg 1.11

Stöd har lagts till för Azure Monitor-mottagaren. Den här mottagaren gäller endast för prestandaräknare. Gör det möjligt att skicka prestandaräknare som samlats in på din virtuella dator, VMSS eller molntjänst till Azure Monitor som anpassade mått. Azure Monitor-mottagaren stöder:

  • Hämta alla prestandaräknare som skickas till Azure Monitor via Mått-API:er för Azure Monitor.
  • Aviseringar för alla prestandaräknare som skickas till Azure Monitor via den nya enhetliga aviseringsupplevelsen i Azure Monitor
  • Behandla jokerteckenoperatorn i prestandaräknare som dimensionen "Instans" för ditt mått. Om du till exempel samlade in räknaren "LogicalDisk(*)/DiskWrites/sec" skulle du kunna filtrera och dela på dimensionen "Instans" för att rita eller varna på diskskrivningar/sek för varje logisk disk (C:, D:, osv.)

Definiera Azure Monitor som en ny mottagare i konfigurationen av diagnostiktillägget

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

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

Anteckning

Om du konfigurerar Azure Monitor-mottagaren för klassiska virtuella datorer och den klassiska CLoud-tjänsten måste fler parametrar definieras i diagnostiktilläggets privata konfiguration.

Mer information finns i den detaljerade schemadokumentationen för diagnostiktillägget.

Därefter kan du konfigurera prestandaräknarna så att de dirigeras till Azure Monitor-mottagaren.

"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>

Diagnostiktillägg 1.9

Docker-stöd har lagts till.

Diagnostiktillägg 1.8.1

Kan ange en SAS-token i stället för en lagringskontonyckel i den privata konfigurationen. Om en SAS-token anges ignoreras lagringskontonyckeln.

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

Diagnostiktillägg 1.8

Lagringstypen har lagts till i PublicConfig. StorageType kan vara Table, Blob, TableAndBlob. Tabellen är standard.

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

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

Diagnostiktillägg 1.7

Möjligheten att dirigera till EventHub har lagts till.

Diagnostiktillägg 1.5

Elementet sinks har lagts till och möjligheten att skicka diagnostikdata till Application Insights , vilket gör det enklare att diagnostisera problem i ditt program samt system- och infrastrukturnivån.

Azure SDK 2.6 och diagnostiktillägg 1.3

Följande ändringar har gjorts för Molntjänstprojekt i Visual Studio. (Dessa ändringar gäller även för senare versioner av Azure SDK.)

  • Den lokala emulatorn stöder nu diagnostik. Den här ändringen innebär att du kan samla in diagnostikdata och se till att ditt program skapar rätt spårningar medan du utvecklar och testar i Visual Studio. Anslutningssträngen UseDevelopmentStorage=true aktiverar insamling av diagnostikdata när du kör molntjänstprojektet i Visual Studio med hjälp av Azure Storage-emulatorn. Alla diagnostikdata samlas in i lagringskontot (Development Storage).
  • Anslutningssträngen för diagnostiklagringskontot (Microsoft.WindowsAzure.Plugins.Diagnostics.ConnectionString) lagras återigen i tjänstkonfigurationsfilen (.cscfg). I Azure SDK 2.5 angavs lagringskontot för diagnostik i filen diagnostics.wadcfgx.

Det finns några viktiga skillnader mellan hur anslutningssträngen fungerade i Azure SDK 2.4 och tidigare och hur den fungerar i Azure SDK 2.6 och senare.

  • I Azure SDK 2.4 och tidigare användes anslutningssträngen vid körning av plugin-programmet diagnostics för att hämta information om lagringskontot för överföring av diagnostikloggar.
  • I Azure SDK 2.6 och senare använder Visual Studio diagnostikanslutningssträngen för att konfigurera diagnostiktillägget med lämplig lagringskontoinformation under publiceringen. Med anslutningssträngen kan du definiera olika lagringskonton för olika tjänstkonfigurationer som Visual Studio använder vid publicering. Men eftersom plugin-programmet för diagnostik inte längre är tillgängligt (efter Azure SDK 2.5) kan .cscfg-filen i sig inte aktivera diagnostiktillägget. Du måste aktivera tillägget separat via verktyg som Visual Studio eller PowerShell.
  • För att förenkla processen med att konfigurera diagnostiktillägget med PowerShell innehåller paketutdata från Visual Studio även den offentliga konfigurations-XML:en för diagnostiktillägget för varje roll. Visual Studio använder diagnostikanslutningssträngen för att fylla i lagringskontoinformationen som finns i den offentliga konfigurationen. De offentliga konfigurationsfilerna skapas i mappen Tillägg och följer mönstret PaaSDiagnostics.<RoleName>.PubConfig.xml. Alla PowerShell-baserade distributioner kan använda det här mönstret för att mappa varje konfiguration till en roll.
  • Anslutningssträngen i .cscfg-filen används också av Azure Portal för att komma åt diagnostikdata så att de kan visas på fliken Övervakning. Anslutningssträngen krävs för att konfigurera tjänsten så att utförliga övervakningsdata visas i portalen.

Migrera projekt till Azure SDK 2.6 och senare

När du migrerar från Azure SDK 2.5 till Azure SDK 2.6 eller senare, om du har ett diagnostiklagringskonto som angetts i .wadcfgx-filen, kommer det att finnas kvar där. Om du vill dra nytta av flexibiliteten med att använda olika lagringskonton för olika lagringskonfigurationer måste du manuellt lägga till anslutningssträngen i projektet. Om du migrerar ett projekt från Azure SDK 2.4 eller tidigare till Azure SDK 2.6 bevaras anslutningssträngarna för diagnostik. Observera dock ändringarna i hur anslutningssträngar behandlas i Azure SDK 2.6 enligt beskrivningen i föregående avsnitt.

Så här avgör Visual Studio diagnostiklagringskontot

  • Om en diagnostikanslutningssträng anges i .cscfg-filen använder Visual Studio den för att konfigurera diagnostiktillägget vid publicering och när xml-filerna för offentlig konfiguration genereras under paketeringen.
  • Om ingen diagnostikanslutningssträng anges i .cscfg-filen återgår Visual Studio till att använda lagringskontot som anges i .wadcfgx-filen för att konfigurera diagnostiktillägget vid publicering och generera XML-filerna för offentlig konfiguration vid paketering.
  • Anslutningssträngen för diagnostik i .cscfg-filen har företräde framför lagringskontot i wadcfgx-filen. Om en anslutningssträng för diagnostik anges i .cscfg-filen använder Visual Studio den och ignorerar lagringskontot i .wadcfgx.

Vad gör "Uppdatera anslutningssträngar för utvecklingslagring..." kryssrutan do?

Kryssrutan för Anslutningssträngar för uppdateringsutvecklingslagring för diagnostik och cachelagring med autentiseringsuppgifter för Microsoft Azure-lagringskonto vid publicering till Microsoft Azure ger dig ett bekvämt sätt att uppdatera anslutningssträngar för utvecklingslagringskonton med azure-lagringskontot som angavs under publiceringen.

Anta till exempel att du markerar den här kryssrutan och att anslutningssträngen för diagnostik anger UseDevelopmentStorage=true. När du publicerar projektet till Azure uppdaterar Visual Studio automatiskt diagnostikanslutningssträngen med det lagringskonto som du angav i publiceringsguiden. Men om ett verkligt lagringskonto har angetts som anslutningssträngen för diagnostik används kontot i stället.

Skillnader i diagnostikfunktioner mellan Azure SDK 2.4 och tidigare och Azure SDK 2.5 och senare

Om du uppgraderar projektet från Azure SDK 2.4 till Azure SDK 2.5 eller senare bör du tänka på följande skillnader i diagnostikfunktioner.

  • Konfigurations-API:er är inaktuella – Programmatisk konfiguration av diagnostik är tillgänglig i Azure SDK 2.4 eller tidigare versioner, men är inaktuell i Azure SDK 2.5 och senare. Om diagnostikkonfigurationen för närvarande definieras i kod måste du konfigurera om inställningarna från grunden i det migrerade projektet för att diagnostiken ska fortsätta fungera. Diagnostikkonfigurationsfilen för Azure SDK 2.4 är diagnostics.wadcfg och diagnostics.wadcfgx för Azure SDK 2.5 och senare.
  • Diagnostik för molntjänstprogram kan bara konfigureras på rollnivå, inte på instansnivå.
  • Varje gång du distribuerar din app uppdateras diagnostikkonfigurationen – Detta kan orsaka paritetsproblem om du ändrar diagnostikkonfigurationen från Server Explorer och sedan distribuerar om appen.
  • I Azure SDK 2.5 och senare konfigureras kraschdumpar i diagnostikkonfigurationsfilen, inte i kod – Om du har kraschdumpar konfigurerade i kod måste du manuellt överföra konfigurationen från kod till konfigurationsfilen eftersom kraschdumparna inte överförs under migreringen till Azure SDK 2.6.