Konfigurationsschemaversioner och historik för Microsoft Azure Diagnostics-tillägg (WAD)

Den här artikeln innehåller versionshistoriken för Azure Diagnostics-tillägget för Windows (WAD) schemaversioner som levereras som en del av Microsoft Azure SDKs.

leveransdiagram för Azure SDKs- och diagnostikversioner

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

Från och med SDK 2.5 (diagnostikversion 1.2) gick Azure diagnostik 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 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

I följande avsnitt beskrivs de ändringar som görs i varje version av diagnostiktillägget.

Diagnostiktillägg 1.11

Stöd har lagts till för Azure Monitor mottagare. 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, Virtual Machine Scale Sets eller molntjänst för att Azure Monitor som anpassade mått. Den Azure Monitor mottagaren stöder:

• Hämtar alla prestandaräknare som skickas till Azure Monitor via API:erna Azure Monitor metrics.
• Aviseringar för alla prestandaräknare som skickas till Azure Monitor via den nya unified alerts experience 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/s" skulle du kunna filtrera och dela på dimensionen "Instance". Det gör att du kan rita eller avisera på diskskrivningar/s för varje logisk disk. Till exempel C:, D:och så vidare.

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

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

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

Därefter kan du konfigurera att dina prestandaräknare 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

Möjligheten att dirigera till Azure Event Hubs har lagts till.

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 SDKs 2.6 och diagnostiktillägget 1.3

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

• 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. reťazec pripojenia 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 reťazec pripojenia (Microsoft. WindowsAzure.Plugins.Diagnostics.ConnectionString) lagras återigen i tjänstkonfigurationsfilen (.cscfg). I Azure SDKs 2.5 angavs diagnostiklagringskontot i filen diagnostics.wadcfgx.

Det finns några anmärkningsvärda skillnader mellan hur reťazec pripojenia fungerade i Azure SDKs 2.4 och tidigare och hur det fungerar i Azure SDKs 2.6 och senare.

• I Azure SDKs 2.4 och tidigare användes reťazec pripojenia 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 SDKs 2.6 och senare använder Visual Studio diagnostiken reťazec pripojenia för att konfigurera diagnostiktillägget med lämplig lagringskontoinformation under publiceringen. Med reťazec pripojenia kan du definiera olika lagringskonton för olika tjänstkonfigurationer som Visual Studio använder vid publicering. Eftersom plugin-programmet för diagnostik inte längre är tillgängligt (efter Azure SDKs 2.5) kan cscfg-filen 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 reťazec pripojenia 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.
• Connection string i .cscfg-filen används också av Azure-portalen för att komma åt diagnostikdata så att de kan visas på fliken Övervaka. Connection string krävs för att konfigurera tjänsten så att den visar utförliga övervakningsdata i portalen.

Migrera projekt till Azure SDKs 2.6 och senare

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

Så här avgör Visual Studio diagnostiklagringskontot

• Om en diagnostik reťazec pripojenia anges i .cscfg-filen använder Visual Studio den för att konfigurera diagnostiktillägget vid publicering och när du genererar xml-filerna för offentlig konfiguration under paketeringen.
• Om ingen diagnostik reťazec pripojenia anges i .cscfg-filen återgår Visual Studio till att använda det lagringskonto som anges i .wadcfgx-filen. Det använder det här lagringskontot för att konfigurera diagnostiktillägget vid publicering och för att generera xml-filerna för offentlig konfiguration vid paketering.
• Diagnostiken reťazec pripojenia i .cscfg-filen har företräde framför lagringskontot i .wadcfgx-filen. Om en diagnostik reťazec pripojenia anges i .cscfg-filen använder Visual Studio den och ignorerar lagringskontot i .wadcfgx.

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

Kryssrutan för Update development storage connection strings for Diagnostics and Caching with Microsoft Azure storage account credentials when publishing to Microsoft Azure ger dig ett bekvämt sätt att uppdatera anslutningssträngar för utvecklingslagringskonton med det Azure lagringskonto som angavs under publiceringen.

Anta till exempel att du markerar kryssrutan och diagnostiken reťazec pripojenia anger UseDevelopmentStorage=true. När du publicerar projektet till Azure uppdaterar Visual Studio diagnostiken automatiskt reťazec pripojenia med det lagringskonto som du angav i guiden Publicera. Men om ett verkligt lagringskonto har angetts som diagnostiken reťazec pripojenia används kontot i stället.

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

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

• Konfigurations-API:er är inaktuella – Programmatisk konfiguration av diagnostik finns i Azure SDKs 2.4 eller tidigare versioner, men är inaktuell i Azure SDKs 2.5 och senare. Om diagnostikkonfigurationen för närvarande har definierats 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 SDKs 2.4 är diagnostics.wadcfg och diagnostics.wadcfgx för Azure SDKs 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 – Det kan orsaka paritetsproblem om du ändrar diagnostikkonfigurationen från Server Explorer och sedan distribuerar om appen.
• In Azure SDKs 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 SDKs 2.6.