教學課程：監視IoT Edge裝置

發行項
04/11/2024

適用于：IoT Edge 1.4

重要

IoT Edge 1.4 是支援的版本。如果您使用的是舊版，請參閱更新IoT Edge。

使用 Azure 監視器活頁簿來監視 Azure IoT Edge部署的健康情況和效能。

在本教學課程中，您會了解如何：

瞭解IoT Edge裝置所共用的計量，以及計量收集器模組如何處理它們。
將計量收集器模組部署至IoT Edge裝置。
檢視從裝置收集之計量的策劃視覺效果。

必要條件

已部署模擬溫度感應器模組的IoT Edge裝置。如果您尚未準備好裝置，請遵循將第一個IoT Edge模組部署至虛擬 Linux 裝置中的步驟，以使用虛擬機器建立。

瞭解IoT Edge計量

每個IoT Edge裝置都依賴兩個模組，也就是執行時間模組，其管理裝置上所有其他模組的生命週期和通訊。這些模組稱為IoT Edge代理程式和IoT Edge中樞。若要深入瞭解這些課程模組，請參閱瞭解 Azure IoT Edge執行時間及其架構。

這兩個執行時間模組都會建立計量，讓您從遠端監視IoT Edge裝置或其個別模組的執行方式。 IoT Edge代理程式會報告個別模組和主機裝置的狀態，因此會建立計量，例如模組已正確執行的時間長度，或裝置上所使用的 RAM 和 CPU 百分比。 IoT Edge中樞會報告裝置上的通訊，因此會建立計量，例如傳送和接收的訊息總數，或解決直接方法所需的時間。如需可用計量的完整清單，請參閱存取內建計量。

這兩個模組都會自動公開這些計量，以便您可以建立自己的解決方案來存取和報告這些計量。為了簡化此程式，Microsoft 提供 azureiotedge-metrics-collector 模組，可針對沒有或想要自訂解決方案的人員處理此程式。計量收集器模組會收集來自兩個執行時間模組的計量，以及您可能想要監視的任何其他模組，並將其從裝置外傳輸。

計量收集器模組的運作方式有兩種，可將計量傳送至雲端。我們將在本教學課程中使用的第一個選項是直接將計量傳送至 Log Analytics。只有在網路原則需要時，建議使用的第二個選項是透過IoT 中樞傳送計量，然後設定路由以將計量訊息傳遞至 Log Analytics。不論是哪一種方式，一旦計量位於 Log Analytics 工作區中，即可透過 Azure 監視器活頁簿檢視它們。

建立 Log Analytics 工作區

需要 Log Analytics 工作區才能收集計量資料，並提供查詢語言，並與 Azure 監視器整合，讓您能夠監視您的裝置。

登入 Azure 入口網站。
搜尋並選取 Log Analytics 工作區。
選取 [建立 ]，然後遵循提示來建立新的工作區。
建立工作區之後，請選取 [ 移至資源]。
從 [ 設定] 底下的主功能表中，選取 [ 代理程式管理]。
複製 [工作區 識別碼] 和 [ 主要金鑰] 的值。您稍後會在教學課程中使用這兩個值來設定計量收集器模組，以將計量傳送至此工作區。

擷取 IoT 中樞資源識別碼

當您設定計量收集器模組時，您會為它提供 IoT 中樞的 Azure Resource Manager資源識別碼。立即擷取該識別碼。

從 Azure 入口網站中，瀏覽至 IoT 中樞。
從左側功能表中的 [ 設定] 底下，選取 [ 屬性]。
複製 [資源識別碼] 的值。其格式應為 /subscriptions/<subscription_id>/resourceGroups/<resource_group_name>/providers/Microsoft.Devices/IoTHubs/<iot_hub_name> 。

部署計量收集器模組

將計量收集器模組部署到您想要監視的每個裝置。它會像任何其他模組一樣在裝置上執行，並監看其指派的端點，以取得計量來收集和傳送至雲端。

請遵循下列步驟來部署和設定收集器模組：

登入Azure 入口網站並移至您的 IoT 中樞。
從左側功能表中，選取 [裝置管理] 功能表下的 [裝置]。
從IoT Edge裝置清單中選取目標裝置的裝置識別碼，以開啟裝置詳細資料頁面。
在上方功能表列上，選取 [ 設定模組 ] 以開啟三步驟模組部署頁面。
從入口網站部署模組的第一個步驟是宣告哪些模組應位於裝置上。如果您使用您在快速入門中建立的相同裝置，您應該已經看到 SimulatedTemperatureSensor 列出。如果沒有，請立即新增：
1. 選取 [新增 ]，然後從下拉式功能表中選擇 [ Marketplace 模組 ]。
2. 搜尋並選取 SimulatedTemperatureSensor。

新增及設定計量收集器模組：

