監控工作流程

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

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

  • 將資料和系統稽核記錄傳送至 Cloud Logging。您可以使用收集到的記錄來偵錯、排解應用程式問題,並取得相關洞察資料。
  • 將系統和資源指標傳送至 Cloud Monitoring。您可以使用收集到的指標來監控健康狀態和效能、找出趨勢和問題,並在行為發生變化時發出通知。

將稽核記錄傳送至 Cloud Logging

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

資料存取稽核記錄可能相當大,因此系統預設停用。詳情請參閱「啟用資料存取稽核記錄」。

如要進一步瞭解 Workflows 中的稽核記錄,請參閱以下文章:

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

將指標傳送至 Cloud Monitoring

工作流程會將受監控資源的指標資料傳送至 Google Cloud Observability。監控中的受控資源代表邏輯或實體實體,例如虛擬機器、資料庫或應用程式。監控的資源包含一組獨特的指標,可供您探索、透過資訊主頁回報,或用於建立快訊。每項資源也都有一組資源標籤,這些標籤是鍵/值組合,可儲存資源的其他資訊。資源標籤可用於與資源相關聯的所有指標。

如要查看所有資源類型,請參閱「受控資源類型」。如要查看所有指標類型,請參閱 Google Cloud 指標。展開以下清單,即可查看從工作流程傳送至 Google Cloud Observability 的指標類型:

Workflows 指標類型

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

