共用方式為

監視 IoT Edge 部署

適用於：IoT Edge 1.5 檢查標記 IoT Edge 1.5

重要

IoT Edge 1.5 LTS 是 支援的版本。 自 2024 年 11 月 12 日起，IoT Edge 1.4 LTS 已結束生命週期。 如果您是舊版，請參閱更新 IoT Edge。

Azure IoT Edge 提供部署至 IoT Edge 裝置之模組的實時資訊。 IoT 中樞服務會從裝置取得狀態，並向您顯示它。 對於包含自動部署和分層部署的大規模部署而言，監視也非常重要。

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

IoT 中樞服務會收集裝置和模組孿生所報告的數據，並為您提供裝置可擁有的不同狀態計數。 IoT 中樞服務會將此資料分成四個計量群組：

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

您可以在 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 show 會使用這些參數：

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

請在命令視窗中檢查部署。 每個中樞評估的每個指標的數量都會在屬性 metrics 中列出。

  • 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]

命令 deployment show-metric 會使用這些參數：

  • --deployment-id - IoT 中樞中的部署名稱。
  • --metric-id - 要顯示裝置識別子清單的計量名稱，例如 reportedFailedCount。
  • --hub-name - 部署所在的IoT 中樞名稱。 中樞必須位於目前的訂用帳戶中。 切換至包含 az account set -s [subscription name] 的訂閱計畫。 若要對您的部署進行變更，請參閱修改部署。

下一步

瞭解如何 監視模組雙胞胎，主要是 IoT Edge 代理程式和 IoT Edge 中樞執行階段模組，以檢查 IoT Edge 部署的連接狀況和健康情況。

  • Last updated on