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

Ez a cikk a Microsoft Azure SDK részeként szállított Windows (WAD) sémaverziókHoz készült Azure Diagnostics-bővítmény 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	Modell
1.x	1.0	beépülő modul
2.0 - 2.4	1.0	beépülő modul
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	"

Az Azure Diagnostics 1.0-s verziójá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 vele.

Az SDK 2.5 -től kezdve (1.2-es diagnosztikai verzió) az Azure-diagnosztika egy bővítménymodellre került. Az új funkciók használatához szükséges 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é át a legújabb szállítási verziót. Ha például az SDK 2.5-öt továbbra is használja, az betölti az előző táblázatban látható legújabb verziót, függetlenül attól, hogy az újabb funkciókat használja-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 vonatkozik. Lehetővé teszi, hogy a virtuális gépen, a VMSS-en vagy a felhőszolgáltatáson gyűjtött teljesítményszámlálókat egyéni metrikákként küldje el az Azure Monitornak. 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ás az Azure Monitorba küldött összes teljesítményszámlálóról az Azure Monitor új egységes 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, akkor a "Példány" dimenzióra szűrve és felosztva ábrázolhatja vagy riasztást jeleníthet meg az egyes logikai lemezek lemezírásán (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>

Feljegyzés

Az Azure Monitor fogadó klasszikus virtuális gépekhez és klasszikus CLoud szolgáltatáshoz való konfigurálásához további paramétereket kell definiálni a Diagnostics 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

Docker-támogatás hozzáadva.

Diagnosztikai bővítmény 1.8.1

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

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

Tárolótípus hozzáadva a PublicConfighoz. A StorageType lehet Table, Blob, TableAndBlob. A táblázat 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, és lehetővé tette diagnosztikai adatok küldését az Application Insightsba, így egyszerűbben diagnosztizálhatja az alkalmazáson belüli problémákat, valamint a rendszer- és infrastruktúraszintet.

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

A Visual Studio Cloud Service-projektjei 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 megfelelő nyomkövetéseket hoz létre a Visual Studióban való fejlesztés és tesztelés során. A kapcsolati sztring UseDevelopmentStorage=true az Azure Storage Emulator használatával teszi lehetővé a diagnosztikai adatgyűjtést, miközben a Felhőszolgáltatás-projektet a Visual Studióban futtatja. A rendszer minden diagnosztikai adatot a (Development Storage) tárfiókban gyűjt.
• 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 a diagnostics.wadcfgx fájlban lett megadva.

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 való működése között jelentős különbségek vannak.

• 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 lehetővé teszi, hogy különböző tárfiókokat definiáljon 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 követik a mintát PaaSDiagnostics.<RoleName>.PubConfig.xml. Bármely PowerShell-alapú üzembe helyezés ezt a mintát használhatja az egyes konfigurációk szerepkörökhöz való leképezéséhez.
• A .cscfg fájlban található kapcsolati sztring az Azure Portal is használja a diagnosztikai adatok eléréséhez, hogy azok megjelenjenek a Figyelés lapon. A kapcsolati sztring konfigurálnia kell a szolgáltatást, 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 a .wadcfgx fájlban megadott diagnosztikai tárfiók van megadva, az ott marad. Ha szeretné kihasználni 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, akkor a diagnosztikai kapcsolati sztring megmaradnak. Vegye figyelembe azonban a kapcsolati sztring kezelésének változásait az Azure SDK 2.6-ban 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ása során történő konfigurálásához használja a diagnosztikai bővítményt.
• Ha nincs megadva diagnosztikai kapcsolati sztring 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 csomagoláskor létrehozza a nyilvános konfigurációs XML-fájlokat.
• A .cscfg fájlban kapcsolati sztring diagnosztikai kapcsolati sztring elsőbbséget élvez a .wadcfgx fájl tárfiókja felett. Ha egy diagnosztikai kapcsolati sztring van megadva a .cscfg fájlban, akkor a Visual Studio ezt használja, és figyelmen kívül hagyja a .wadcfgx tárfiókot.

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

A Microsoft Azure-ban való közzétételkor a Microsoft Azure-beli közzétételkor a Diagnosztikai és gyorsítótárazási kapcsolati sztring frissítési fejlesztési tár kapcsolati sztring jelölőnégyzetével kényelmesen frissítheti a fejlesztői tár kapcsolati sztring fiókokat a közzététel során megadott Azure Storage-fiókkal.

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

Diagnosztikai funkciók közötti különbségek az Azure SDK 2.4 és korábbi, 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-ben 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, 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őalapú szolgáltatásalkalmazások diagnosztikái csak szerepkörszinten konfigurálhatók, példányszinten nem.
• Minden alkalommal, amikor telepíti az alkalmazást, a diagnosztikai konfiguráció frissül – Ez paritásos problémákat okozhat, ha módosítja a diagnosztikai konfigurációt a Kiszolgálókezelőben, 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 kódban – Ha kódban konfigurált összeomlási memóriaképeket, manuálisan kell átvinnie a konfigurációt a kódból a konfigurációs fájlba, mert az összeomlási memóriaképek nem lesznek átadva az Azure SDK 2.6-ra való migrálás során.