監控工作流程

Google Cloud Observability 提供監控、記錄和診斷工具。這些工具可協助您監控及分析工作流程部署和執行作業，並瞭解應用程式的運作情形、健康狀態和效能。

根據預設，工作流程會設定為執行下列操作：

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

將稽核記錄傳送至 Cloud Logging

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

資料存取稽核記錄預設為停用，因為這些記錄可能相當龐大。詳情請參閱「啟用資料存取稽核記錄」。

如要進一步瞭解 Workflows 中的稽核記錄，請參閱下列文章：

您也可以將執行記錄傳送至 Cloud Logging。

將指標傳送至 Cloud Monitoring

工作流程會將受監控資源的指標資料傳送至 Google Cloud Observability。在 Monitoring 中，受監控資源代表邏輯或實體，例如虛擬機器、資料庫或應用程式。受監控的資源包含一組獨特的指標，可用於探索、透過資訊主頁產生報表，或用於建立快訊。每項資源也有一組資源標籤，這些鍵/值組合會保留資源的額外資訊。資源標籤適用於與資源相關聯的所有指標。

如要查看所有資源類型，請參閱「受控資源類型」。如要查看所有指標類型，請參閱「Google Cloud 指標」。展開下方內容，查看從 Workflows 傳送至 Google Cloud Observability 的指標類型清單：

Workflows 指標類型

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

