Share via

Windows Azure Diagnostics bővítmény (WAD) konfigurációs sémaverziói és előzményei

  • Cikk

Ez a cikk a Microsoft Azure SDK részeként szállított windowsos (WAD) sémaverziók Azure Diagnostics bővítményének verzióelőzményeit ismerteti.

Az Azure SDK és a diagnosztikai verziók szállítási diagramja

Azure SDK-verzió Diagnosztikai bővítmény verziója Modellezés
1.x 1.0 Plug-in
2.0 - 2.4 1.0 Plug-in
2.5 1.2 bővítmény
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 1.0-s verziót először egy beépülő modulmodellben szállították le , ami azt jelenti, hogy az Azure SDK telepítésekor az Azure-diagnosztika verzióját szállította hozzá.

Az SDK 2.5-től (diagnosztika 1.2-es verziójától) kezdve az Azure-diagnosztika egy bővítménymodellre váltott. Az új funkciók használatára szolgáló eszközök csak az újabb Azure SDK-kban voltak elérhetők, de az Azure-diagnosztika használatával bármely szolgáltatás közvetlenül az Azure-ból venné fel a legújabb szállítási verziót. Az SDK 2.5-öt továbbra is használó felhasználók például az előző táblázatban látható legújabb verziót töltik be, függetlenül attól, hogy az újabb funkciókat használják-e.

Sémaindex

Az Azure-diagnosztika különböző verziói különböző konfigurációs sémákat használnak. Az 1.0-s és az 1.2-s séma elavult. További információ az 1.3-es és újabb verzióról: Diagnostics 1.3 és újabb konfigurációs séma

Korábbi verziók

Diagnosztikai bővítmény 1.11

Az Azure Monitor-fogadó támogatása hozzáadva. Ez a fogadó csak teljesítményszámlálókra alkalmazható. Lehetővé teszi a virtuális gépen, a VMSS-en vagy a felhőszolgáltatáson gyűjtött teljesítményszámlálók küldését az Azure Monitorba egyéni metrikákként. Az Azure Monitor-fogadó a következőket támogatja:

  • Az Azure Monitornak küldött összes teljesítményszámláló lekérése az Azure Monitor metrika API-jaival.
  • Riasztások az Azure Monitorba küldött összes teljesítményszámlálón az Azure Monitor új egyesített riasztási felületén keresztül
  • A teljesítményszámlálók helyettesítő karaktereinek kezelése a metrika "Példány" dimenziójaként. Ha például a "LogicalDisk(*)/DiskWrites/sec" számlálót gyűjtötte össze, szűrheti és feloszthatja a "Instance" dimenziót, hogy ábrázolja vagy riasztást jelenítsen meg az egyes logikai lemezek lemezírási számain (C:, D:stb.)

Az Azure Monitor definiálása új fogadóként a diagnosztikai bővítmény konfigurációjában

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

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

Megjegyzés

Az Azure Monitor-fogadó konfigurálásához a klasszikus virtuális gépekhez és a klasszikus CLoud szolgáltatáshoz több paramétert kell definiálni a Diagnosztikai bővítmény privát konfigurációjában.

További részletekért tekintse meg a diagnosztikai bővítmény sémadokumentációját.

Ezután konfigurálhatja a teljesítményszámlálókat úgy, hogy az az Azure Monitor-fogadóhoz legyen irányítva.

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

Diagnosztikai bővítmény 1.9

Hozzáadta a Docker-támogatást.

Diagnosztikai bővítmény 1.8.1

Megadhat SAS-jogkivonatot a tárfiókkulcs helyett a privát konfigurációban. Sas-jogkivonat megadása esetén a rendszer figyelmen kívül hagyja a tárfiókkulcsot.

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

Diagnosztikai bővítmény 1.8

Hozzáadta a Tártípust a PublicConfighoz. A StorageType lehet Table, Blob, TableAndBlob. A tábla az alapértelmezett.

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

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

Diagnosztikai bővítmény 1.7

Hozzáadta az EventHubra való átirányítás lehetőségét.

Diagnosztikai bővítmény 1.5

Hozzáadta a fogadók elemet, valamint a diagnosztikai adatok Application Insightsba való küldésének képességét, így könnyebben diagnosztizálhatóak az alkalmazáson belüli problémák, valamint a rendszer- és infrastruktúraszint.

