使用裝置更新從裝置遠端收集診斷記錄以進行 IoT 中樞

瞭解如何起始裝置更新，以 IoT 中樞 記錄作業，並檢視 Azure Blob 記憶體內收集的記錄。

必要條件

• 針對已啟用 IoT 中樞的裝置更新存取 IoT 中樞。
• 在 IoT 中樞 內布建裝置更新並實作診斷介面的IoT裝置（或模擬器）。
• 與裝置更新相同訂用帳戶下的 Azure Blob 記憶體帳戶，IoT 中樞 帳戶。

注意

遠程記錄收集功能目前只與實作診斷介面的裝置相容，而且能夠將檔案上傳至 Azure Blob 記憶體。 參考代理程式實作也預期裝置會將記錄檔寫入裝置上使用者指定的檔案路徑。

Azure 入口網站

支援的瀏覽器：

• Microsoft Edge
• Google Chrome

Azure CLI

Azure CLI 環境：

• 在 Azure Cloud Shell 中使用 Bash 環境。

  

• 或是，若要在本地執行 CLI 參考命令，請安裝 Azure CLI

  • 使用 az login 命令來登入 Azure CLI。
  • 執行 az version 以尋找已安裝的版本和相依程式庫。 若要升級至最新版本，請執行 az upgrade。
  • 出現提示時，請在第一次使用時安裝 Azure CLI 擴充功能。 本文中的命令會使用 azure-iot 延伸模組。 執行 az extension update --name azure-iot 以確定您使用的是最新版本的延伸模組。

提示

