Delen via

Configuratieschemaversies en geschiedenis van extensieconfiguratieschema's voor Windows Azure Diagnostics (WAD)

  • Artikel

Dit artikel bevat de versiegeschiedenis van de Azure Diagnostics-extensie voor Windows-schemaversies (WAD) die zijn verzonden als onderdeel van de Microsoft Azure SDK.

Verzendgrafiek voor Azure SDK- en diagnostische versies

Azure SDK-versie Versie van diagnostische extensie Model
1.x 1.0 invoegtoepassing
2.0 - 2.4 1.0 invoegtoepassing
2.5 1.2 extensie
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-versie 1.0 is voor het eerst verzonden in een invoegtoepassingsmodel. Dit betekent dat u bij de installatie van de Azure SDK de versie van Azure Diagnostics hebt ontvangen die ermee wordt verzonden.

Vanaf SDK 2.5 (diagnostische versie 1.2) is Azure Diagnostics naar een extensiemodel gegaan. De hulpprogramma's voor het gebruik van nieuwe functies waren alleen beschikbaar in nieuwere Azure SDK's, maar elke service met behulp van Azure Diagnostics haalt de nieuwste verzendversie rechtstreeks vanuit Azure op. Iedereen die nog steeds SDK 2.5 gebruikt, laadt bijvoorbeeld de nieuwste versie die in de vorige tabel wordt weergegeven, ongeacht of ze de nieuwere functies gebruiken.

Index van schema's

Verschillende versies van Diagnostische gegevens van Azure maken gebruik van verschillende configuratieschema's. Schema 1.0 en 1.2 zijn afgeschaft. Zie Diagnostics 1.3 en hoger voor meer informatie over versie 1.3 en hoger

Versiegeschiedenis

Diagnostische extensie 1.11

Er is ondersteuning toegevoegd voor de Azure Monitor-sink. Deze sink is alleen van toepassing op prestatiemeteritems. Hiermee kunt u prestatiemeteritems verzenden die zijn verzameld op uw VM, VMSS of cloudservice naar Azure Monitor als aangepaste metrische gegevens. De Azure Monitor-sink ondersteunt:

  • Alle prestatiemeteritems ophalen die naar Azure Monitor worden verzonden via de metrische API's van Azure Monitor.
  • Waarschuwingen voor alle prestatiemeteritems die naar Azure Monitor worden verzonden via de nieuwe geïntegreerde waarschuwingservaring in Azure Monitor
  • De jokertekenoperator in prestatiemeteritems behandelen als de dimensie Exemplaar voor uw metrische gegevens. Als u bijvoorbeeld de teller 'LogicalDisk(*)/DiskWrites/sec' hebt verzameld, kunt u filteren en splitsen op de dimensie Exemplaar om schrijfbewerkingen per seconde voor elke logische schijf (C:, D:, enzovoort) te tekenen of te waarschuwen.

Azure Monitor definiëren als een nieuwe sink in de configuratie van uw diagnostische extensie

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

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

Notitie

Voor het configureren van de Azure Monitor-sink voor klassieke VM's en de klassieke CLoud-service moeten meer parameters worden gedefinieerd in de persoonlijke configuratie van de diagnostische extensie.

Raadpleeg de gedetailleerde documentatie voor het extensieschema voor diagnostische gegevens voor meer informatie.

Vervolgens kunt u uw prestatiemeteritems configureren die naar de Azure Monitor-sink worden gerouteerd.

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

Diagnostische extensie 1.9

Docker-ondersteuning toegevoegd.

Diagnostische extensie 1.8.1

U kunt een SAS-token opgeven in plaats van een opslagaccountsleutel in de privéconfiguratie. Als er een SAS-token is opgegeven, wordt de sleutel van het opslagaccount genegeerd.

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

Diagnostische extensie 1.8

Opslagtype toegevoegd aan PublicConfig. StorageType kan Table, Blob, TableAndBlob zijn. Tabel is de standaardinstelling.

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

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

Diagnostische extensie 1.7

De mogelijkheid toegevoegd om naar EventHub te routeren.

