Share via


教學課程:監視IoT Edge裝置

適用於:IoT Edge 1.5 複選標記 IoT Edge 1.5 IoT Edge 1.4 複選標記 IoT Edge 1.4

重要

支援 IoT Edge 1.5 LTS 和 IoT Edge 1.4 LTS 版本。 IoT Edge 1.4 LTS 於 2024 年 11 月 12 日結束生命週期。 如果您是舊版,請參閱更新 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 監視器的整合,讓您能夠監視裝置。

  1. 登入 Azure 入口網站

  2. 搜尋並選取 [Log Analytics 工作區]

  3. 選取 [ 建立 ],然後遵循提示來建立新的工作區。

  4. 建立工作區之後,請選取 [移至資源]。

  5. 從主功能表的 [設定],選取 [代理程式管理]。

  6. 複製工作區識別碼主鍵的值。 您稍後將在教學課程中使用這兩個值來設定計量收集器模組,以將計量傳送至此工作區。

擷取IoT中樞資源標識碼

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

  1. 從 Azure 入口網站,流覽至您的IoT中樞。

  2. 從左側功能表中,選取 [設定] 底下的 [屬性]。

  3. 複製 [資源識別符] 的值/subscriptions/<subscription_id>/resourceGroups/<resource_group_name>/providers/Microsoft.Devices/IoTHubs/<iot_hub_name>格式應為 。

部署計量收集器模組

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

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

  1. 登入 Azure 入口網站 並移至IoT中樞。

  2. 從左側功能表中,選取 [裝置管理] 功能表下的 [裝置]。

  3. 從IoT Edge裝置清單中選取目標裝置的裝置識別碼,以開啟裝置詳細數據頁面。

  4. 在上方功能表欄上,選取 [ 設定模組 ] 以開啟三步驟模組部署頁面。

  5. 從入口網站部署模組的第一個步驟是宣告哪些 模組 應該在裝置上。 如果您使用在快速入門中建立的相同裝置,您應該已經看到 SimulatedTemperatureSensor 列出。 如果沒有,請立即新增:

    1. 選取 [ 新增 ],然後從下拉功能表中選擇 [Marketplace 模組 ]。

    2. 搜尋並選取 SimulatedTemperatureSensor

  6. 新增及設定計量收集器模組:

    1. 選取 [ 新增 ],然後從下拉功能表中選擇 [Marketplace 模組 ]。

    2. 搜尋並選取 [IoT Edge 計量收集器]。

    3. 從模組清單中選取計量收集器模組,以開啟其組態詳細數據頁面。

    4. 流覽至 [ 環境變數] 索引標籤。

    5. 更新下列值:

      名稱
      ResourceId 您在上一節中擷取的IoT中樞資源識別碼。
      UploadTarget AzureMonitor
      LogAnalyticsWorkspaceId 您在上一節中擷取的Log Analytics工作區標識碼。
      LogAnalyticsSharedKey 您在上一節中擷取的Log Analytics 金鑰。
    6. 刪除 OtherConfig 環境變數,這是未來您可能想要新增之額外設定選項的佔位符。 本教學課程並非必要專案。

    7. 選取[更新] 以儲存變更。

  7. 選取 [下一步:路由 ] 以繼續進行部署模組的第二個步驟。

  8. 入口網站會自動新增計量收集器的路由。 如果您將收集器模塊設定為透過 IoT 中樞 傳送計量,請使用此路由,但在本教學課程中,我們會將計量直接傳送至Log Analytics,因此不需要。 刪除 FromMetricsCollectorToUpstream 路由。

  9. 選取 [ 檢閱 + 建立 ] 以繼續進行部署模組的最後一個步驟。

  10. 選取 [建立] 以完成部署。

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

監視裝置健康情況

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

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

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

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

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

  1. 返回 Azure 入口網站中的IoT中樞頁面。

  2. 向下捲動主功能表中以尋找 [ 監視] 區段,然後選取 [ 活頁簿]。

    選取活頁簿以開啟 Azure 監視器活頁簿資源庫。

  3. 選取 [艦隊檢視]頁簿。

  4. 您應該會看到執行計量收集器模組的裝置。 裝置會列為 狀況良好狀況不良

  5. 選取裝置名稱以檢視裝置的詳細計量。

  6. 在任何時間圖表上,使用 X 軸下的箭號圖示,或按兩下圖表,並拖曳游標以變更時間範圍。

    按兩下並使用任何圖表上的箭號圖示來變更時間範圍。

  7. 關閉健全狀況快照集活頁簿。 從車隊檢視活頁簿選取 [活頁簿] 以返回活頁簿資源庫。

探索裝置詳細數據活頁簿

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

  1. 從活頁簿資源庫,選取 IoT Edge裝置詳細 數據活頁簿。

  2. 您在裝置詳細數據活頁簿中看到的第一頁是已選取路由索引標籤的傳訊檢視。

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

    右側圖表會追蹤一段時間連線的用戶端數目。 您可以按下並拖曳圖形來變更時間範圍。

    選取訊息檢視以查看裝置上的通訊狀態。

  3. 選取圖表索引標籤,以查看路由的不同視覺效果。 在圖形頁面上,您可以拖放不同的端點來重新排列圖形。 當您有許多要可視化的路由時,這項功能會很有説明。

    選取圖表檢視以查看裝置路由的互動式圖表。

  4. 健康情況索引標籤報告訊息的任何問題,例如已卸除的訊息或已中斷連線的用戶端。

  5. 選取模組檢視,以查看裝置上部署的所有模組的狀態。 您可以選取每個模組,以查看它們使用多少 CPU 和記憶體的詳細資料。

    選取模組檢視,以查看部署至裝置的每個模塊的狀態。

  6. 選取主機檢視以查看主機裝置的相關信息,包括其操作系統、IoT Edge 精靈版本和資源使用。

檢視模組記錄

檢視裝置的計量之後,您可能會想要進一步深入瞭解並檢查個別模組。 IoT Edge 透過即時模組記錄功能,在 Azure 入口網站 提供疑難解答支援。

  1. 從裝置詳細數據活頁簿中,選取 [ 即時疑難解答]。

    從裝置詳細數據活頁簿右上角選取 [即時疑難解答] 按鈕。

  2. 疑難解答頁面會開啟至來自IoT Edge裝置的 edgeAgent 記錄。 如果您在裝置詳細數據活頁簿中選取特定時間範圍,該設定會傳遞至疑難解答頁面。

  3. 使用下拉功能表切換至裝置上執行的其他模組記錄。 使用 [ 重新啟動] 按鈕來重新啟動模組。

    使用下拉功能表來檢視不同模組的記錄,並使用 [重新啟動] 按鈕來重新啟動模組。

您也可以從 IoT Edge 裝置的詳細數據頁面存取疑難解答頁面。 如需詳細資訊,請參閱針對來自 Azure 入口網站的 IoT Edge 裝置進行疑難解答。

下一步

當您繼續進行其餘的教學課程時,請將計量收集器模組保留在裝置上,並返回這些活頁簿,以查看當您新增更複雜的模組和路由時,資訊如何變更。

繼續進行下一個教學課程,其中您已設定開發人員環境,以開始將自定義模組部署至您的裝置。