指標類型 推出階段 (資源階層層級)
顯示名稱
種類、類型、單位
受監控資源		 說明
標籤
await_callback_step_count GA  (project)
Await Callback Step Count
DELTA、INT64、1
workflows.googleapis.com/Workflow 		等待回呼的已執行步驟數。取樣頻率為每 60 秒一次。取樣完畢後，會有多達 120 秒無法查看資料。
revision_id： 執行工作流程的修訂版本 ID。
callback_requests_count GA  (project)
Callback Requests Count
DELTA、INT64、1
workflows.googleapis.com/Workflow 		觸發回呼的要求數。取樣頻率為每 60 秒一次。取樣完畢後，會有多達 120 秒無法查看資料。
revision_id： 執行工作流程的修訂版本 ID。
callback_timeout_count GA  (project)
Callback Timeout Count
DELTA、INT64、1
workflows.googleapis.com/Workflow 		逾時的回呼次數。取樣頻率為每 60 秒一次。取樣完畢後，會有多達 120 秒無法查看資料。
revision_id： 執行工作流程的修訂版本 ID。
cmek_protected_workflow_count GA  (project)
受 CMEK 保護的工作流程數量
DELTA、INT64、1
workflows.googleapis.com/Workflow 		使用 CMEK 保護機制部署的工作流程數量。取樣頻率為每 60 秒一次。取樣完畢後，會有多達 120 秒無法查看資料。
revision_id： 執行工作流程的修訂版本 ID。
compute_slice_count GA  (project)
Compute Slice Count
DELTA、INT64、1
workflows.googleapis.com/Workflow 		執行的運算片段數量。步驟會以工作片段的形式執行，具體取決於執行的步驟類型 (例如，HTTP 要求會與「指派」步驟分開執行)。取樣頻率為每 60 秒一次。取樣完畢後，會有多達 120 秒無法查看資料。
revision_id： 已執行工作流程的修訂版本 ID。
type： 運算切片類型，例如「IO_REQUEST」或「WAKEUP」。
has_parallel： (BOOL) 工作流程是否使用平行步驟。
compute_slice_latencies GA  (專案)
運算執行個體延遲時間
DELTA、DISTRIBUTION、ms
workflows.googleapis.com/Workflow 		從排定運算時間到實際執行運算之間的時間差。取樣頻率為每 60 秒一次。取樣完畢後，會有多達 120 秒無法查看資料。
revision_id： 已執行工作流程的修訂版本 ID。
type： 運算切片類型，例如「IO_REQUEST」或「WAKEUP」。
has_parallel： (BOOL) 工作流程是否使用平行步驟。
compute_step_count GA  (專案)
計算步驟數
DELTA、INT64、1
workflows.googleapis.com/Workflow 		執行的運算步驟數 (例如「指派」和「for」步驟)。取樣頻率為每 60 秒一次。取樣完畢後，會有多達 120 秒無法查看資料。
revision_id： 執行工作流程的修訂版本 ID。
compute_step_latencies GA  (專案)
計算步驟延遲時間
DELTA、DISTRIBUTION、ms
workflows.googleapis.com/Workflow 		已執行的運算步驟延遲時間。取樣頻率為每 60 秒一次。取樣完畢後，會有多達 120 秒無法查看資料。
revision_id： 執行工作流程的修訂版本 ID。
create_callback_step_count GA  (project)
建立回呼步驟計數
DELTA、INT64、1
workflows.googleapis.com/Workflow 		建立回呼的已執行步驟數。取樣頻率為每 60 秒一次。取樣完畢後，會有多達 120 秒無法查看資料。
revision_id： 已執行工作流程的修訂版本 ID。
method： 建立的回呼方法類型，例如「POST」。
deployment_attempt_count GA  (project)
部署嘗試次數
DELTA、INT64、1
workflows.googleapis.com/Workflow 		工作流程部署嘗試次數。取樣頻率為每 60 秒一次。取樣完畢後，會有多達 120 秒無法查看資料。
revision_id： 已執行工作流程的修訂版本 ID。
result： 部署嘗試的狀態。
deployment_latencies GA  (專案)
部署延遲時間
DELTA、DISTRIBUTION、ms
workflows.googleapis.com/Workflow 		工作流程部署嘗試的延遲時間。取樣頻率為每 60 秒一次。取樣完畢後，會有多達 120 秒無法查看資料。
revision_id： 執行工作流程的修訂版本 ID。
duplicate_event_count GA  (專案)
重複事件計數
DELTA、INT64、1
workflows.googleapis.com/Workflow 		收到的重複事件觸發次數。取樣頻率為每 60 秒一次。取樣完畢後，會有多達 120 秒無法查看資料。
revision_id： 已執行工作流程的修訂版本 ID。
event_type： 活動類型。
event_time_to_ack_latencies GA  (專案)
事件時間至確認延遲時間
DELTA、DISTRIBUTION、ms
workflows.googleapis.com/Workflow 		從事件開始到工作流程服務確認事件的時間，這段時間的延遲。取樣頻率為每 60 秒一次。取樣完畢後，會有多達 120 秒無法查看資料。
revision_id： 已執行工作流程的修訂版本 ID。
event_type： 活動類型。
event_trigger_count GA  (project)
事件觸發次數
DELTA、INT64、1
workflows.googleapis.com/Workflow 		收到的事件觸發次數。取樣頻率為每 60 秒一次。取樣完畢後，會有多達 120 秒無法查看資料。
revision_id： 已執行工作流程的修訂版本 ID。
event_type： 事件類型。
result： 事件觸發的結果。
execution_backlog_size GA  (project)
執行積壓工作大小
GAUGE、INT64、1
workflows.googleapis.com/Workflow 		尚未開始執行的執行次數。取樣頻率為每 60 秒一次。取樣完畢後，會有多達 120 秒無法查看資料。
revision_id： 執行工作流程的修訂版本 ID。
execution_times BETA  (project)
執行時間
DELTA、DISTRIBUTION、s
workflows.googleapis.com/Workflow 		工作流程執行時間的分佈情形。
revision_id： 執行工作流程的修訂版本 ID。
external_step_count BETA  (專案)
外部步數
DELTA、INT64、1
workflows.googleapis.com/Workflow 		工作流程執行的外部步驟數。
finished_execution_count BETA  (專案)
完成的執行次數
DELTA、INT64、1
workflows.googleapis.com/Workflow 		工作流程的已完成執行次數。
status： 工作流程的執行狀態。
revision_id： 執行工作流程的修訂版本 ID。
internal_execution_error_count GA  (project)
內部執行錯誤計數
DELTA、INT64、1
workflows.googleapis.com/Workflow 		因內部錯誤而失敗的執行次數。取樣頻率為每 60 秒一次。取樣完畢後，會有多達 120 秒無法查看資料。
revision_id： 執行工作流程的修訂版本 ID。
internal_step_count BETA  (專案)
內部步驟計數
DELTA、INT64、1
workflows.googleapis.com/Workflow 		工作流程執行的內部步驟數。
io_internal_request_count GA  (專案)
IO 內部要求計數
DELTA、INT64、1
workflows.googleapis.com/Workflow 		工作流程向 Google 服務提出的 I/O 要求數量。取樣頻率為每 60 秒一次。取樣完畢後，會有多達 120 秒無法查看資料。
revision_id： 已執行工作流程的修訂版本 ID。
service_domain： 要呼叫的 Google 服務網域，例如「bigquery.googleapis.com」。
io_step_count GA  (專案)
IO 步驟計數
DELTA、INT64、1
workflows.googleapis.com/Workflow 		執行的 I/O 步驟數。取樣頻率為每 60 秒一次。取樣完畢後，會有多達 120 秒無法查看資料。
revision_id： 已執行工作流程的修訂版本 ID。
io_result： I/O 步驟結果。
io_step_type: I/O 步驟類型。
destination_type: I/O 步驟目的地類型。
had_system_error： (BOOL) I/O 步驟是否發生系統錯誤。
io_step_latencies GA  (專案)
IO 步驟延遲
DELTA、DISTRIBUTION、ms
workflows.googleapis.com/Workflow 		執行的 I/O 步驟延遲時間。取樣頻率為每 60 秒一次。取樣完畢後，會有多達 120 秒無法查看資料。
revision_id： 已執行工作流程的修訂版本 ID。
io_result： I/O 步驟結果。
io_step_type: I/O 步驟類型。
had_system_error： (BOOL) I/O 步驟是否發生系統錯誤。
kms_decrypt_latencies GA  (project)
KMS 解密延遲時間
DELTA、DISTRIBUTION、ms
workflows.googleapis.com/Workflow 		工作流程對 KMS 發出的 CMEK 解密要求延遲時間。取樣頻率為每 60 秒一次。取樣完畢後，會有多達 120 秒無法查看資料。
revision_id： 已執行工作流程的修訂版本 ID。
status： 解密要求的狀態。
attempts: (INT64) 解密要求的嘗試次數。
kms_decrypt_request_count GA  (project)
KMS 解密要求計數
DELTA、INT64、1
workflows.googleapis.com/Workflow 		服務為 CMEK 發出的 KMS 解密要求數量。取樣頻率為每 60 秒一次。取樣完畢後，會有多達 120 秒無法查看資料。
revision_id： 已執行工作流程的修訂版本 ID。
status： 解密要求的狀態。
kms_encrypt_latencies GA  (project)
KMS 加密延遲時間
DELTA、DISTRIBUTION、ms
workflows.googleapis.com/Workflow 		工作流程對 KMS 發出的加密要求延遲時間 (適用於 CMEK)。取樣頻率為每 60 秒一次。取樣完畢後，會有多達 120 秒無法查看資料。
revision_id： 已執行工作流程的修訂版本 ID。
status： 加密要求的狀態。
attempts： (INT64) 加密要求的嘗試次數。
kms_encrypt_request_count GA  (project)
KMS 加密要求計數
DELTA、INT64、1
workflows.googleapis.com/Workflow 		服務為 CMEK 提出的 KMS 加密要求數量。取樣頻率為每 60 秒一次。取樣完畢後，會有多達 120 秒無法查看資料。
revision_id： 已執行工作流程的修訂版本 ID。
status： 加密要求的狀態。
parallel_branch_step_count GA  (project)
平行分支步驟計數
DELTA、INT64、1
workflows.googleapis.com/Workflow 		使用平行分支執行的步驟數。取樣頻率為每 60 秒一次。取樣完畢後，會有多達 120 秒無法查看資料。
revision_id： 執行工作流程的修訂版本 ID。
parallel_branch_substep_count GA  (project)
平行分支子步驟計數
DELTA、INT64、1
workflows.googleapis.com/Workflow 		平行分支中執行的步驟數量。取樣頻率為每 60 秒一次。取樣完畢後，會有多達 120 秒無法查看資料。
revision_id： 執行工作流程的修訂版本 ID。
parallel_iteration_step_count GA  (project)
平行疊代步驟計數
DELTA、INT64、1
workflows.googleapis.com/Workflow 		使用平行疊代執行的步驟數。取樣頻率為每 60 秒一次。取樣完畢後，會有多達 120 秒無法查看資料。
revision_id： 執行工作流程的修訂版本 ID。
parallel_iteration_substep_count GA  (project)
平行疊代子步驟計數
DELTA、INT64、1
workflows.googleapis.com/Workflow 		平行疊代中執行的步驟數量。取樣頻率為每 60 秒一次。取樣完畢後，會有多達 120 秒無法查看資料。
revision_id： 執行工作流程的修訂版本 ID。
parallel_unhandled_exceptions_limit_count GA  (專案)
平行未處理例外狀況計數上限
DELTA、INT64、1
workflows.googleapis.com/Workflow 		達到未處理的平行例外狀況限制次數。取樣頻率為每 60 秒一次。取樣完畢後，會有多達 120 秒無法查看資料。
revision_id： 執行工作流程的修訂版本 ID。
pending_io_requests GA  (project)
待處理的 IO 要求
GAUGE、INT64、1
workflows.googleapis.com/Workflow 		進行中的 I/O 要求數量。取樣頻率為每 60 秒一次。取樣完畢後，會有多達 120 秒無法查看資料。
revision_id： 執行工作流程的修訂版本 ID。
sent_bytes_count BETA  (project)
傳送的網路位元組數
DELTA、INT64、By
workflows.googleapis.com/Workflow 		工作流程傳送的連出 HTTP 位元組數 (網址、標頭和主體)。
revision_id： 執行工作流程的修訂版本 ID。
started_execution_count BETA  (project)
已啟動的執行次數
DELTA、INT64、1
workflows.googleapis.com/Workflow 		工作流程已啟動的執行作業數。
revision_id： 執行工作流程的修訂版本 ID。
started_vpcsc_executions_count GA  (專案)
已啟動的 VPC-SC 執行次數
DELTA、INT64、1
workflows.googleapis.com/Workflow 		已啟動的 VPC-SC 限制執行作業數量。取樣頻率為每 60 秒一次。取樣完畢後，會有多達 120 秒無法查看資料。
revision_id： 執行工作流程的修訂版本 ID。
vpcsc_protected_io_count GA  (專案)
VPC-SC 受保護的 IO 數量
DELTA、INT64、1
workflows.googleapis.com/Workflow 		使用 VPC-SC 發出的 I/O 要求數量。每 60 秒取樣一次。取樣完畢後，會有多達 120 秒無法查看資料。
revision_id： 執行工作流程的修訂版本 ID。

