Cloud Tasks 的觀測功能

Google Cloud Observability 提供監控、記錄和診斷工具。這些工具可協助您監控及分析 Cloud Tasks 活動和成長情形，並瞭解應用程式的行為、健康狀態和效能。

根據預設，Cloud Tasks 會設定為執行下列動作：

  • 將資料和系統稽核記錄傳送至 Cloud Logging。您可以利用收集到的記錄進行偵錯、排解問題，並深入瞭解應用程式。
  • 將系統和資源指標傳送至 Cloud Monitoring。您可以運用收集到的指標監控健康狀態和效能、找出趨勢和問題，以及在行為發生變化時收到通知。

將稽核記錄傳送至 Cloud Logging

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

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

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

搭配佇列使用 Cloud Logging

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

  • 工作作業：
    • 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. 在「佇列詳細資料」頁面中，按一下「記錄」分頁標籤。

  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 的搜尋欄位中搜尋 cloudtasks，篩選 Cloud Tasks 記錄。

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

將指標傳送至 Cloud Monitoring

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

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

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

資源指標和標籤

這個表格中的「指標類型」字串開頭必須為 cloudtasks.googleapis.com/。該前置字串已從表格中的項目省略。 查詢標籤時，請使用 metric.labels. 前置字串，例如 metric.labels.LABEL="VALUE"。

指標類型 推出階段 (資源階層層級)
顯示名稱
種類、類型、單位
受監控資源		 說明
標籤
api/request_count GA  (專案)
API 要求
DELTA、INT64、1
cloud_tasks_queue 		Cloud Tasks API 呼叫次數。取樣頻率為每 60 秒一次。取樣完畢後，會有多達 240 秒的時間無法查看資料。
api_method： 呼叫的 API 方法 (例如 CreateTask)。
response_code： 標準回應代碼，以字串表示 (例如「ok」)。
queue/depth GA  (專案)
佇列深度
GAUGE、INT64、1
cloud_tasks_queue 		佇列中的工作數。取樣頻率為每 60 秒一次。取樣完畢後，會有多達 120 秒無法查看資料。
queue/task_attempt_count GA  (project)
嘗試執行任務的次數
DELTA、INT64、1
cloud_tasks_queue 		按照回應代碼細分的任務嘗試次數。取樣頻率為每 60 秒一次。取樣完畢後，會有多達 180 秒的時間無法查看資料。
response_code： 標準回應代碼，以字串表示 (例如「ok」)。
queue/task_attempt_delays GA  (專案)
工作嘗試延遲
DELTA、DISTRIBUTION、ms
cloud_tasks_queue 		排定嘗試時間與實際嘗試時間之間的延遲時間。取樣頻率為每 60 秒一次。取樣完畢後，會有多達 120 秒無法查看資料。

資料表生成時間：2025 年 10 月 16 日 16:05:51 (世界標準時間)。

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

讀取指標資料

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

使用 Monitoring 資訊主頁和快訊

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

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