Windows Azure 診斷延伸模組 (WAD) 的設定結構描述版本和歷程記錄

發行項
06/01/2023

本文提供隨附於 Microsoft Azure SDK 的適用於 Windows (WAD) 的 Azure 診斷延伸模組架構版本的版本歷程記錄。

Azure SDK 和診斷版本推出方式圖表

Azure SDK 版本	診斷擴充功能版本	模型
1.x	1.0	外掛程式
2.0 - 2.4	1.0	外掛程式
2.5	1.2	擴充功能
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 診斷 1.0 版最早是隨附於外掛程式模型中，這表示當您安裝 Azure SDK 時，即會取得隨附於其中的 Azure 診斷版本。

從 SDK 2.5 (診斷版本 1.2) 開始，Azure 診斷變成延伸模型。運用新功能的工具只能在較新的 Azure SDK 中取得，但是，任何使用 Azure 診斷的服務都能直接從 Azure 挑選最新的上市版本。例如，仍在使用 SDK 2.5 的任何使用者都可以載入上表所示的最新版本，而不論使用者是否正在使用較新的功能。

結構描述索引

不同版本的 Azure 診斷會使用不同的組態結構描述。架構 1.0 和 1.2 已淘汰。如需 1.3 版和更新版本的詳細資訊，請參閱診斷 1.3 和更新版本的組態架構

版本歷程記錄

診斷擴充功能 1.11 版

已新增 Azure 監視器接收的支援。這個接收只適用於效能計數器。能夠將在 VM、VMSS 或雲端服務上收集的效能計數器，傳送到 Azure 監視器作為自訂計量。 Azure 監視器接收支援：

擷取透過 Azure 監視器計量 API 傳送到 Azure 監視器的所有效能計數器。
透過 Azure 監視器中新的統一的警示體驗，對傳送到 Azure 監視器的所有效能計數器設定警示
將效能計數器中的萬用字元運算子視為計量上的「執行個體」維度。例如，如果您收集了 "LogicalDisk(*)/DiskWrites/sec" 計數器，就能夠為每個邏輯磁碟 (C:、D: 等等)，針對 Disk Writes/sec 在「執行個體」維度上進行繪製或建立警示。

定義 Azure 監視器作為診斷擴充功能組態中的新接收

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

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

注意

設定傳統 VM 和傳統雲端服務中的 Azure 監視器接收，需要在診斷擴充功能的私用組態中定義更多參數。

如需詳細資訊，請參考詳細的診斷擴充功能結構描述文件。

接下來，您可以設定您的效能計數器，以路由至 Azure 監視器接收。

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

診斷擴充功能 1.9 版

已新增 Docker 支援。

診斷擴充功能 1.8.1 版

可以在私用設定中指定 SAS 權杖 (而不是儲存體帳戶金鑰)。如果提供 SAS 權杖，系統會忽略儲存體帳戶金鑰。

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

診斷擴充功能 1.8 版

已在 PublicConfig 中新增儲存體類型。 StorageType 可以是 Table、Blob、TableAndBlob。 Table 是預設值。

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

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

診斷擴充功能 1.7 版

已新增路由至 EventHub 的能力。

診斷延伸模組 1.5 版

已增加接收器元素以及將診斷資料傳送至 Application Insights 的能力，因此可更容易在應用程式以及系統和基礎結構層級中診斷問題。

Azure SDK 2.6 和診斷擴充功能 1.3 版

我們已對 Visual Studio 中的雲端服務專案進行下列變更。 (這些變更也套用至更新版的 Azure SDK)。

本機模擬器現在支援診斷。這項變更意謂著您可以在於 Visual Studio 中進行開發及測試時，收集診斷資料並確保應用程式所建立的追蹤正確。當您在 Visual Studio 中使用 Azure 儲存體模擬器來執行您的雲端服務專案時，連接字串 UseDevelopmentStorage=true 會啟用診斷資料收集。所有的診斷資料都會收集到 (開發儲存體) 儲存體帳戶中。
診斷儲存體帳戶連接字串 (Microsoft.WindowsAzure.Plugins.Diagnostics.ConnectionString) 會再一次儲存在服務組態 (.cscfg) 檔中。在 Azure SDK 2.5 中，診斷儲存體帳戶會在 diagnostics.wadcfgx 檔案中指定。

連接字串在 Azure SDK 2.4 及更舊版本和 Azure SDK 2.6 及更新版本中的運作方式有一些顯著的差異。