Azure SDK 2.6 és diagnosztikai bővítmény 1.3

A Visual Studióban futó Cloud Service-projektek esetében a következő módosítások történtek. (Ezek a módosítások az Azure SDK későbbi verzióira is érvényesek.)

  • A helyi emulátor mostantól támogatja a diagnosztikát. Ez a változás azt jelenti, hogy diagnosztikai adatokat gyűjthet, és meggyőződhet arról, hogy az alkalmazás a megfelelő nyomkövetéseket hozza létre a Visual Studióban történő fejlesztés és tesztelés során. A kapcsolati sztring UseDevelopmentStorage=true az Azure Storage Emulator használatával engedélyezi a diagnosztikai adatgyűjtést a felhőszolgáltatás-projekt Visual Studióban való futtatása során. A rendszer az összes diagnosztikai adatot a (Development Storage) tárfiókban gyűjti.
  • A diagnosztikai tárfiók kapcsolati sztring (Microsoft.WindowsAzure.Plugins.Diagnostics.ConnectionString) ismét a szolgáltatáskonfigurációs (.cscfg) fájlban lesz tárolva. Az Azure SDK 2.5-ben a diagnosztikai tárfiók meg van adva a diagnostics.wadcfgx fájlban.

Jelentős különbségek vannak a kapcsolati sztring működése az Azure SDK 2.4-ben és a korábbi verziókban, valamint az Azure SDK 2.6-os és újabb verzióiban.

  • Az Azure SDK 2.4-ben és korábbi verzióiban a diagnosztikai beépülő modul futásidőben használta a kapcsolati sztring a diagnosztikai naplók átviteléhez szükséges tárfiókadatok lekéréséhez.
  • Az Azure SDK 2.6-os és újabb verzióiban a Visual Studio a diagnosztikai kapcsolati sztring használatával konfigurálja a diagnosztikai bővítményt a megfelelő tárfiókadatokkal a közzététel során. A kapcsolati sztring különböző tárfiókokat definiálhat a Visual Studio által a közzétételkor használni kívánt különböző szolgáltatáskonfigurációkhoz. Mivel azonban a diagnosztikai beépülő modul már nem érhető el (az Azure SDK 2.5 után), a .cscfg fájl önmagában nem tudja engedélyezni a Diagnosztikai bővítményt. A bővítményt külön kell engedélyeznie olyan eszközökkel, mint a Visual Studio vagy a PowerShell.
  • A diagnosztikai bővítmény PowerShell-lel való konfigurálásának egyszerűsítése érdekében a Visual Studio csomagkimenete az egyes szerepkörökhöz tartozó diagnosztikai bővítmény nyilvános konfigurációs XML-fájlját is tartalmazza. A Visual Studio a diagnosztikai kapcsolati sztring használja a nyilvános konfigurációban található tárfiókadatok feltöltéséhez. A nyilvános konfigurációs fájlok a Bővítmények mappában jönnek létre, és a következő mintát PaaSDiagnostics.<RoleName>.PubConfig.xmlkövetik: . Bármely PowerShell-alapú üzembe helyezés ezt a mintát használhatja az egyes konfigurációk szerepkörhöz való leképezéséhez.
  • A .cscfg fájlban lévő kapcsolati sztring a Azure Portal is használja a diagnosztikai adatok eléréséhez, hogy azok megjelenhessenek a Figyelés lapon. A kapcsolati sztring a szolgáltatás konfigurálásához szükséges, hogy részletes monitorozási adatokat jelenítsen meg a portálon.

Projektek migrálása az Azure SDK 2.6-os és újabb verzióiba

Ha az Azure SDK 2.5-ről az Azure SDK 2.6-os vagy újabb verziójára migrál, ha rendelkezik a .wadcfgx fájlban megadott diagnosztikai tárfiókkal, az ott marad. Ahhoz, hogy kihasználhassa a különböző tárfiókok különböző tárolási konfigurációkhoz való használatának rugalmasságát, manuálisan kell hozzáadnia a kapcsolati sztring a projekthez. Ha egy projektet az Azure SDK 2.4-ről vagy korábbi verzióról az Azure SDK 2.6-ra migrál, a diagnosztikai kapcsolati sztringek megmaradnak. Vegye figyelembe azonban a kapcsolati sztringek azure SDK 2.6-ban való kezelésének változásait az előző szakaszban megadottak szerint.

