Dela via

Schemaversioner och historik för windows Azure Diagnostics-tillägg (WAD)

  • Artikel

Den här artikeln innehåller versionshistoriken för schemaversionerna av Azure Diagnostics-tillägget 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 plugin-program
2.0 - 2.4 1.0 plugin-program
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 den version av Azure-diagnostik som levererades med den.

Från och med SDK 2.5 (diagnostikversion 1.2) gick Azure-diagnostiken till en tilläggsmodell. Verktygen för att använda nya funktioner var endast tillgängliga i nyare Azure SDK:er, men alla tjänster som använder Azure-diagnostik 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-diagnostik 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ämtar alla prestandaräknare som skickas till Azure Monitor via API:erna för Azure Monitor-mått.
  • Aviseringar på alla prestandaräknare som skickas till Azure Monitor via den nya enhetliga aviseringsupplevelsen i Azure Monitor
  • Behandla jokerteckenoperatorn i prestandaräknare som "Instans"-dimensionen för ditt mått. Om du till exempel samlade in räknaren "LogicalDisk(*)/DiskWrites/sek" skulle du kunna filtrera och dela på dimensionen "Instance" för att rita eller avisera på diskskrivningar/s 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>

Kommentar

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 dokumentationen för diagnostiktilläggsschemat.

Därefter kan du konfigurera dina prestandaräknare så att de dirigeras till Azure Monitor Sink.

"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 tillhandahålls 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

Lade till möjligheten att dirigera till EventHub.

Diagnostiktillägg 1.5

Lade till mottagarelementet 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ägget 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 när du utvecklar och testar i Visual Studio. Anslutningssträng 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).
  • Diagnostiklagringskontot anslutningssträng (Microsoft.WindowsAzure.Plugins.Diagnostics.ConnectionString) lagras återigen i tjänstkonfigurationsfilen (.cscfg). I Azure SDK 2.5 angavs diagnostiklagringskontot i filen diagnostics.wadcfgx.

Det finns några anmärkningsvärda skillnader mellan hur anslutningssträng fungerade i Azure SDK 2.4 och tidigare och hur det fungerar i Azure SDK 2.6 och senare.

  • I Azure SDK 2.4 och tidigare användes anslutningssträng vid körning av plugin-programmet för diagnostik 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 diagnostiken anslutningssträng för att konfigurera diagnostiktillägget med lämplig lagringskontoinformation under publiceringen. Med anslutningssträng 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 diagnostiken anslutningssträng 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äng i .cscfg-filen används också av Azure Portal för att komma åt diagnostikdata så att de kan visas på fliken Övervakning. Den anslutningssträng krävs för att konfigurera tjänsten så att den visar utförliga övervakningsdata 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, stannar det där. Om du vill dra nytta av flexibiliteten att använda olika lagringskonton för olika lagringskonfigurationer måste du lägga till anslutningssträng i projektet manuellt. Om du migrerar ett projekt från Azure SDK 2.4 eller tidigare till Azure SDK 2.6 bevaras diagnostiken anslutningssträng. Observera dock ändringarna i hur anslutningssträng behandlas i Azure SDK 2.6 enligt beskrivningen i föregående avsnitt.

Så här avgör Visual Studio diagnostiklagringskontot

  • Om en diagnostik anslutningssträng anges i .cscfg-filen använder Visual Studio det för att konfigurera diagnostiktillägget vid publicering och när du genererar xml-filerna för offentlig konfiguration under paketeringen.
  • Om ingen diagnostik anslutningssträ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.
  • Diagnostiken anslutningssträng i .cscfg-filen har företräde framför lagringskontot i .wadcfgx-filen. Om en diagnostik anslutningssträng anges i .cscfg-filen använder Visual Studio det och ignorerar lagringskontot i .wadcfgx.

Vad gör "Uppdatera utvecklingslagring anslutningssträng..." kryssrutan gör?

Kryssrutan för Uppdatering av utvecklingslagring anslutningssträng 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 alla utvecklingslagringskonton anslutningssträng med azure-lagringskontot som angavs under publiceringen.

Anta till exempel att du markerar den här kryssrutan och att diagnostiken anslutningssträng anger UseDevelopmentStorage=true. När du publicerar projektet till Azure uppdaterar Visual Studio automatiskt diagnostiken anslutningssträng med det lagringskonto som du angav i guiden Publicera. Men om ett verkligt lagringskonto har angetts som diagnostiken anslutningssträng 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.