監視 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 IoT Edge 提供報告，可讓您監視部署至 IoT Edge 裝置之模組的實時資訊。 IoT 中樞 服務會從裝置擷取狀態，並將其提供給操作員使用。 監視對於大規模部署也很重要，包括自動部署和分層部署。

裝置和模組都有類似的數據，例如連線能力，因此會根據裝置標識碼或模組識別碼取得值。

IoT 中樞 服務會收集裝置和模組對應項所報告的數據，並提供裝置可能擁有的各種狀態計數。 IoT 中樞 服務會將此數據組織成四組計量：

類型 描述
目標式 顯示符合部署目標條件的IoT Edge裝置。
已套用 顯示其他優先順序較高部署的目標IoT Edge裝置。
報告成功 顯示已回報模組已成功部署的IoT Edge裝置。
報告失敗 顯示已回報一或多個模組尚未成功部署的 IoT Edge 裝置。 若要進一步調查錯誤，請從遠端連線到這些裝置並檢視記錄檔。

IoT 中樞 服務可讓您在 Azure 入口網站 和 Azure CLI 中監視此數據。

監視 Azure 入口網站 中的部署

若要檢視部署的詳細資料並監視執行它的裝置，請使用下列步驟：

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

  2. 選取 [裝置管理] 功能表下的 [設定 + 部署]。

  3. 檢查部署清單。 針對每個部署，您可以檢視下列詳細數據：

    資料行 描述
    識別碼 部署的名稱。
    類型 部署類型，部署或分層部署。
    目標條件 用來定義目標裝置的標記。
    優先順序 指派給部署的優先順序號碼。
    系統計量 IoT 中樞 中符合目標條件的裝置對應項數目。 [套用] 會指定已將部署內容套用至其模組對應項的裝置數目，IoT 中樞。
    裝置計量 從 IoT Edge 用戶端運行時間回報成功或錯誤的 IoT Edge 裝置數目。
    自訂計量 針對您為部署定義的任何計量報告數據的 IoT Edge 裝置數目。
    建立時間 建立部署時的時間戳。 當兩個部署具有相同優先順序時，此時間戳會用來中斷系結。

  4. 選取您要監視的部署。

  5. 在 [ 部署詳細數據] 頁面上，向下卷動至底部區段，然後選取 [目標條件 ] 索引卷標。選取 [檢視 ] 以列出符合目標條件的裝置。 您可以變更條件和 優先順序。 如果您進行變更，請選取 [儲存]。

    顯示部署目標裝置的螢幕快照。

  6. 選取 [ 計量] 索引標籤 。如果您從 [ 選取計量 ] 下拉式清單中選擇計量， 就會顯示 [檢視 ] 按鈕，以顯示結果。 您也可以選取 [ 編輯計量 ] 來調整您所定義之任何自定義計量的準則。 如果您進行變更，請選取 [儲存]。

    顯示部署計量的螢幕快照。

若要變更您的部署，請參閱 修改部署。

使用 Azure CLI 監視部署

使用 az iot edge deployment show 命令來顯示單一部署的詳細數據：

az iot edge deployment show --deployment-id [deployment id] --hub-name [hub name]

部署顯示命令會採用下列參數：

  • --deployment-id - IoT 中樞內存在的部署名稱。 必要的 參數。
  • --hub-name - 部署所在的IoT 中樞名稱。 中樞必須位於目前的訂用帳戶中。 使用命令 az account set -s [subscription name] 切換至所需的訂用帳戶

檢查命令視窗中的部署。 計量屬性會列出每個中樞所評估之每個計量的計數：

  • targetedCount - 系統計量，指定符合目標條件之 IoT 中樞中的裝置對應項數目。
  • appliedCount - 系統計量會指定已將部署內容套用至其模組對應項的裝置數目，IoT 中樞。
  • reportedSuccessfulCount - 裝置計量，指定從 IoT Edge 用戶端運行時間回報成功的部署中 IoT Edge 裝置數目。
  • reportedFailedCount - 裝置計量，指定來自IoT Edge用戶端運行時間之部署報告失敗的IoT Edge裝置數目。

您可以使用 az iot edge deployment show-metric 命令來顯示每個計量的裝置標識符或物件清單：

az iot edge deployment show-metric --deployment-id [deployment id] --metric-id [metric id] --hub-name [hub name]

部署 show-metric 命令會採用下列參數：

  • --deployment-id - IoT 中樞內存在的部署名稱。
  • --metric-id - 您想要查看裝置識別子清單的計量名稱，例如 reportedFailedCount。
  • --hub-name - 部署所在的IoT 中樞名稱。 中樞必須位於目前的訂用帳戶中。 使用 命令 az account set -s [subscription name]切換至所需的訂用帳戶。

若要變更您的部署，請參閱 修改部署。

下一步

瞭解如何 監視模組對應項，主要是IoT Edge代理程式和IoT Edge中樞運行時間模組，以取得IoT Edge部署的連線能力和健康情況。