Hogyan határozza meg a Visual Studio a diagnosztikai tárfiókot?

  • Ha a .cscfg fájlban diagnosztikai kapcsolati sztring van megadva, a Visual Studio a közzétételkor és a nyilvános konfigurációs XML-fájlok csomagolás közbeni konfigurálásához használja a diagnosztikai bővítmény konfigurálására.
  • Ha nincs diagnosztikai kapcsolati sztring megadva a .cscfg fájlban, akkor a Visual Studio a .wadcfgx fájlban megadott tárfiók használatával konfigurálja a diagnosztikai bővítményt a közzétételkor, és a csomagoláskor létrehozza a nyilvános konfigurációs XML-fájlokat.
  • A .cscfg fájlban kapcsolati sztring diagnosztika elsőbbséget élvez a .wadcfgx fájlban lévő tárfiókkal szemben. Ha a .cscfg fájlban diagnosztikai kapcsolati sztring van megadva, akkor a Visual Studio ezt használja, és figyelmen kívül hagyja a tárfiókot a .wadcfgx fájlban.

Mit jelent a "Fejlesztési tár kapcsolati sztringjeinek frissítése..." jelölőnégyzetet?

A Fejlesztői tár kapcsolati sztringjeinek frissítése a Microsoft Azure-beli közzétételkor a Microsoft Azure-beli tárfiók hitelesítő adataival történő diagnosztikai és gyorsítótárazási szolgáltatáshoz jelölőnégyzet kényelmes módot kínál a fejlesztői tárfiókok kapcsolati sztringjeinek frissítésére a közzététel során megadott Azure-tárfiókkal.

Tegyük fel például, hogy bejelöli ezt a jelölőnégyzetet, és a diagnosztika kapcsolati sztring adja meg.UseDevelopmentStorage=true Amikor közzéteszi a projektet az Azure-ban, a Visual Studio automatikusan frissíti a diagnosztika kapcsolati sztring a Közzététel varázslóban megadott tárfiókkal. Ha azonban egy valódi tárfiók lett megadva a diagnosztika kapcsolati sztring, akkor a rendszer ezt a fiókot használja helyette.

Diagnosztikai funkciók eltérései az Azure SDK 2.4 és korábbi verziói, valamint az Azure SDK 2.5-ös és újabb verziói között

Ha az Azure SDK 2.4-ről az Azure SDK 2.5-ös vagy újabb verziójára frissíti a projektet, vegye figyelembe az alábbi diagnosztikai funkciók eltéréseit.

  • A konfigurációs API-k elavultak – A diagnosztika programozott konfigurációja az Azure SDK 2.4-es vagy korábbi verzióiban érhető el, de az Azure SDK 2.5-ös és újabb verzióiban elavult. Ha a diagnosztikai konfiguráció jelenleg kódban van definiálva, ezeket a beállításokat újra kell konfigurálnia a migrált projektben ahhoz, hogy a diagnosztikák továbbra is működjenek. Az Azure SDK 2.4 diagnosztikai konfigurációs fájlja a diagnostics.wadcfg és a diagnostics.wadcfgx az Azure SDK 2.5-ös és újabb verzióihoz.
  • A felhőszolgáltatási alkalmazások diagnosztikái csak szerepkörszinten konfigurálhatók, példányszinten nem.
  • Az alkalmazás minden telepítésekor frissül a diagnosztikai konfiguráció – Ez paritásos problémákat okozhat, ha módosítja a diagnosztikai konfigurációt a Kiszolgálókezelőről, majd újra üzembe helyezi az alkalmazást.
  • Az Azure SDK 2.5-ös és újabb verzióiban az összeomlási memóriaképek a diagnosztikai konfigurációs fájlban vannak konfigurálva, nem a kódban – Ha az összeomlási memóriaképek kódban vannak konfigurálva, manuálisan kell átvinnie a konfigurációt a kódból a konfigurációs fájlba, mivel az összeomlási memóriaképek nem lesznek átadva az Azure SDK 2.6-ra való migrálás során.