このページは Cloud Translation API によって翻訳されました。

ワークフローをモニタリングする

Google Cloud Observability は、モニタリング、ロギング、診断ツールを提供します。これらのツールは、ワークフローのデプロイと実行をモニタリングして分析し、アプリケーションの動作、健全性、パフォーマンスを把握するのに役立ちます。

デフォルトでは、Workflows は次の処理を行うように構成されています。

データとシステム監査ログを Cloud Logging に送信します。収集されたログを使用して、アプリケーションのデバッグとトラブルシューティングを行い、アプリケーションに関する分析情報を取得できます。
システム指標とリソース指標を Cloud Monitoring に送信する。収集された指標を使用して、正常性とパフォーマンスのモニタリング、傾向や問題の特定、動作変更の通知を行うことができます。

Cloud Logging に監査ログを送信する

Workflows は、次の種類の監査ログデータを Cloud Logging に送信します。

データアクセス監査ログは非常に大きくなる可能性があるため、デフォルトでは無効になっています。詳細については、データアクセス監査ログを有効にするをご覧ください。

Workflows の監査ログの詳細については、以下をご覧ください。

実行ログを Cloud Logging に送信することもできます。

Cloud Monitoring に指標を送信する

Workflows は、モニタリング対象リソースの指標データを Google Cloud Observability に送信します。Monitoring のモニタリング対象リソースは、仮想マシン、データベース、アプリケーションなどの論理エンティティまたは物理エンティティを表します。モニタリング対象リソースには、ダッシュボードを通じて調査、報告したり、アラートの作成に使用したりできる一意の指標セットが含まれています。各リソースには、リソースに関する追加情報を保持する Key-Value ペアである一連のリソースラベルもあります。リソースラベルは、リソースに関連付けられたすべての指標で使用できます。

すべてのリソースタイプを表示するには、モニタリング対象リソースタイプをご覧ください。すべての指標タイプを表示するには、Google Cloud 指標をご覧ください。Workflows から Google Cloud Observability に送信される指標タイプのリストを表示するには、次を開きます。

Workflows の指標タイプ

次の表の指標タイプの文字列には、workflows.googleapis.com/ という接頭辞を付ける必要があります。この接頭辞は表内で省略されています。ラベルをクエリする場合は、metric.labels. 接頭辞を使用します（例: metric.labels.LABEL="VALUE"）。

