啟用 Logging
Transfer Appliance 會使用記錄功能,將裝置上產生的特定系統記錄匯出至 Google Cloud Observability,方便您存取這些記錄。
啟用記錄的步驟取決於您是否已設定線上轉移:
如果您已設定線上轉移,並將
Logging Log Writer
角色授予服務帳戶,則不需要進一步設定。如果您已設定線上轉移,但未新增
Logging Log Writer
角色,請在專案層級將角色新增至使用者代管的服務帳戶。新增或變更角色後,不需要重新產生服務帳戶金鑰。如果尚未設定線上轉移功能,請按照操作說明建立及設定使用者代管的服務帳戶。記錄時只需要
Logging Log Writer
角色。
完成必要步驟後:
- 連線至設備。
- 開始從設備回報記錄
ta logging start
停用設備記錄功能
如要停止回報設備記錄,請在 Transfer Appliance 指令列執行下列指令:
ta logging stop
查看記錄
如要查詢記錄,可以使用 Google Cloud 的 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
,系統會傳回錯誤。
如需設定服務帳戶並將金鑰檔案複製到設備的操作說明,請參閱「建立及設定使用者代管服務帳戶」。