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

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.

Graf expedice sady Azure SDK a diagnostických verzí

Verze sady Azure SDK	Verze rozšíření diagnostiky	Modelování
1.x	1.0	Plug-in
2.0 - 2.4	1.0	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	"

Azure Diagnostics verze 1.0 byla poprvé dodána v modelu modulu plug-in – to znamená, že když jste nainstalovali sadu Azure SDK, dostali jste s ní verzi diagnostiky Azure.

Počínaje sadou SDK 2.5 (diagnostická verze 1.2) přešla diagnostika Azure k modelu rozšíření. Nástroje pro využití nových funkcí byly k dispozici pouze v novějších sadách Azure SDK, ale všechny služby využívající diagnostiku Azure by si nejnovější dodací verzi vyzvedávaly přímo z Azure. Například každý, kdo stále používá sadu SDK 2.5, by načítal 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 je 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í

Diagnostické rozšíření 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, škálovací sadě virtuálních počítačů 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 pro metriky služby Azure Monitor
• Upozorňování na všechny čítače výkonu odesílané do služby Azure Monitor prostřednictvím nového sjednoceného prostředí upozornění ve službě Azure Monitor
• Zachází se zástupným znakem v čítačích výkonu jako s dimenzí Instance ve vaší metrice. Pokud byste například shromáždili čítač Logický disk(*)/DiskWrites/s, mohli byste filtrovat a rozdělit dimenzi Instance a vykreslit nebo zobrazit upozornění na zápisy na disk/s pro každý logický disk (C:, D:, atd.).

Definování Služby Azure Monitor jako nové jímky v konfiguraci diagnostického rozšíření

"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í Diagnostics definovaly další parametry.

Další podrobnosti najdete v dokumentaci ke 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>

Diagnostické rozšíření 1.9

Přidání podpory Dockeru

Diagnostické rozšíření 1.8.1

V privátní konfiguraci můžete 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>

Diagnostické rozšíření 1.8

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

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

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

Diagnostické rozšíření 1.7

Přidali jsme možnost směrování do EventHubu.

Diagnostické rozšíření 1.5

Přidali jsme element jímek a možnost odesílat diagnostická data do Application Insights , což usnadňuje diagnostiku problémů v celé aplikaci i na úrovni systému a infrastruktury.

Azure SDK 2.6 a rozšíření diagnostiky 1.3

U 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 při vývoji 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).
• Připojovací řetězec účtu úložiště diagnostiky (Microsoft.WindowsAzure.Plugins.Diagnostics.ConnectionString) se znovu uloží do konfiguračního souboru služby (.cscfg). V sadě Azure SDK 2.5 byl účet úložiště diagnostiky zadaný v souboru diagnostics.wadcfgx.

Mezi fungováním připojovacího řetězce v sadě Azure SDK 2.4 a starší a v sadě Azure SDK 2.6 a novějšími verzemi existují některé nezastupitelné rozdíly.

• V sadě Azure SDK 2.4 a starších verzích použil modul plug-in diagnostiky připojovací řetězec za běhu k získání informací o účtu úložiště pro přenos diagnostických protokolů.
• V sadě Azure SDK 2.6 a novější používá Sada Visual Studio připojovací řetězec diagnostiky ke konfiguraci diagnostického rozšíření s příslušný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í dostupný (po sadě Azure SDK 2.5), soubor .cscfg sám o sobě nemůže rozšíření diagnostiky povolit. Rozšíření musíte povolit samostatně prostřednictvím nástrojů, jako je Visual Studio nebo PowerShell.
• Pro zjednodušení procesu konfigurace diagnostického rozšíření pomocí PowerShellu obsahuje výstup balíčku ze sady Visual Studio také veřejný konfigurační KÓD XML pro rozšíření diagnostiky pro jednotlivé role. Visual Studio pomocí připojovacího řetězce diagnostiky vyplní informace o účtu úložiště, které jsou součástí veřejné konfigurace. Veřejné konfigurační soubory se vytvářejí ve složce Extensions a používají vzor 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.
• Připojovací řetězec v souboru .cscfg používá také Azure Portal pro přístup k diagnostickým datům, aby se mohl zobrazit na kartě Monitorování. Připojovací řetězec je potřeba ke konfiguraci služby tak, aby se na portálu zobrazovala podrobná data monitorování.

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 v souboru .wadcfgx zadaný účet úložiště diagnostiky, 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 připojovací řetězec do projektu přidat ručně. Pokud migrujete projekt ze sady Azure SDK 2.4 nebo starší na sadu Azure SDK 2.6, připojovací řetězce diagnostiky se zachovají. Všimněte si ale změn ve způsobu, jakým se zachází s připojovacími řetězci v sadě Azure SDK 2.6, jak je uvedeno v předchozí části.

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

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

Co dělá "Aktualizace připojovacích řetězců vývojového úložiště..." zaškrtávací políčko ano?

Zaškrtávací políčko Aktualizace připojovacích řetězců vývojového úložiště pro diagnostiku a ukládání do mezipaměti pomocí přihlašovacích údajů účtu úložiště Microsoft Azure při publikování do Microsoft Azure nabízí pohodlný způsob, jak aktualizovat všechny připojovací řetězce vývojového účtu úložiště pomocí účtu úložiště Azure zadaného během publikování.

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

Rozdíly ve funkcích diagnostiky mezi sadou Azure SDK 2.4 a starší verzí a sadou Azure SDK 2.5 a novější

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 pro konfiguraci jsou zastaralá – programová konfigurace diagnostiky je k dispozici v sadě Azure SDK 2.4 nebo starších verzích, ale v sadě Azure SDK 2.5 a novějších verzích je zastaralá. Pokud je konfigurace diagnostiky aktuálně definovaná v kódu, budete muset tato nastavení v migrovaném projektu úplně od začátku nakonfigurovat, aby diagnostika dál fungovala. Konfigurační soubor diagnostiky pro Sadu Azure SDK 2.4 je diagnostics.wadcfg a diagnostics.wadcfgx pro Sadu 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, konfigurace diagnostiky se aktualizuje . 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 verzích se výpisy stavu systému konfigurují v konfiguračním souboru diagnostiky, nikoli v kódu . Pokud máte v kódu nakonfigurované výpisy stavu systému, 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 na Sadu Azure SDK 2.6 nepřenesou.