指標タイプ^{リリースステージ} （リソース階層レベル）表示名
種類、タイプ、単位モニタリング対象リソース	説明ラベル
`await_callback_step_count` ^GA （プロジェクト）コールバック待機ステップ数
`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 （プロジェクト） CMEK で保護されたワークフローの数
`DELTA`、`INT64`、`1` workflows.googleapis.com/Workflow	CMEK 保護でデプロイされたワークフローの数。60 秒ごとにサンプリングされます。サンプリング後、データは最長 120 秒間表示されません。 `revision_id`: 実行されたワークフローのリビジョン ID。
`compute_slice_count` ^GA （プロジェクト）コンピューティングスライス数
`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 （プロジェクト）コールバックステップの作成数
`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 （プロジェクト）イベントの確認応答までのレイテンシ
`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 （プロジェクト）実行バックログサイズ
`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 （プロジェクト）外部ステップ数
`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 （プロジェクト）内部実行エラー数
`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 （プロジェクト） 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 （プロジェクト） KMS 復号レイテンシ
`DELTA`、`DISTRIBUTION`、`ms` workflows.googleapis.com/Workflow	CMEK のワークフローによる KMS への復号リクエストのレイテンシ。60 秒ごとにサンプリングされます。サンプリング後、データは最長 120 秒間表示されません。 `revision_id`: 実行されたワークフローのリビジョン ID。 `status`: 復号リクエストのステータス。 `attempts`: （INT64）復号リクエストの試行回数。
`kms_decrypt_request_count` ^GA （プロジェクト） KMS 復号リクエスト数
`DELTA`、`INT64`、`1` workflows.googleapis.com/Workflow	CMEK 用にサービスによって行われた KMS 復号リクエストの数。60 秒ごとにサンプリングされます。サンプリング後、データは最長 120 秒間表示されません。 `revision_id`: 実行されたワークフローのリビジョン ID。 `status`: 復号リクエストのステータス。
`kms_encrypt_latencies` ^GA （プロジェクト） KMS 暗号化レイテンシ
`DELTA`、`DISTRIBUTION`、`ms` workflows.googleapis.com/Workflow	CMEK のワークフローによる KMS への暗号化リクエストのレイテンシ。60 秒ごとにサンプリングされます。サンプリング後、データは最長 120 秒間表示されません。 `revision_id`: 実行されたワークフローのリビジョン ID。 `status`: 暗号化リクエストのステータス。 `attempts`: （INT64）暗号化リクエストの試行回数。
`kms_encrypt_request_count` ^GA （プロジェクト） KMS 暗号化リクエスト数
`DELTA`、`INT64`、`1` workflows.googleapis.com/Workflow	サービスが CMEK に対して行った KMS 暗号化リクエストの数。60 秒ごとにサンプリングされます。サンプリング後、データは最長 120 秒間表示されません。 `revision_id`: 実行されたワークフローのリビジョン ID。 `status`: 暗号化リクエストのステータス。
`parallel_branch_step_count` ^GA （プロジェクト）並列ブランチステップ数
`DELTA`、`INT64`、`1` workflows.googleapis.com/Workflow	並列ブランチを使用して実行されたステップの数。60 秒ごとにサンプリングされます。サンプリング後、データは最長 120 秒間表示されません。 `revision_id`: 実行されたワークフローのリビジョン ID。
`parallel_branch_substep_count` ^GA （プロジェクト）並列ブランチのサブステップ数
`DELTA`、`INT64`、`1` workflows.googleapis.com/Workflow	並列ブランチ内で実行されたステップの数。60 秒ごとにサンプリングされます。サンプリング後、データは最長 120 秒間表示されません。 `revision_id`: 実行されたワークフローのリビジョン ID。
`parallel_iteration_step_count` ^GA （プロジェクト）並列イテレーションステップ数
`DELTA`、`INT64`、`1` workflows.googleapis.com/Workflow	並列反復処理を使用して実行されたステップの数。60 秒ごとにサンプリングされます。サンプリング後、データは最長 120 秒間表示されません。 `revision_id`: 実行されたワークフローのリビジョン ID。
`parallel_iteration_substep_count` ^GA （プロジェクト）並列イテレーションサブステップ数
`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 （プロジェクト）保留中の 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 バイト数（URL、ヘッダー、本文）。 `revision_id`: 実行されたワークフローのリビジョン ID。
`started_execution_count` ^BETA （プロジェクト）開始された実行数
`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-08-28 21:10:54 UTC

指標データを読み取る

指標データ（時系列データ）は、Cloud Monitoring API の timeSeries.list メソッドを使用して読み取ることができます。このメソッドを呼び出すには、言語固有のクライアントライブラリを使用する方法や、Metrics Explorer でグラフを作成する方法など、いくつかの方法があります。また、フォームベースの API Explorer を使用して timeSeries.list メソッドを試すこともできます。指標と時系列の概要については、指標、時系列、リソースをご覧ください。指標データの読み取り方法については、時系列データを取得するをご覧ください。

割り当て指標のモニタリング

次の例は、API Explorer を使用して Workflows の合計使用割り当てをクエリする方法を示しています。具体的には、Consumer Quota リソースタイプの serviceruntime.googleapis.com/quota/allocation/usage 指標を使用します。割り当てタイプを指定するように、追加のラベルフィルタ（service、quota_metric）を設定できます。割り当て指標のモニタリング方法（例やアラートポリシーの作成方法など）の詳細については、割り当て指標をグラフ化してモニタリングするをご覧ください。

timeSeries.list リファレンスページを開きます。
[Try this method] ペインが表示されていない場合は、[Try it!] をクリックします。
[name] フィールドに、次の形式で Google Cloud プロジェクト ID を入力します。
```
projects/PROJECT_ID
```
[フィルタ] フィールドで、単一の指標タイプと、必要に応じて指標ラベルやその他の情報を指定します。次に例を示します。
```
metric.type = "serviceruntime.googleapis.com/quota/allocation/usage" AND resource.labels.service = "workflowexecutions.googleapis.com"
```
[interval.endTime] フィールドに、返されるデータの量を制限する終了時間を入力します。これは使用量に適用されます。RFC 3339 文字列（2024-11-07T03:01:02Z など）としてフォーマットする必要があります。
interval.startTime フィールドに、返されるデータの量を制限する開始時刻を入力します。これは使用量に適用されます。RFC 3339 文字列としてフォーマットする必要があります（例: 2024-11-07T03:01:00Z）。

[実行] をクリックします。

結果は次のようになります。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"
         }
      }
      ]
   }

折りたたまれた API Explorer のサイドパネルで、全画面表示をクリックして API 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 ダッシュボードとそれに関連するグラフを使用すると、Workflows 指標のデータを可視化できます。

Monitoring でこうした指標をモニタリングするために、カスタムダッシュボードを作成できます。こうした指標に基づいてアラートを追加することもできます。

ワークフローをモニタリングする コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。