Diagnostische extensie 1.5

Het sinks-element en de mogelijkheid om diagnostische gegevens naar Application Insights te verzenden, waardoor het eenvoudiger is om problemen in uw toepassing en het systeem- en infrastructuurniveau te diagnosticeren.

Azure SDK 2.6 en diagnostische extensie 1.3

Voor Cloud Service-projecten in Visual Studio zijn de volgende wijzigingen aangebracht. (Deze wijzigingen zijn ook van toepassing op latere versies van Azure SDK.)

  • De lokale emulator ondersteunt nu diagnostische gegevens. Deze wijziging betekent dat u diagnostische gegevens kunt verzamelen en ervoor kunt zorgen dat uw toepassing de juiste traceringen maakt tijdens het ontwikkelen en testen in Visual Studio. Met de verbindingsreeks UseDevelopmentStorage=true kunt u diagnostische gegevens verzamelen terwijl u uw cloudserviceproject uitvoert in Visual Studio met behulp van de Azure Storage Emulator. Alle diagnostische gegevens worden verzameld in het opslagaccount (Development Storage).
  • Het diagnostische opslagaccount verbindingsreeks (Microsoft.WindowsAzure.Plugins.Diagnostics.ConnectionString) wordt opnieuw opgeslagen in het serviceconfiguratiebestand (.cscfg). In Azure SDK 2.5 is het diagnostische opslagaccount opgegeven in het bestand diagnostics.wadcfgx.

Er zijn enkele belangrijke verschillen tussen hoe de verbindingsreeks werkte in Azure SDK 2.4 en eerder en hoe het werkt in Azure SDK 2.6 en hoger.

  • In Azure SDK 2.4 en eerder is de verbindingsreeks tijdens runtime gebruikt door de diagnostische invoegtoepassing om de opslagaccountgegevens op te halen voor het overdragen van diagnostische logboeken.
  • In Azure SDK 2.6 en hoger gebruikt Visual Studio de diagnostische verbindingsreeks om de diagnostische extensie te configureren met de juiste opslagaccountgegevens tijdens het publiceren. Met de verbindingsreeks kunt u verschillende opslagaccounts definiëren voor verschillende serviceconfiguraties die Visual Studio gebruikt bij het publiceren. Omdat de diagnostische invoegtoepassing echter niet meer beschikbaar is (na Azure SDK 2.5), kan het CSCFG-bestand op zichzelf de extensie Voor diagnostische gegevens niet inschakelen. U moet de extensie afzonderlijk inschakelen via hulpprogramma's zoals Visual Studio of PowerShell.
  • Om het configureren van de diagnostische extensie met PowerShell te vereenvoudigen, bevat de pakketuitvoer van Visual Studio ook de openbare configuratie-XML voor de diagnostische extensie voor elke rol. Visual Studio gebruikt de diagnostische verbindingsreeks om de gegevens van het opslagaccount in te vullen die aanwezig zijn in de openbare configuratie. De openbare configuratiebestanden worden gemaakt in de map Extensies en volgen het patroon PaaSDiagnostics.<RoleName>.PubConfig.xml. Op PowerShell gebaseerde implementaties kunnen dit patroon gebruiken om elke configuratie toe te wijzen aan een rol.
  • De verbindingsreeks in het CSCFG-bestand wordt ook door Azure Portal gebruikt om toegang te krijgen tot de diagnostische gegevens, zodat deze kunnen worden weergegeven op het tabblad Bewaking. De verbindingsreeks is nodig om de service te configureren om uitgebreide bewakingsgegevens weer te geven in de portal.

Projecten migreren naar Azure SDK 2.6 en hoger

Wanneer u migreert van Azure SDK 2.5 naar Azure SDK 2.6 of hoger, blijft het daar als u een diagnostisch opslagaccount hebt opgegeven in het .wadcfgx-bestand. Als u wilt profiteren van de flexibiliteit van het gebruik van verschillende opslagaccounts voor verschillende opslagconfiguraties, moet u de verbindingsreeks handmatig toevoegen aan uw project. Als u een project migreert van Azure SDK 2.4 of eerder naar Azure SDK 2.6, blijven de diagnostische verbindingsreeks s behouden. Let echter op de wijzigingen in hoe verbindingsreeks s worden behandeld in Azure SDK 2.6, zoals is opgegeven in de vorige sectie.

