Google Cloud 觀測功能提供監控、記錄和診斷工具。這些工具可協助您監控及分析工作流程部署和執行作業,並瞭解應用程式的行為、健康狀態和效能。
根據預設,工作流程會設定為執行下列操作:
- 將資料和系統稽核記錄傳送至 Cloud Logging。您可以使用收集到的記錄來偵錯、排解應用程式問題,並取得相關洞察資料。
- 將系統和資源指標傳送至 Cloud Monitoring。您可以使用收集到的指標來監控健康狀態和效能、找出趨勢和問題,並在行為發生變化時發出通知。
將稽核記錄傳送至 Cloud Logging
Workflows 會將下列類型的稽核記錄資料傳送至 Cloud Logging:
資料存取稽核記錄可能相當大,因此系統預設停用。詳情請參閱「啟用資料存取稽核記錄」。
如要進一步瞭解 Workflows 中的稽核記錄,請參閱以下文章:
將指標傳送至 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)
等待回呼步驟數 |
|
DELTA 、INT64 、1
workflows.googleapis.com/Workflow |
等待回呼的已執行步驟數。取樣頻率為每 60 秒一次。取樣完畢後,會有多達 120 秒無法查看資料。
revision_id :執行的工作流程修訂版本 ID。 |
callback_requests_count
GA
(專案)
回呼要求數量 |
|
DELTA 、INT64 、1
workflows.googleapis.com/Workflow |
觸發回呼的要求數量。取樣頻率為每 60 秒一次。取樣完畢後,會有多達 120 秒無法查看資料。
revision_id :執行的工作流程修訂版本 ID。 |
callback_timeout_count
GA
(專案)
回呼逾時次數 |
|
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
(專案)
Compute Slice Count |
|
DELTA 、INT64 、1
workflows.googleapis.com/Workflow |
已執行的運算片段數量。步驟會以工作片段執行,這取決於要執行的步驟類型 (例如,HTTP 要求會與「指派」步驟分開執行)。取樣頻率為每 60 秒一次。取樣完畢後,會有多達 120 秒無法查看資料。
revision_id :執行的工作流程修訂版本 ID。type :
運算切片的類型,例如「IO_REQUEST」或「WAKEUP」。
has_parallel :
(布林值)
工作流程是否使用並行步驟。
|
compute_slice_latencies
GA
(project)
Compute Slice 延遲時間 |
|
DELTA 、DISTRIBUTION 、ms
workflows.googleapis.com/Workflow |
從排程運算區塊到執行時間的延遲時間。取樣頻率為每 60 秒一次。取樣完畢後,會有多達 120 秒無法查看資料。
revision_id :執行的工作流程修訂版本 ID。type :
運算切片的類型,例如「IO_REQUEST」或「WAKEUP」。
has_parallel :
(布林值)
工作流程是否使用並行步驟。
|
compute_step_count
GA
(project)
計算步驟數 |
|
DELTA 、INT64 、1
workflows.googleapis.com/Workflow |
執行的運算步驟數 (例如「assign」和「for」步驟)。取樣頻率為每 60 秒一次。取樣完畢後,會有多達 120 秒無法查看資料。
revision_id :執行的工作流程修訂版本 ID。 |
compute_step_latencies
GA
(project)
Compute Step Latencies |
|
DELTA 、DISTRIBUTION 、ms
workflows.googleapis.com/Workflow |
已執行運算步驟的延遲時間。取樣頻率為每 60 秒一次。取樣完畢後,會有多達 120 秒無法查看資料。
revision_id :執行的工作流程修訂版本 ID。 |
create_callback_step_count
GA
(專案)
建立回呼步驟計數 |
|
DELTA 、INT64 、1
workflows.googleapis.com/Workflow |
建立回呼的已執行步驟數。取樣頻率為每 60 秒一次。取樣完畢後,會有多達 120 秒無法查看資料。
revision_id :執行的工作流程修訂版本 ID。method :
已建立的回呼方法類型,例如「POST」。
|
deployment_attempt_count
GA
(專案)
部署嘗試次數 |
|
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
(project)
事件回應時間延遲 |
|
DELTA 、DISTRIBUTION 、ms
workflows.googleapis.com/Workflow |
從事件開始到工作流程服務回應的延遲時間。取樣頻率為每 60 秒一次。取樣完畢後,會有多達 120 秒無法查看資料。
revision_id :執行的工作流程修訂版本 ID。event_type :事件類型。 |
event_trigger_count
GA
(專案)
事件觸發事件數 |
|
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 版
(專案)
執行時間 |
|
DELTA 、DISTRIBUTION 、s
workflows.googleapis.com/Workflow |
工作流程執行時間的分佈情形。
revision_id :執行的工作流程修訂版本 ID。 |
external_step_count
Beta 版
(project)
外部步數 |
|
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 |
Workflow 向 Google 服務提出的 I/O 要求數量。取樣頻率為每 60 秒一次。取樣完畢後,會有多達 120 秒無法查看資料。
revision_id :執行的工作流程修訂版本 ID。service_domain :
要呼叫的 Google 服務網域,例如「bigquery.googleapis.com」。
|
io_step_count
GA
(project)
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 :
(布林值)
指出 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 :
(布林值)
指出 I/O 步驟是否發生系統錯誤。
|
kms_decrypt_latencies
GA
(專案)
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 |
CMEK 工作流程向 KMS 傳送加密要求的延遲時間。取樣頻率為每 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
(project)
並行未處理例外狀況限制計數 |
|
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 版
(專案)
傳送的網路位元組數 |
|
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
(project)
VPC-SC 受保護的 I/O 次數 |
|
DELTA 、INT64 、1
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
指標。您可以設定其他標籤篩選器 (service
、quota_metric
) 來指定配額類型。如要進一步瞭解如何監控配額指標 (包括更多範例和建立警示政策的方式),請參閱「繪製及監控配額指標」。
開啟
timeSeries.list
參考頁面。如果沒有看到「試試這個方法」窗格,請按一下「試試看」。
在「name」欄位中,使用以下格式輸入 Google Cloud 專案 ID:
projects/PROJECT_ID
在「filter」欄位中,指定單一指標類型,並視需要指定指標標籤和其他資訊。例如:
metric.type = "serviceruntime.googleapis.com/quota/allocation/usage" AND resource.labels.service = "workflowexecutions.googleapis.com"
在「interval.endTime」interval.endTime欄位中輸入結束時間,以便限制傳回的資料量,並符合您的使用情形。格式應為 RFC 3339 字串,例如
2024-11-07T03:01:02Z
。在 interval.startTime 欄位中輸入開始時間,以便限制傳回的資料量,並符合您的使用情形。格式應為 RFC 3339 字串,例如
2024-11-07T03:01:00Z
。按一下 [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" } } ] }
在收起的 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 中監控這些指標,您可以建立自訂資訊主頁。您也可以根據這些指標新增快訊。