Cloud Tasks のオブザーバビリティ

Google Cloud Observability には、モニタリング、ロギング、診断 ツールが用意されています。これらのツールを使用すると、Cloud Tasks のアクティビティと増加をモニタリングして分析し、アプリケーションの動作、健全性、パフォーマンスを把握できます。

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

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

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

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

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

詳細については、 Cloud Tasks の監査ロ/1}ギングをご覧ください。

キューで Cloud Logging を使用する

Cloud Logging を Cloud Tasks キューで使用できます。次のオペレーションがログに記録されます。

  • タスクに関するオペレーション:
    • CreateTask
    • DeleteTask
  • 試行に関するオペレーション:
    • AttemptDispatch
    • AttemptResponse

ロギングを有効にする

ロギングを有効にするには、 Google Cloud コンソールまたは Google Cloud CLI を使用します。

コンソール

  1. コンソールで、[Cloud Tasks] [>] [キュー] ページに移動します。 Google Cloud

    [キュー] に移動

  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. コンソールで、[Cloud Tasks] [>] [キュー] ページに移動します。 Google Cloud

    [キュー] に移動

  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 に置き換えます。

ログのクエリと表示

次のツールを使用して、ログを表示して分析できます。

ログ エクスプローラの検索フィールドで cloudtasks を検索すると、Cloud Tasks ログをフィルタできます。

ログのクエリと分析の詳細については、 ログのクエリと表示の概要をご覧ください。

Cloud Monitoring に指標を送信する

Cloud Tasks は、モニタリング対象リソースの指標データを Google Cloud Observability に送信します。Monitoring のモニタリング対象リソースは、仮想マシン、データベース、アプリケーションなどの論理エンティティまたは物理エンティティを表します。モニタリング対象リソースには、ダッシュボードを通じて調査、報告したり、アラートの作成に使用したりできる一意の指標セットが含まれています。

Cloud Tasks は、次のモニタリング対象リソースの指標データを Google Cloud Observability に送信します。

各リソースには、リソースに関する追加情報を保持する Key-Value ペアである一連のリソースラベルもあります。リソースラベルは、リソースに関連付けられたすべての指標で使用できます。詳細については、次の表をご覧ください。

リソース指標とラベル

次の表の指標タイプの文字列には、 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  （プロジェクト）
タスクの試行回数
DELTA、INT64、1
cloud_tasks_queue 		レスポンス コード別のタスクの試行回数。60 秒ごとにサンプリングされます。サンプリング後、データは最長 180 秒間表示されません。
response_code：文字列での正規のレスポンス コード（例: OK）。
queue/task_attempt_delays GA  （プロジェクト）
タスクの試行の遅延
DELTA, DISTRIBUTION, ms
cloud_tasks_queue 		予定された試行時間と実際の試行時間の間の遅延。60 秒ごとにサンプリングされます。サンプリング後、データは最長 120 秒間表示されません。

表の生成日時: 2026-03-27 03:31:46 UTC。

すべてのリソースタイプを表示するには、モニタリング対象リソースタイプをご覧ください。 すべての指標タイプを表示するには、Google Cloud 指標をご覧ください。

指標データを読み取る

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

Monitoring ダッシュボードとアラートの使用

Monitoring ダッシュボードとそれに関連するグラフを使用すると、Cloud Tasks 指標のデータを可視化できます。

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