本文中的 Azure CLI 命令會使用反斜杠 \ 字元進行行接續，讓命令自變數更容易閱讀。 此語法適用於Bash環境。 如果您在 PowerShell 中執行這些命令，請以反引號 ''' 取代每個反斜杠，或完全移除它們。

將 Azure Blob 記憶體帳戶連結至您的裝置更新實例

若要使用遠端記錄收集功能，您必須先連結 Azure Blob 記憶體帳戶與您的裝置更新實例。 此 Azure Blob 記憶體帳戶是您的裝置將上傳診斷記錄的位置。

Azure 入口網站

1. 在 Azure 入口網站 中，流覽至您裝置更新的 IoT 中樞 帳戶。

2. 在瀏覽窗格的 [實例管理] 區段下，選取 [實例]。

3. 從清單中選取您的裝置更新實例，然後選取 [ 設定診斷]。

4. 選取 [客戶診斷] 索引標籤，然後選取 [Azure 儲存體 帳戶]。

5. 從清單中選擇所需的記憶體帳戶，然後選取 [ 儲存]。

6. 回到實例清單后，請定期選取 [重新 整理]，直到實例的布建狀態顯示「成功」為止。此程式通常需要 2-3 分鐘。

Azure CLI

使用 az iot du instance create 命令來設定裝置更新實例的診斷。

提示

您可以在 az iot du instance create 現有的裝置更新實例上使用 命令，並使用更新的參數來設定實例。

將下列預留位置取代為您自己的資訊：

• <>account_name：裝置更新帳戶的名稱。
• <>instance_name：裝置更新實例的名稱。
• <>storage_id：將儲存診斷記錄之記憶體帳戶的資源標識符。 您可以使用 az storage show 命令和查詢標識碼值來擷取資源標識碼：az storage account show -n <storage_name> --query id。

az iot du instance update --account <account_name> --instance <instance_name> --set enableDiagnostics=true diagnosticStorageProperties.resourceId=<storage_id>

設定記錄收集

裝置更新代理程式是指位於參考代理程式中 /etc/adu/du-diagnostics-config.json 之裝置上的組態檔。

記錄收集檔案路徑

裝置上的裝置更新代理程式會在裝置上收到來自裝置更新服務的記錄上傳啟動訊號時，從裝置上的特定檔案路徑收集檔案。 這些檔案路徑定義於診斷組態檔中。

在組態檔中，要收集和上傳的每個記錄檔都會以 componentName 和 logPath 屬性的物件表示 logComponent 。 您可以視需要修改此設定。

記錄檔大小上限

裝置更新代理程式只會收集特定檔案大小下的記錄檔。 此檔案大小上限定義於診斷組態檔中。

相關的參數 「maxKilobytesToUploadPerLogPath」 會套用至每個 logComponent 物件，並可視需要修改。

建立記錄作業

記錄作業是服務驅動的動作，您可以指示IoT裝置透過裝置更新服務執行。 如需記錄作業運作方式的更詳細說明，請參閱 裝置更新診斷。

Azure 入口網站

1. 流覽至您的 IoT 中樞，然後選取瀏覽窗格 裝置管理 區段底下的 [更新] 索引標籤。

2. 選取 UI 中的 [ 診斷] 索引 標籤。 如果您沒有看到 [診斷] 索引標籤，請確定您使用的是適用於 IoT 中樞 使用者介面的最新裝置更新版本。 如果您看到「必須啟用此裝置更新實例的診斷」，請確定您已將 Azure Blob 儲存器帳戶與您的裝置更新實例連結。

3. 選取 [新增記錄上傳作業 ] 以瀏覽至記錄作業建立頁面。

4. 輸入新記錄作業的名稱（標識符）和描述，然後選取 [ 新增裝置 ] 以選取您要從中收集診斷記錄的 IoT 裝置。

5. 選取 [新增]。

6. 回到 [診斷] 索引標籤后，請選取 [重新 整理]，直到您看到作業數據表中列出的記錄作業為止。

7. 一旦作業狀態為 [ 成功] 或 [失敗]，請選取作業名稱以檢視其詳細數據。 只有在所有目標裝置都成功完成記錄上傳時，才會將作業標示為「成功」。 如果某些目標裝置成功且有些失敗，則記錄作業會標示為「失敗」。您可以使用 [記錄作業詳細數據] 頁面來查看哪些裝置成功且失敗。

8. 在記錄作業詳細數據中，您可以檢視裝置特定狀態，並查看記錄位置路徑。 此路徑會對應至已上傳診斷記錄的 Azure Blob 記憶體帳戶內的虛擬目錄路徑。

Azure CLI

使用 az iot du device log collect 命令來設定診斷記錄收集作業。

該 device log collect 命令採用下列引數：

• --account：裝置更新帳戶名稱。
• --instance：裝置更新實例名稱。
• --log-collection-id：記錄收集作業的名稱。
• --agent-id：識別此記錄收集作業之目標Device Update代理程式的Key=value組。 如果代理程式具有裝置身分識別，請使用 deviceId=<device name> 。 如果代理程式具有模組身分識別，請使用 deviceId=<device name> moduleId=<module name> 。 您可以使用 --agent-id 參數多次以多個裝置為目標。

例如：

az iot du device log collect \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --log-collection-id <log collection name} \
    --agent-id deviceId=<device name> \
    --agent-id deviceId=<device name> moduleId=<module name>

使用 az iot du device log show 來檢視特定診斷記錄收集作業的詳細數據。

az iot du device log show \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --log-collection-id <log collection name>

檢視和導出收集的診斷記錄

1. 記錄作業成功之後，請流覽至您的 Azure Blob 記憶體帳戶。

2. 在瀏覽窗格的 [資料儲存區] 區段下，選取 [容器]。

3. 選取與裝置更新實例同名的容器。

4. 使用記錄作業詳細數據的記錄位置路徑，巡覽至包含記錄的正確目錄。 根據預設，遠端記錄收集功能會指示目標裝置使用下列目錄路徑模型上傳診斷記錄： Blob 記憶體容器/目標裝置標識元/記錄作業標識元/裝置上的記錄路徑

5. 如果您尚未修改裝置更新代理程式的診斷元件，裝置會嘗試上傳兩個純文本記錄檔來回應任何記錄作業：裝置更新代理程式診斷記錄檔（“aduc.log”），以及 DO 代理程式診斷記錄檔（“do-agent.log”。 您可以閱讀 裝置更新診斷 概念頁面，深入瞭解裝置更新參考代理程式收集哪些記錄檔。

6. 您可以選取檔名，然後選取功能表元素（省略號），然後按兩下 [檢視/編輯] 來檢視記錄檔的內容。 您也可以選擇個別標記的選項來下載或刪除記錄檔。

   

下一步

若要深入了解裝置更新的診斷功能，請參閱裝置更新診斷功能概觀