Cloud Tasks 的觀測功能

Google Cloud Observability 可讓您監控及分析 Cloud Tasks 活動、佇列成長情形和執行行為。您可以根據收集到的指標和記錄評估應用程式健康狀態、診斷工作失敗情形，以及排解效能問題。

根據預設，Cloud Tasks 會將系統和資源指標傳送至 Cloud Monitoring，並將管理員活動稽核記錄匯出至 Cloud Logging。資料存取稽核記錄預設為停用，必須明確設定。

將稽核記錄傳送至 Cloud Logging

Cloud Tasks 會將下列類型的稽核記錄資料傳送至 Cloud Logging：

資料存取稽核記錄預設為停用，因為這類稽核記錄可能相當龐大。

詳情請參閱「Cloud Tasks 稽核記錄」。

搭配佇列使用 Cloud Logging

Cloud Logging 可與 Cloud Tasks 工作佇列搭配使用。系統會記錄下列作業：

  • 工作作業：
    • CreateTask
    • DeleteTask
  • 嘗試操作：
    • AttemptDispatch
    • AttemptResponse

啟用記錄功能

您可以使用 Google Cloud 控制台或 Google Cloud CLI 啟用記錄功能。

控制台

  1. 在 Google Cloud 控制台中，依序前往「Cloud Tasks」>「Queues」(佇列) 頁面。

    前往「佇列」

  2. 按一下要啟用記錄功能的佇列名稱。

  3. 在「佇列詳細資料」頁面中，按一下「記錄」分頁標籤。

  4. 按一下「啟用記錄」，然後點選「啟用」確認操作。

    螢幕截圖

gcloud

如要啟用記錄功能，可以使用 gcloud tasks queues create 或 gcloud tasks queues update 指令。

gcloud tasks queues create QUEUE_ID \
    --log-sampling-ratio=LOG_SAMPLING_RATION

或

gcloud tasks queues update QUEUE_ID \
    --log-sampling-ratio=LOG_SAMPLING_RATIO

更改下列內容：

  • QUEUE_ID：佇列的 ID
  • LOG_SAMPLING_RATIO：記錄作業的比例。介於 1.0 和 0.0 之間的任何值，都會記錄該比例的作業。如要記錄所有作業，請將其設為 1.0。如不記錄任何作業，請將其設為 0.0 (這是預設值)。

停用記錄

您可以使用 Google Cloud 控制台或 Google Cloud CLI 停用記錄功能。

控制台

  1. 在 Google Cloud 控制台中，依序前往「Cloud Tasks」>「Queues」(佇列) 頁面。

    前往「佇列」

  2. 按一下要停用記錄功能的佇列名稱。

  3. 在「Queue details」(佇列詳細資料) 頁面中，按一下「Logs」(記錄) 分頁標籤。

  4. 依序按一下「省略符號」圖示 >「停用記錄」。按一下「停用」確認操作。

    螢幕截圖

gcloud

如要停用記錄功能，請使用 gcloud tasks queues update 指令，並將 log-sampling-ratio 旗標設為 0.0。

gcloud tasks queues update QUEUE_ID \
    --log-sampling-ratio=0.0

將 QUEUE_ID 替換為佇列 ID。

查詢及查看記錄

您可以使用下列工具查看及分析記錄：

  • 記錄檔探索工具可協助您排解及分析服務和應用程式的效能問題。如要瞭解如何在 Logs Explorer 中查看記錄檔，請按照「使用 Logs Explorer 查看記錄檔」一文中的操作說明進行。
  • Observability Analytics 可執行查詢來分析記錄，然後查看結果或繪製成圖表。如要瞭解如何使用 Observability Analytics，請按照「使用 Observability Analytics 查詢及分析記錄」一文中的操作說明操作。

如要在 Logs Explorer 中篩選 Cloud Tasks 記錄，請在搜尋欄位中搜尋 cloudtasks。

如要進一步瞭解如何查詢及分析記錄檔，請參閱「查詢和查看記錄檔總覽」。

將指標傳送至 Monitoring

Cloud Tasks 會將受監控資源的指標資料傳送至 Google Cloud Observability。Monitoring 中的受監控資源代表邏輯或實體實體，例如虛擬機器、資料庫或應用程式。受監控的資源包含一組獨特的指標，可用於探索、透過資訊主頁回報，或用於建立快訊。

Cloud Tasks 會將下列受監控資源的指標資料傳送至 Google Cloud Observability：

每項資源也有一組資源標籤，這些鍵/值組合會保存資源的其他資訊。與資源相關聯的所有指標都有資源標籤，詳情請參閱下表。

資源指標和標籤

如要查看所有資源類型，請參閱「受監控資源類型」。如要查看所有指標類型，請參閱「Google Cloud 指標」。

讀取指標資料

您可以使用 Cloud Monitoring API 中的 timeSeries.list 方法，讀取指標資料 (也稱為時間序列資料)。呼叫方法的方式有很多種，包括使用特定語言的用戶端程式庫，或使用 Metrics Explorer 建立圖表。如需指標和時間序列的簡介，請參閱「指標、時間序列和資源」。如要瞭解如何解讀指標資料，請參閱「擷取時間序列資料」。

使用監控資訊主頁和快訊

您可以使用 Monitoring 資訊主頁和相關圖表，以圖表呈現 Cloud Tasks 指標的資料。

如要在 Monitoring 中監控這些指標，可以建立自訂資訊主頁。您也可以根據這些指標新增快訊。