表格產生時間：2025-07-31 23:06:17 UTC。

讀取指標資料

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

監控配額指標

以下範例說明如何使用 APIs Explorer 查詢 Workflows 的總消耗分配配額。具體來說，這項指標會使用 Consumer Quota 資源類型中的 serviceruntime.googleapis.com/quota/allocation/usage 指標。您可以設定其他標籤篩選器 (service、quota_metric) 來指定配額類型。如要進一步瞭解如何監控配額指標，包括其他範例和如何建立快訊政策，請參閱「繪製及監控配額指標」。

  1. 開啟timeSeries.list 參考頁面。

  2. 如果沒有看到「試試這個方法」窗格，請按一下「試試看！」。

  3. 在「name」欄位中，以下列格式輸入 Google Cloud 專案 ID：

    projects/PROJECT_ID

  4. 在「filter」(篩選條件) 欄位中，指定單一指標類型，並視需要指定指標標籤和其他資訊。例如：

    metric.type = "serviceruntime.googleapis.com/quota/allocation/usage" AND resource.labels.service = "workflowexecutions.googleapis.com"

  5. 在 interval.endTime 欄位中輸入結束時間，限制傳回的資料量，並套用至您的用量。格式應為 RFC 3339 字串，例如 2024-11-07T03:01:02Z。

  6. 在 interval.startTime 欄位中輸入開始時間，限制傳回的資料量，這適用於您的用量。格式應為 RFC 3339 字串，例如 2024-11-07T03:01:00Z。

  7. 按一下 [Execute] (執行)。

    結果應與下列內容類似，其中 350 表示並行執行配額指標。

    {
"timeSeries": [
   {
      "metric": {
      "labels": {
         "quota_metric": "workflowexecutions.googleapis.com/concurrency"
      },
      "type": "serviceruntime.googleapis.com/quota/allocation/usage"
      },
      "resource": {
      "type": "consumer_quota",
      "labels": {
         "service": "workflowexecutions.googleapis.com",
         "project_id": "PROJECT_ID",
         "location": "europe-west1"
      }
      },
      "metricKind": "GAUGE",
      "valueType": "INT64",
      "points": [
      {
         "interval": {
            "startTime": "2024-11-07T03:01:02Z",
            "endTime": "2024-11-07T03:01:02Z"
         },
         "value": {
            "int64Value": "350"
         }
      }
      ]
   }

  8. 在收合的 APIs Explorer 側邊面板中，您可以按一下「全螢幕」展開 APIs Explorer。全螢幕面板會顯示額外窗格，內含程式碼範例、application/json 回應和原始 HTTP 回應。舉例來說，在本例中，您可以查看可比較的 curl 指令：

    curl \
'https://monitoring.googleapis.com/v3/projects/PROJECT_ID/timeSeries?filter=metric.type%20%3D%20%22serviceruntime.googleapis.com%2Fquota%2Fallocation%2Fusage%22%20AND%20resource.labels.service%20%3D%20%22workflowexecutions.googleapis.com%22&interval.endTime=2024-11-07T03%3A01%3A02Z&interval.startTime=2024-11-07T03%3A01%3A00Z&key=YOUR_API_KEY' \
   --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
   --header 'Accept: application/json' \
   --compressed

使用 Monitoring 資訊主頁和快訊

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

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

後續步驟