Hoe Visual Studio het opslagaccount voor diagnostische gegevens bepaalt

  • Als een diagnostische verbindingsreeks is opgegeven in het CSCFG-bestand, gebruikt Visual Studio deze om de diagnostische extensie te configureren bij het publiceren en bij het genereren van de xml-bestanden voor openbare configuratie tijdens het verpakken.
  • Als er geen diagnostische verbindingsreeks is opgegeven in het CSCFG-bestand, valt Visual Studio terug op het gebruik van het opslagaccount dat is opgegeven in het .wadcfgx-bestand om de diagnostische extensie te configureren bij het publiceren en het genereren van de XML-bestanden voor openbare configuratie bij het verpakken.
  • De diagnostische verbindingsreeks in het CSCFG-bestand heeft voorrang op het opslagaccount in het .wadcfgx-bestand. Als een diagnostische verbindingsreeks is opgegeven in het CSCFG-bestand, gebruikt Visual Studio dat en negeert het opslagaccount in .wadcfgx.

Wat doet de 'Update development storage verbindingsreeks s...' selectievakje wel?

Het selectievakje voor updateontwikkelingsopslag verbindingsreeks s voor diagnostische gegevens en caching met de referenties van het Microsoft Azure-opslagaccount bij het publiceren naar Microsoft Azure biedt u een handige manier om alle ontwikkelopslagaccounts bij te werken verbindingsreeks s met het Azure-opslagaccount dat tijdens het publiceren is opgegeven.

Stel dat u dit selectievakje inschakelt en de diagnostische verbindingsreeks specificeertUseDevelopmentStorage=true. Wanneer u het project naar Azure publiceert, worden de diagnostische gegevens automatisch bijgewerkt verbindingsreeks met het opslagaccount dat u hebt opgegeven in de wizard Publiceren. Als echter een echt opslagaccount is opgegeven als diagnostische verbindingsreeks, wordt dat account in plaats daarvan gebruikt.

Verschillen in diagnostische functionaliteit tussen Azure SDK 2.4 en eerder en Azure SDK 2.5 en hoger

Als u uw project bijwerkt van Azure SDK 2.4 naar Azure SDK 2.5 of hoger, moet u rekening houden met de volgende verschillen in de diagnostische functionaliteit.

  • Configuratie-API's zijn afgeschaft : programmatische configuratie van diagnostische gegevens is beschikbaar in Azure SDK 2.4 of eerdere versies, maar is afgeschaft in Azure SDK 2.5 en hoger. Als uw diagnostische configuratie momenteel in code is gedefinieerd, moet u deze instellingen helemaal opnieuw configureren in het gemigreerde project om ervoor te zorgen dat diagnostische gegevens blijven werken. Het configuratiebestand voor diagnostische gegevens voor Azure SDK 2.4 is diagnostics.wadcfg en diagnostics.wadcfgx voor Azure SDK 2.5 en hoger.
  • Diagnostische gegevens voor cloudservicetoepassingen kunnen alleen worden geconfigureerd op rolniveau, niet op exemplaarniveau.
  • Telkens wanneer u uw app implementeert, wordt de configuratie voor diagnostische gegevens bijgewerkt . Dit kan pariteitsproblemen veroorzaken als u de configuratie van uw diagnostische gegevens wijzigt vanuit Server Explorer en vervolgens uw app opnieuw implementeert.
  • In Azure SDK 2.5 en hoger worden crashdumps geconfigureerd in het configuratiebestand voor diagnostische gegevens, niet in code . Als u crashdumps hebt geconfigureerd in code, moet u de configuratie handmatig overdragen van code naar het configuratiebestand, omdat de crashdumps niet worden overgedragen tijdens de migratie naar Azure SDK 2.6.