Sdílet prostřednictvím

Verze a historie schématu konfigurace rozšíření Windows Azure Diagnostics (WAD)

  • Článek

Tento článek obsahuje historii verzí rozšíření Azure Diagnostics pro verze schématu Windows (WAD) dodávaná jako součást sady Microsoft Azure SDK.

Expediční graf sady Azure SDK a diagnostických verzí

Verze sady Azure SDK Verze rozšíření diagnostiky Model
1.x 1.0 modul plug-in
2.0 - 2.4 1.0 modul plug-in
2.5 1.2 přípona
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 "

Služba Azure Diagnostics verze 1.0 byla poprvé dodána v modelu plug-in, což znamená, že při instalaci sady Azure SDK jste získali verzi diagnostiky Azure.

Počínaje sadou SDK 2.5 (diagnostická verze 1.2) přešla diagnostika Azure do modelu rozšíření. Nástroje pro využití nových funkcí byly dostupné jenom v novějších sadách Azure SDK, ale všechny služby využívající diagnostiku Azure by získaly nejnovější dodací verzi přímo z Azure. Například každý, kdo stále používá sadu SDK 2.5, by načetl nejnovější verzi uvedenou v předchozí tabulce bez ohledu na to, jestli používá novější funkce.

Index schémat

Různé verze diagnostiky Azure používají různá schémata konfigurace. Schéma 1.0 a 1.2 jsou zastaralé. Další informace o verzi 1.3 a novějších najdete v tématu Diagnostické schéma 1.3 a novější.

Historie verzí

Rozšíření diagnostiky 1.11

Přidání podpory pro jímku služby Azure Monitor Tato jímka se vztahuje pouze na čítače výkonu. Umožňuje odesílat čítače výkonu shromážděné na virtuálním počítači, VMSS nebo cloudové službě do služby Azure Monitor jako vlastní metriky. Jímka služby Azure Monitor podporuje:

  • Načítání všech čítačů výkonu odeslaných do služby Azure Monitor prostřednictvím rozhraní API metrik služby Azure Monitor
  • Upozorňování na všechny čítače výkonu odeslané do služby Azure Monitor prostřednictvím nového sjednoceného prostředí upozornění ve službě Azure Monitor
  • Zacházení s operátorem zástupných znaků v čítačích výkonu jako dimenze Instance v metrice. Pokud jste například shromáždili čítač Logický disk(*)/DiskWrites/sec, můžete filtrovat a rozdělit dimenzi Instance tak, aby se vykreslovala nebo upozorňovala na zápisy na disk za sekundu pro každý logický disk (C:, D:atd.).

Definování služby Azure Monitor jako nové jímky v konfiguraci rozšíření diagnostiky

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

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

Poznámka:

Konfigurace jímky Azure Monitoru pro klasické virtuální počítače a službu CLoud Classic vyžaduje, aby se v privátní konfiguraci rozšíření diagnostiky definovalo více parametrů.

Další podrobnosti najdete v dokumentaci k podrobnému schématu rozšíření diagnostiky.

Dále můžete nakonfigurovat čítače výkonu tak, aby se směrovaly do jímky služby Azure Monitor.

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

Rozšíření diagnostiky 1.9

Přidali jsme podporu Dockeru.

Rozšíření diagnostiky 1.8.1

V privátní konfiguraci může místo klíče účtu úložiště zadat token SAS. Pokud je k dispozici token SAS, klíč účtu úložiště se ignoruje.

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

Rozšíření diagnostiky 1.8

Přidání typu úložiště do PublicConfig StorageType může být Table, Blob, TableAndBlob. Tabulka je výchozí.

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

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

Rozšíření diagnostiky 1.7

Přidání možnosti směrování do EventHubu

Rozšíření diagnostiky 1.5

Přidali jsme prvek jímek a možnost odesílat diagnostická data do Application Insights , což usnadňuje diagnostiku problémů napříč vaší aplikací a úrovní systému a infrastruktury.

Rozšíření Azure SDK 2.6 a diagnostika 1.3

V případě projektů cloudových služeb v sadě Visual Studio byly provedeny následující změny. (Tyto změny platí také pro novější verze sady Azure SDK.)

  • Místní emulátor teď podporuje diagnostiku. Tato změna znamená, že během vývoje a testování v sadě Visual Studio můžete shromažďovat diagnostická data a zajistit, aby vaše aplikace vytvářela správné trasování. Připojovací řetězec UseDevelopmentStorage=true umožňuje shromažďování diagnostických dat při spouštění projektu cloudové služby v sadě Visual Studio pomocí emulátoru úložiště Azure. Všechna diagnostická data se shromažďují v účtu úložiště (Development Storage).
  • Účet úložiště diagnostiky připojovací řetězec (Microsoft.WindowsAzure.Plugins.Diagnostics.ConnectionString) se znovu uloží v souboru konfigurace služby (.cscfg). V sadě Azure SDK 2.5 byl v souboru diagnostics.wadcfgx zadán účet diagnostického úložiště.

