共用方式為


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

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

必要條件

注意

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

支援的瀏覽器:

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

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

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

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

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

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

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

設定記錄收集

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

記錄收集檔案路徑

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

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

記錄檔大小上限

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

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

建立記錄作業

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

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

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

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

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

  5. 選取 [新增]。

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

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

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

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

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

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

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

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

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

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

    Screenshot of log file within Azure Blob storage.

下一步

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