指標類型 推出階段(資源階層層級)
顯示名稱
類別、類型、單位
受控資源
說明
標籤
await_callback_step_count GA(project)
等待回呼步驟數
DELTAINT641
workflows.googleapis.com/Workflow
等待回呼的已執行步驟數。取樣頻率為每 60 秒一次。取樣完畢後,會有多達 120 秒無法查看資料。
revision_id:執行的工作流程修訂版本 ID。
callback_requests_count GA(專案)
回呼要求數量
DELTAINT641
workflows.googleapis.com/Workflow
觸發回呼的要求數量。取樣頻率為每 60 秒一次。取樣完畢後,會有多達 120 秒無法查看資料。
revision_id:執行的工作流程修訂版本 ID。
callback_timeout_count GA(專案)
回呼逾時次數
DELTAINT641
workflows.googleapis.com/Workflow
逾時的回呼次數。取樣頻率為每 60 秒一次。取樣完畢後,會有多達 120 秒無法查看資料。
revision_id:執行的工作流程修訂版本 ID。
cmek_protected_workflow_count GA(project)
CMEK 保護的工作流程數量
DELTAINT641
workflows.googleapis.com/Workflow
使用 CMEK 保護功能部署的工作流程數量。取樣頻率為每 60 秒一次。取樣完畢後,會有多達 120 秒無法查看資料。
revision_id:執行的工作流程修訂版本 ID。
compute_slice_count GA(專案)
Compute Slice Count
DELTAINT641
workflows.googleapis.com/Workflow
已執行的運算片段數量。步驟會以工作片段執行,這取決於要執行的步驟類型 (例如,HTTP 要求會與「指派」步驟分開執行)。取樣頻率為每 60 秒一次。取樣完畢後,會有多達 120 秒無法查看資料。
revision_id:執行的工作流程修訂版本 ID。
type: 運算切片的類型,例如「IO_REQUEST」或「WAKEUP」。
has_parallel: (布林值) 工作流程是否使用並行步驟。
compute_slice_latencies GA(project)
Compute Slice 延遲時間
DELTADISTRIBUTIONms
workflows.googleapis.com/Workflow
從排程運算區塊到執行時間的延遲時間。取樣頻率為每 60 秒一次。取樣完畢後,會有多達 120 秒無法查看資料。
revision_id:執行的工作流程修訂版本 ID。
type: 運算切片的類型,例如「IO_REQUEST」或「WAKEUP」。
has_parallel: (布林值) 工作流程是否使用並行步驟。
compute_step_count GA(project)
計算步驟數
DELTAINT641
workflows.googleapis.com/Workflow
執行的運算步驟數 (例如「assign」和「for」步驟)。取樣頻率為每 60 秒一次。取樣完畢後,會有多達 120 秒無法查看資料。
revision_id:執行的工作流程修訂版本 ID。
compute_step_latencies GA(project)
Compute Step Latencies
DELTADISTRIBUTIONms
workflows.googleapis.com/Workflow
已執行運算步驟的延遲時間。取樣頻率為每 60 秒一次。取樣完畢後,會有多達 120 秒無法查看資料。
revision_id:執行的工作流程修訂版本 ID。
create_callback_step_count GA(專案)
建立回呼步驟計數
DELTAINT641
workflows.googleapis.com/Workflow
建立回呼的已執行步驟數。取樣頻率為每 60 秒一次。取樣完畢後,會有多達 120 秒無法查看資料。
revision_id:執行的工作流程修訂版本 ID。
method: 已建立的回呼方法類型,例如「POST」。
deployment_attempt_count GA(專案)
部署嘗試次數
DELTAINT641
workflows.googleapis.com/Workflow
工作流程部署嘗試次數。取樣頻率為每 60 秒一次。取樣完畢後,會有多達 120 秒無法查看資料。
revision_id:執行的工作流程修訂版本 ID。
result:部署嘗試的狀態。
deployment_latencies GA(專案)
部署延遲時間
DELTADISTRIBUTIONms
workflows.googleapis.com/Workflow
工作流程部署嘗試的延遲時間。取樣頻率為每 60 秒一次。取樣完畢後,會有多達 120 秒無法查看資料。
revision_id:執行的工作流程修訂版本 ID。
duplicate_event_count GA(專案)
重複事件數
DELTAINT641
workflows.googleapis.com/Workflow
收到的重複事件觸發事件數。取樣頻率為每 60 秒一次。取樣完畢後,會有多達 120 秒無法查看資料。
revision_id:執行的工作流程修訂版本 ID。
event_type:事件類型。
event_time_to_ack_latencies GA(project)
事件回應時間延遲
DELTADISTRIBUTIONms
workflows.googleapis.com/Workflow
從事件開始到工作流程服務回應的延遲時間。取樣頻率為每 60 秒一次。取樣完畢後,會有多達 120 秒無法查看資料。
revision_id:執行的工作流程修訂版本 ID。
event_type:事件類型。
event_trigger_count GA(專案)
事件觸發事件數
DELTAINT641
workflows.googleapis.com/Workflow
收到的事件觸發事件數。取樣頻率為每 60 秒一次。取樣完畢後,會有多達 120 秒無法查看資料。
revision_id:執行的工作流程修訂版本 ID。
event_type:事件類型。
result:事件觸發事件的結果。
execution_backlog_size GA(project)
執行待辦事項大小
GAUGEINT641
workflows.googleapis.com/Workflow
尚未開始執行的次數。取樣頻率為每 60 秒一次。取樣完畢後,會有多達 120 秒無法查看資料。
revision_id:執行的工作流程修訂版本 ID。
execution_times Beta 版(專案)
執行時間
DELTADISTRIBUTIONs
workflows.googleapis.com/Workflow
工作流程執行時間的分佈情形。
revision_id:執行的工作流程修訂版本 ID。
external_step_count Beta 版(project)
外部步數
DELTAINT641
workflows.googleapis.com/Workflow
工作流程執行的外部步驟數量。
finished_execution_count Beta 版(專案)
已完成執行次數
DELTAINT641
workflows.googleapis.com/Workflow
工作流程已完成的執行次數。
status:工作流程的執行狀態。
revision_id:執行的工作流程修訂版本 ID。
internal_execution_error_count GA(project)
內部執行錯誤計數
DELTAINT641
workflows.googleapis.com/Workflow
因內部錯誤而失敗的執行次數。取樣頻率為每 60 秒一次。取樣完畢後,會有多達 120 秒無法查看資料。
revision_id:執行的工作流程修訂版本 ID。
internal_step_count Beta 版(專案)
內部步數
DELTAINT641
workflows.googleapis.com/Workflow
工作流程執行的內部步驟數量。
io_internal_request_count GA(專案)
IO 內部要求次數
DELTAINT641
workflows.googleapis.com/Workflow
Workflow 向 Google 服務提出的 I/O 要求數量。取樣頻率為每 60 秒一次。取樣完畢後,會有多達 120 秒無法查看資料。
revision_id:執行的工作流程修訂版本 ID。
service_domain: 要呼叫的 Google 服務網域,例如「bigquery.googleapis.com」。
io_step_count GA(project)
IO 步驟計數
DELTAINT641
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: (布林值) 指出 I/O 步驟是否發生系統錯誤。
io_step_latencies GA(專案)
IO 步驟延遲時間
DELTADISTRIBUTIONms
workflows.googleapis.com/Workflow
執行 I/O 步驟的延遲時間。取樣頻率為每 60 秒一次。取樣完畢後,會有多達 120 秒無法查看資料。
revision_id:執行的工作流程修訂版本 ID。
io_result: I/O 步驟結果。
io_step_type: I/O 步驟類型。
had_system_error: (布林值) 指出 I/O 步驟是否發生系統錯誤。
kms_decrypt_latencies GA(專案)
KMS 解密延遲時間
DELTADISTRIBUTIONms
workflows.googleapis.com/Workflow
工作流程向 KMS 提出解密要求的延遲時間 (CMEK)。取樣頻率為每 60 秒一次。取樣完畢後,會有多達 120 秒無法查看資料。
revision_id:執行的工作流程修訂版本 ID。
status:解密要求的狀態。
attempts: (INT64) 解密要求的嘗試次數。
kms_decrypt_request_count GA(project)
KMS 解密要求次數
DELTAINT641
workflows.googleapis.com/Workflow
服務為 CMEK 提出的 KMS 解密要求數量。取樣頻率為每 60 秒一次。取樣完畢後,會有多達 120 秒無法查看資料。
revision_id:執行的工作流程修訂版本 ID。
status:解密要求的狀態。
kms_encrypt_latencies GA(project)
KMS 加密延遲時間
DELTADISTRIBUTIONms
workflows.googleapis.com/Workflow
CMEK 工作流程向 KMS 傳送加密要求的延遲時間。取樣頻率為每 60 秒一次。取樣完畢後,會有多達 120 秒無法查看資料。
revision_id:執行的工作流程修訂版本 ID。
status:加密要求的狀態。
attempts: (INT64) 加密要求的嘗試次數。
kms_encrypt_request_count GA(project)
KMS 加密要求次數
DELTAINT641
workflows.googleapis.com/Workflow
服務為 CMEK 提出的 KMS 加密要求數量。取樣頻率為每 60 秒一次。取樣完畢後,會有多達 120 秒無法查看資料。
revision_id:執行的工作流程修訂版本 ID。
status:加密要求的狀態。
parallel_branch_step_count GA(project)
平行分支步數
DELTAINT641
workflows.googleapis.com/Workflow
使用並行分支執行的步驟數量。取樣頻率為每 60 秒一次。取樣完畢後,會有多達 120 秒無法查看資料。
revision_id:執行的工作流程修訂版本 ID。
parallel_branch_substep_count GA(project)
並行分支子步驟數量
DELTAINT641
workflows.googleapis.com/Workflow
並行分支中執行的步驟數。取樣頻率為每 60 秒一次。取樣完畢後,會有多達 120 秒無法查看資料。
revision_id:執行的工作流程修訂版本 ID。
parallel_iteration_step_count GA(project)
並行疊代步驟數
DELTAINT641
workflows.googleapis.com/Workflow
使用並行疊代執行的步驟數。取樣頻率為每 60 秒一次。取樣完畢後,會有多達 120 秒無法查看資料。
revision_id:執行的工作流程修訂版本 ID。
parallel_iteration_substep_count GA(project)
並行疊代子步驟數
DELTAINT641
workflows.googleapis.com/Workflow
並行疊代中執行的步驟數量。取樣頻率為每 60 秒一次。取樣完畢後,會有多達 120 秒無法查看資料。
revision_id:執行的工作流程修訂版本 ID。
parallel_unhandled_exceptions_limit_count GA(project)
並行未處理例外狀況限制計數
DELTAINT641
workflows.googleapis.com/Workflow
達到未處理平行例外狀況限制的次數。取樣頻率為每 60 秒一次。取樣完畢後,會有多達 120 秒無法查看資料。
revision_id:執行的工作流程修訂版本 ID。
pending_io_requests GA(project)
待處理的 IO 要求
GAUGEINT641
workflows.googleapis.com/Workflow
正在處理中的 I/O 要求數量。取樣頻率為每 60 秒一次。取樣完畢後,會有多達 120 秒無法查看資料。
revision_id:執行的工作流程修訂版本 ID。
sent_bytes_count Beta 版(專案)
傳送的網路位元組數
DELTAINT64By
workflows.googleapis.com/Workflow
工作流程傳送的連出 HTTP 位元組數量 (網址、標頭和主體)。
revision_id:執行的工作流程修訂版本 ID。
started_execution_count Beta 版(project)
已啟動的執行次數
DELTAINT641
workflows.googleapis.com/Workflow
工作流程已啟動執行作業的數量。
revision_id:執行的工作流程修訂版本 ID。
started_vpcsc_executions_count GA(專案)
已啟動的 VPC-SC 執行次數計數
DELTAINT641
workflows.googleapis.com/Workflow
已啟動的 VPC-SC 受限執行作業數。取樣頻率為每 60 秒一次。取樣完畢後,會有多達 120 秒無法查看資料。
revision_id:執行的工作流程修訂版本 ID。
vpcsc_protected_io_count GA(project)
VPC-SC 受保護的 I/O 次數
DELTAINT641
workflows.googleapis.com/Workflow
使用 VPC-SC 提出的 I/O 要求數量。每 60 秒取樣一次。取樣完畢後,會有多達 120 秒無法查看資料。
revision_id:執行的工作流程修訂版本 ID。

表格產生時間:2025 年 5 月 8 日 23 點 28 分 21 秒 (世界標準時間)。

讀取指標資料

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

監控配額指標

以下範例說明如何使用 API Explorer 查詢工作流程的總用量分配配額。具體來說,它會在 Consumer Quota 資源類型上使用 serviceruntime.googleapis.com/quota/allocation/usage 指標。您可以設定其他標籤篩選器 (servicequota_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」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 資訊主頁和快訊

您可以使用監控資訊主頁及其相關圖表,以視覺化方式呈現工作流程指標的資料。

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

後續步驟