記錄

啟用 Logging

Transfer Appliance 會使用記錄功能，將裝置上產生的特定系統記錄匯出至 Google Cloud Observability，方便您存取這些記錄。

啟用記錄的步驟取決於您是否已設定線上轉移：

  • 如果您已設定線上轉移，並將 Logging Log Writer 角色授予服務帳戶，則無需進一步設定。

  • 如果您已設定線上轉移，但未新增Logging Log Writer角色，請在專案層級將角色新增至使用者代管的服務帳戶。新增或變更角色後，不需要重新產生服務帳戶金鑰。

  • 如果尚未設定線上轉移功能，請按照操作說明建立及設定使用者代管服務帳戶。記錄檔只需要 Logging Log Writer 角色。

完成必要步驟後：

  1. 連線至設備。
  2. 開始回報設備記錄檔

ta logging start

停用設備上的記錄功能

如要停止回報設備記錄，請在 Transfer Appliance 指令列執行下列指令：

ta logging stop

查看記錄

如要查詢記錄，可以使用 Google Cloud Observability 的 label.sessionID 欄位。

labels.sessionID={sessionID}

匯出的記錄包括：

  • Fluent Bit

  • Docker

  • 核心

  • 中繼資料分割區

    • 擷取

    • ta_check

    • activation_service

您可以使用 Google Cloud 控制台、Google Cloud CLI 或 Logging API，在 Cloud Logging 中查看記錄。

疑難排解

An error occurred while enabling logging

如果設備上找不到服務帳戶金鑰檔案 /tmp/key.json，系統會傳回錯誤。

如需設定服務帳戶並將金鑰檔案複製到設備的相關操作說明，請參閱「建立及設定使用者代管服務帳戶」。