選取 [新增 ]，然後從下拉式功能表中選擇 [ Marketplace 模組 ]。
搜尋並選取[計量收集器] IoT Edge。
從模組清單中選取計量收集器模組，以開啟其設定詳細資料頁面。
流覽至 [ 環境變數] 索引卷 標。

更新下列值：

名稱	值
ResourceId	您在上一節中擷取的 IoT 中樞資源識別碼。
UploadTarget	`AzureMonitor`
LogAnalyticsWorkspaceId	您在上一節中擷取的 Log Analytics 工作區識別碼。
LogAnalyticsSharedKey	您在上一節中擷取的 Log Analytics 金鑰。

刪除 OtherConfig 環境變數，這是您想要在未來新增的額外組態選項預留位置。本教學課程不需要。
選取 [更新] 以儲存您的變更。

選取 [下一步：路由 ] 以繼續部署模組的第二個步驟。
入口網站會自動新增計量收集器的路由。如果您將收集器模組設定為透過IoT 中樞傳送計量，但在本教學課程中，我們會將計量直接傳送至 Log Analytics，因此不需要它。刪除 FromMetricsCollectorToUpstream 路由。
選取 [檢閱 + 建立 ] 以繼續部署模組的最後一個步驟。
選取 [建立 ] 以完成部署。

完成模組部署之後，您會返回裝置詳細資料頁面，您可以在其中看到四個模組列為 [部署中指定的]。這可能需要一些時間，所有四個模組都會列為裝置回報，這表示它們已成功啟動，並將其狀態回報給IoT 中樞。重新整理頁面以查看最新狀態。

監視裝置健康情況

裝置監視活頁簿最多可能需要 15 分鐘的時間才能檢視。部署計量收集器模組之後，它會開始將計量訊息傳送至 Log Analytics，這些訊息會組織在資料表內。您提供的IoT 中樞資源識別碼會將內嵌的計量連結至其所屬的中樞。因此，策劃的IoT Edge活頁簿可以藉由使用資源識別碼查詢計量資料表來擷取計量。

Azure 監視器提供三個適用于 IoT 的預設活頁簿範本：

[車隊檢視]活頁簿會顯示跨多個 IoT 資源之裝置的健康情況。此檢視允許設定閾值來判斷裝置健康情況，並呈現每個裝置的主要計量匯總。
[裝置詳細資料]活頁簿提供三種類別的視覺效果：傳訊、模組和主機。傳訊檢視會將裝置的訊息路由視覺化，並報告訊息系統的整體健康情況。模組檢視會顯示裝置上個別模組的執行方式。主機檢視會顯示主機裝置的相關資訊，包括主機元件和資源使用的版本資訊。
[ 警示 ] 活頁簿檢視會顯示跨多個 IoT 資源之裝置的警示。

探索車隊檢視和健康情況快照集活頁簿

車隊檢視活頁簿會顯示您的所有裝置，並可讓您選取特定裝置來檢視其健康情況快照集。使用下列步驟來探索活頁簿視覺效果：

返回Azure 入口網站中的 IoT 中樞頁面。
向下捲動主功能表中以尋找 [ 監視 ] 區段，然後選取 [ 活頁簿]。
選取 [車隊檢視] 活頁 簿。
您應該會看到執行計量收集器模組的裝置。裝置會列為 狀況良好 或 狀況不良。
選取裝置名稱以檢視裝置的詳細計量。
在任何時間圖表上，使用 X 軸底下的箭號圖示，或按一下圖表，然後拖曳游標來變更時間範圍。
關閉健康情況快照集活頁簿。 從車隊檢視活頁簿中選取 [活頁簿]，以返回活頁簿資源庫。

探索裝置詳細資料活頁簿

裝置詳細資料活頁簿會顯示個別裝置的效能詳細資料。使用下列步驟來探索活頁簿視覺效果：

從活頁簿資源庫，選取IoT Edge裝置詳細資料活頁簿。
您在裝置詳細資料活頁簿中看到的第一頁是已選取[路由]索引標籤的傳訊檢視。

在左側，資料表會顯示裝置上的路由，並依端點組織。針對我們的裝置，我們看到上游端點是用來路由傳送至IoT 中樞的特殊詞彙，是從模擬溫度感應器模組的temperatureOutput輸出接收訊息。

在右側，圖表會持續追蹤一段時間的已連線用戶端數目。您可以按一下並拖曳圖形來變更時間範圍。
選取 圖形索引 標籤，以查看路由的不同視覺效果。在圖形頁面上，您可以拖放不同的端點，以重新排列圖形。當您有許多要視覺化的路由時，這項功能會很有説明。
健康情況索引標籤會報告任何訊息的問題，例如已卸載的訊息或中斷連線的用戶端。
選取模組檢視以查看裝置上部署的所有模組狀態。您可以選取每個模組，以查看其使用多少 CPU 和記憶體的詳細資料。
選取主機檢視以查看主機裝置的相關資訊，包括其作業系統、IoT Edge精靈版本和資源使用。