Configuratieschemaversies en geschiedenis van extensies van Microsoft Azure Diagnostics (WAD)

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

verzendgrafiek voor Azure SDK- en diagnostische versies

Azure Diagnostics versie 1.0 voor het eerst verzonden in een invoegtoepassingsmodel, wat betekent dat u bij het installeren van de Azure SDK de versie van Azure diagnostics hebt ontvangen.

Vanaf SDK 2.5 (diagnostische versie 1.2) is Azure diagnostische gegevens naar een extensiemodel gegaan. De hulpprogramma's voor het gebruik van nieuwe functies waren alleen beschikbaar in nieuwere Azure-SDK's, maar elke service die gebruikmaakt van Azure diagnostische gegevens, haalt de nieuwste verzendversie rechtstreeks vanaf 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 Azure diagnostische gegevens maken gebruik van verschillende configuratieschema's. Schema 1.0 en 1.2 zijn afgeschaft. Zie Diagnostische gegevens 1.3 en hoger voor meer informatie over versie 1.3 en hoger.

Versiegeschiedenis

In de volgende secties worden de wijzigingen beschreven die zijn aangebracht in elke versie van de diagnostische extensie.

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 VIRTUELE machine, Virtual Machine Scale Sets of cloudservice om te Azure Monitor als aangepaste metrische gegevens. De Azure Monitor sink ondersteunt:

• Alle prestatiemeteritems ophalen die naar Azure Monitor worden verzonden via de Azure Monitor api's voor metrische gegevens.
• Waarschuwingen voor alle prestatiemeteritems die via de nieuwe ervaring unified alerts worden verzonden naar Azure Monitor 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. Hiermee kunt u voor elke logische schijf tekenen of waarschuwen voor schrijfbewerkingen per seconde. Bijvoorbeeld, C:D:enzovoort.

Definieer Azure Monitor als een nieuwe sink in de configuratie van uw diagnostische extensie

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

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

Vervolgens kunt u uw prestatiemeteritems zo configureren dat ze 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 Azure Event Hubs 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. De verbindingsreeks UseDevelopmentStorage=true maakt het verzamelen van diagnostische gegevens mogelijk 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 opslagaccount voor diagnostische gegevens verbindingsreeks (Microsoft. WindowsAzure.Plugins.Diagnostics.ConnectionString) wordt opnieuw opgeslagen in het serviceconfiguratiebestand (.cscfg). In Azure SDK 2.5 is het opslagaccount voor diagnostische gegevens opgegeven in het bestand diagnostics.wadcfgx.

Er zijn enkele belangrijke verschillen tussen de manier waarop 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 werd de verbindingsreeks tijdens runtime gebruikt door de diagnostische invoegtoepassing om de gegevens van het opslagaccount op te halen voor het overdragen van diagnostische logboeken.
• In Azure SDK 2.6 en hoger gebruikt Visual Studio de diagnostische verbindingsreeks om de extensie voor diagnostische gegevens 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 invoegtoepassing voor diagnostische gegevens echter niet meer beschikbaar is (na Azure SDK 2.5), kan het CSCFG-bestand zelf 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 opslagaccountgegevens 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 gebruikt door de Azure-portal om toegang te krijgen tot de diagnostische gegevens, zodat deze kunnen worden weergegeven op het tabblad Monitoring. De verbindingsreeks is nodig om de service te configureren om uitgebreide bewakingsgegevens in de portal weer te geven.

Projecten migreren naar Azure SDK 2.6 en hoger

Wanneer u migreert van Azure SDK 2.5 naar Azure SDK 2.6 of hoger, als u een diagnostisch opslagaccount hebt opgegeven in het wadcfgx-bestand, blijft het daar. 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 verbindingsreeksen behouden. Let echter op de wijzigingen in de wijze waarop verbindingsreeksen worden behandeld in Azure SDK 2.6, zoals opgegeven in de vorige sectie.

Hoe Visual Studio het opslagaccount voor diagnostische gegevens bepaalt

• Als een diagnostische verbindingsreeks is opgegeven in het CSCFG-bestand, Visual Studio deze gebruikt om de extensie voor diagnostische gegevens 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 naar het opslagaccount dat is opgegeven in het .wadcfgx-bestand. Het maakt gebruik van dit opslagaccount om de diagnostische extensie te configureren bij het publiceren en om de XML-bestanden van de openbare configuratie te genereren 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 de verbindingsreeksen voor opslag voor ontwikkeling bijwerken... selectievakje doet

Het selectievakje voor Bijwerken van opslagverbindingstekenreeksen voor opslag voor diagnostische gegevens en caching met Microsoft Azure opslagaccountreferenties bij het publiceren naar Microsoft Azure biedt u een handige manier om verbindingsreeksen voor ontwikkelingsopslagaccounts bij te werken met het Azure opslagaccount dat tijdens het publiceren is opgegeven.

Stel dat u het selectievakje inschakelt en de diagnostische gegevens verbindingsreeks UseDevelopmentStorage=true. Wanneer u het project naar Azure publiceert, Visual Studio de diagnostische gegevens automatisch bijwerken verbindingsreeks met het opslagaccount dat u hebt opgegeven in de wizard Publiceren. Als echter een echt opslagaccount is opgegeven als de 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 van 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 overgebracht tijdens de migratie naar Azure SDK 2.6.