將 Cloud Storage FUSE 記錄轉送至 Cloud Logging

Cloud Storage FUSE 記錄可協助您瞭解 Cloud Storage FUSE 的運作方式、排解問題及監控效能。使用 --log-severity 選項或 logging:severity 欄位產生記錄時，您可以在執行 Cloud Storage FUSE 的機器上，以標準輸出內容或本機記錄檔的形式查看記錄。將這些記錄轉送至 Cloud Logging，即可在集中位置查看、篩選、設定快訊及保留記錄。

本文說明如何將 Cloud Storage FUSE 記錄轉送至 Cloud Logging。

將記錄轉送至 Cloud Logging 的優點

將 Cloud Storage FUSE 記錄轉送至 Cloud Logging 後，您可以執行下列操作：

  • 在 Google Cloud 控制台的單一位置查看所有 Cloud Storage FUSE 記錄，全面掌握 Cloud Storage FUSE 行為，並輕鬆連結不同元件的事件。

  • 依嚴重性等級、時間戳記、資源類型和其他欄位篩選 Cloud Storage FUSE 記錄，找出錯誤或效能問題。

  • 建立由特定記錄事件觸發的指標警告。舉例來說，您可以設定快訊，在偵測到 Cloud Storage FUSE 的 error 或 warning 記錄訊息時通知您，以便主動因應問題。

  • 將記錄儲存在 Cloud Logging 中，並設定儲存期限，然後匯出至 Cloud Storage，以便長期儲存、封存或深入分析。

定價

如要瞭解 Cloud Logging 的定價資訊，請參閱「Cloud Logging 費用」。

取得必要角色

如要取得使用 Cloud Logging 查看 Cloud Storage FUSE 記錄檔所需的權限，請在要收集指標的專案中，授予記錄檔寫入者 (roles/logging.logWriter) IAM 角色。

這個預先定義的角色具備使用 Cloud Logging 所需的權限。如要進一步瞭解記錄寫入者角色，請參閱 IAM 說明文件中的 roles/logging.logWriter。

如需授予專案角色的操作說明，請參閱「管理專案存取權」。

事前準備

  1. 啟用 Cloud Storage API。

    前往 Cloud Storage API

  2. 啟用 Cloud Logging API。

    前往 Cloud Logging API

  3. 安裝 Cloud Ops Agent，這是 Google Cloud用來收集記錄和指標的主要代理程式。請根據您使用的虛擬機器類型，選取安裝方法。

  4. 使用 --log-severity 選項或 severity 欄位，將記錄嚴重性設為 tracetrace。

將 Cloud Storage FUSE 記錄轉送至 Cloud Logging

  1. 為 gcsfuse 掛接指定 /gcsfuse.log：

    logging:
  file-path: "/gcsfuse.log"
  severity: trace

  2. 使用下列設定，將 Cloud Ops Agent 設為將 /gcfuse.log 檔案中的記錄轉送至 Cloud Logging。在這個設定中，gcsfuse_trace_logs 是 receiver 元素，會接收來自 /gcsfuse.log 檔案的記錄。service 元素會連結管道中的 receiver 元素。

    logging:
 receivers:
  gcsfuse_trace_logs:
  type: files
  include_paths:
  - /gcsfuse.log
service:
 pipelines:
   gcsfuse_pipeline:
     receivers: [gcsfuse_trace_logs]

    如要瞭解其他記錄設定，請參閱「Cloud Logging 設定」。

  3. 請根據作業系統，將 Cloud Ops Agent 的設定放在特定路徑。如要選擇設定的路徑，請參閱 Google Cloud Observability 說明文件，瞭解使用者指定的設定。

  4. 使用 systemctl restart 指令重新啟動 Cloud Ops Agent，套用新的設定變更：

    sudo systemctl restart google-cloud-ops-agent`

  5. 前往 Google Cloud 控制台的 Cloud Logging。

  6. 執行 fuse_debug 篩選查詢，驗證轉送至 Cloud Logging 的 gcsfuse 追蹤記錄。

後續步驟