在 Azure SDK 2.4 及更舊版本中，診斷外掛程式會在執行階段使用連接字串，來取得用於傳輸診斷記錄的儲存體帳戶資訊。
在 Azure SDK 2.6 及更新版本中，Visual Studio 會在發佈期間，使用診斷連接字串為診斷延伸模組設定適當的儲存體帳戶資訊。連接字串可讓您為 Visual Studio 在發佈時將使用的不同服務組態定義不同的儲存體帳戶。不過，因為診斷外掛程式 (在 Azure SDK 2.5 之後) 不再提供使用，所以 .cscfg 檔案本身無法啟用診斷延伸模組。您必須個別透過 Visual Studio 或 PowerShell 等工具啟用延伸模組。
為了使用 PowerShell 簡化診斷延伸模組的設定程序，從 Visual Studio 的封裝輸出也包含每個角色之診斷延伸模組的公用組態 XML。 Visual Studio 使用診斷連接字串填入出現在公用組態的儲存體帳戶資訊。公用設定檔會在延伸模組資料夾中建立並遵循模式 PaaSDiagnostics.<RoleName>.PubConfig.xml。任何以 PowerShell 為基礎的部署都可以使用此模式將每個組態對應至角色。
Azure 入口網站也會使用 .cscfg 檔案中的連接字串來存取診斷資料，以便出現在 [監視] 索引標籤中。若要設定服務以在入口網站中顯示詳細監視資料，必須要有連接字串。

將專案移轉至 Azure SDK 2.6 及、更新版本

從 Azure SDK 2.5 移轉至 Azure SDK 2.6 或更新版本時，如果您在 .wadcfgx 檔案中指定診斷儲存體帳戶，它就會留在那裡。若要針對不同儲存體組態充分利用不同儲存體帳戶的靈活性，您必須手動將連接字串加入專案。如果您將專案從 Azure SDK 2.4 或更早版本移轉至 Azure SDK 2.6，系統會保留診斷連接字串。不過，請注意，在 Azure SDK 2.6 中連接字串的處理方式有所變更，如上一節中所述。

Visual Studio 如何決定診斷儲存體帳戶

如果在 .cscfg 檔案中指定診斷連接字串，Visual Studio 會在發佈時，以及在封裝期間產生公用組態 xml 檔案時使用它來設定診斷延伸模組。
如果未在 .cscfg 檔案中指定診斷連接字串，Visual Studio 會回復到在發佈時，以及在封裝期間產生公用組態 xml 檔案時使用在 .wadcfgx 檔案中指定的儲存體帳戶來設定診斷延伸模組。
在 .cscfg 檔案中的診斷連接字串的優先順序高於 .wadcfgx 檔案中的儲存體帳戶。如果在 .cscfg 檔案中指定診斷連接字串，Visual Studio 會使用它並忽略 .wadcfgx 中的儲存體帳戶。

「更新開發儲存體連接字串...」核取方塊的功用？

[發佈至 Microsoft Azure 時，使用 Microsoft Azure 儲存體帳戶認證來更新診斷和快取的開發儲存體連接字串] 核取方塊提供便利的方式，讓您以發行期間指定的 Azure 儲存體帳戶，更新任何開發儲存體帳戶連接字串。

例如，假設您選取此核取方塊，診斷連接字串就會指定 UseDevelopmentStorage=true。當您將專案發佈至 Azure 時，Visual Studio 會自動使用您在 [發佈] 精靈中指定的儲存體帳戶更新診斷連接字串。不過，如果將實際的儲存體帳戶指定為診斷連接字串，則會改用該帳戶。

Azure SDK 2.4 及更舊版本和 Azure SDK 2.5 及更新版本之間的診斷功能差異

如果您要將專案從 Azure SDK 2.4 更新為 Azure SDK 2.5 或更新版本，您應該謹記下列診斷功能差異。

組態 API 已淘汰 – Azure SDK 2.4 或較早的版本中支援以程式設計方式設定診斷功能，但在 Azure SDK 2.5 和更新的版本中已淘汰。如果診斷組態目前以程式碼定義，您將需要在移轉專案中從頭開始進行這些設定才能讓診斷保持運作。 Azure SDK 2.4 的診斷組態檔是 diagnostics.wadcfg，而 diagnostics.wadcfgx 是 Azure SDK 2.5 及更新版本的診斷組態檔。
雲端服務應用程式的診斷只能在角色層級設定，而不是在執行個體層級。
每次部署您的應用程式時，都會更新診斷組態 – 如果您從 [伺服器總管] 變更診斷組態並重新部署您的應用程式，會導致同位檢查的問題。
在 Azure SDK 2.5 和更新版本，損毀傾印是在診斷組態檔中設定，而不是在程式碼中 – 如果您在程式碼中設定損毀傾印，您必須手動將組態從程式碼移轉至組態檔，因為在移轉至 Azure SDK 2.6 期間不會移轉損毀傾印。