Mezi fungováním připojovací řetězec v sadě Azure SDK 2.4 a staršími a jeho fungováním v sadě Azure SDK 2.6 a novějším existují některé z hledných rozdílů.

  • V sadě Azure SDK 2.4 a starších používal modul plug-in diagnostiky připojovací řetězec k získání informací o účtu úložiště pro přenos diagnostických protokolů.
  • Visual Studio v sadě Azure SDK 2.6 a novější používá diagnostické připojovací řetězec ke konfiguraci rozšíření diagnostiky s odpovídajícími informacemi o účtu úložiště během publikování. Připojovací řetězec umožňuje definovat různé účty úložiště pro různé konfigurace služeb, které sada Visual Studio použije při publikování. Vzhledem k tomu, že modul plug-in diagnostiky už není k dispozici (po sadě Azure SDK 2.5), nemůže samotný soubor .cscfg povolit rozšíření diagnostiky. Rozšíření musíte povolit samostatně prostřednictvím nástrojů, jako je Visual Studio nebo PowerShell.
  • Pro zjednodušení procesu konfigurace rozšíření diagnostiky pomocí PowerShellu obsahuje výstup balíčku ze sady Visual Studio také kód XML veřejné konfigurace pro rozšíření diagnostiky pro každou roli. Visual Studio používá diagnostické připojovací řetězec k naplnění informací o účtu úložiště, které jsou přítomné ve veřejné konfiguraci. Veřejné konfigurační soubory jsou vytvořeny ve složce Extensions a postupujte podle vzoru PaaSDiagnostics.<RoleName>.PubConfig.xml. Všechna nasazení založená na PowerShellu můžou tento model použít k mapování jednotlivých konfigurací na roli.
  • Azure Portal také používá připojovací řetězec v souboru .cscfg pro přístup k diagnostickým datům, aby se zobrazila na kartě Monitorování. Připojovací řetězec je potřeba ke konfiguraci služby tak, aby zobrazovala podrobná data monitorování na portálu.

Migrace projektů do sady Azure SDK 2.6 a novější

Pokud jste při migraci ze sady Azure SDK 2.5 na Sadu Azure SDK 2.6 nebo novější měli účet úložiště diagnostiky zadaný v souboru .wadcfgx, zůstane tam. Pokud chcete využít flexibilitu používání různých účtů úložiště pro různé konfigurace úložiště, budete muset do projektu přidat připojovací řetězec ručně. Pokud migrujete projekt ze sady Azure SDK 2.4 nebo starší do sady Azure SDK 2.6, zachovají se diagnostické připojovací řetězec. Všimněte si však změn způsobu, jakým se připojovací řetězec v sadě Azure SDK 2.6 zpracovávají, jak je uvedeno v předchozí části.

Jak Sada Visual Studio určuje účet úložiště diagnostiky

  • Pokud je v souboru .cscfg zadána diagnostika připojovací řetězec, Visual Studio ho použije ke konfiguraci rozšíření diagnostiky při publikování a při generování veřejných konfiguračních souborů XML během balení.
  • Pokud v souboru .cscfg není zadána žádná diagnostická připojovací řetězec, sada Visual Studio se vrátí k použití účtu úložiště zadaného v souboru .wadcfgx pro konfiguraci rozšíření diagnostiky při publikování a generování souborů XML veřejné konfigurace při balení.
  • Diagnostická připojovací řetězec v souboru .cscfg má přednost před účtem úložiště v souboru .wadcfgx. Pokud je v souboru .cscfg zadána diagnostika připojovací řetězec, sada Visual Studio ji použije a ignoruje účet úložiště v souboru .wadcfgx.

Co dělá aktualizace vývojového úložiště připojovací řetězec..." zaškrtněte políčko?

Zaškrtávací políčko pro úložiště pro vývoj aktualizací připojovací řetězec pro diagnostiku a ukládání do mezipaměti s přihlašovacími údaji účtu úložiště Microsoft Azure při publikování do Microsoft Azure poskytuje pohodlný způsob, jak aktualizovat jakýkoli vývojový účet úložiště připojovací řetězec s účtem úložiště Azure zadaným během publikování.

Předpokládejme například, že toto políčko zaškrtnete a připojovací řetězec diagnostiky určíte UseDevelopmentStorage=true. Když projekt publikujete do Azure, Sada Visual Studio automaticky aktualizuje diagnostické připojovací řetězec pomocí účtu úložiště, který jste zadali v průvodci publikováním. Pokud se ale jako diagnostický připojovací řetězec zadal skutečný účet úložiště, použije se tento účet.

Rozdíly mezi funkcemi diagnostiky mezi sadou Azure SDK 2.4 a staršími a sadami Azure SDK 2.5 a novějšími

Pokud upgradujete projekt ze sady Azure SDK 2.4 na Sadu Azure SDK 2.5 nebo novější, měli byste mít na paměti následující rozdíly ve funkcích diagnostiky.

  • Rozhraní API konfigurace jsou zastaralá – Programová konfigurace diagnostiky je dostupná ve verzi Azure SDK 2.4 nebo starších verzích, ale je zastaralá v sadě Azure SDK 2.5 a novější. Pokud je konfigurace diagnostiky aktuálně definovaná v kódu, budete muset tato nastavení v migrovaném projektu překonfigurovat úplně od začátku, aby diagnostika mohla dál fungovat. Konfigurační soubor diagnostiky pro Azure SDK 2.4 je diagnostics.wadcfg a diagnostics.wadcfgx pro Azure SDK 2.5 a novější.
  • Diagnostiku pro aplikace cloudové služby je možné nakonfigurovat pouze na úrovni role, nikoli na úrovni instance.
  • Pokaždé, když nasadíte aplikaci, aktualizuje se konfigurace diagnostiky – To může způsobit problémy s paritou, pokud změníte konfiguraci diagnostiky z Průzkumníka serveru a pak aplikaci znovu nasadíte.
  • V sadě Azure SDK 2.5 a novějších se výpisy stavu systému konfigurují v konfiguračním souboru diagnostiky, ne v kódu – Pokud máte nakonfigurované výpisy stavu systému v kódu, budete muset konfiguraci ručně přenést z kódu do konfiguračního souboru, protože výpisy stavu systému se během migrace do sady Azure SDK 2.6 nepřenesou.