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

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

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

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

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

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

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

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

キューで Cloud Logging を使用する

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

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

ロギングを有効にする

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

コンソール

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

    [キュー] に移動

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

    [キュー] に移動

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

ログのクエリと表示

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

  • ログ エクスプローラは、サービスとアプリケーションのパフォーマンスのトラブルシューティングと分析に役立つように設計されています。ログ エクスプローラでログを表示する方法については、ログ エクスプローラを使用してログを表示するの手順をご覧ください。
  • ログ分析は、ログを分析するクエリを実行し、結果を表示またはグラフ化するように設計されています。ログ分析の使用方法については、ログ分析でログをクエリして分析するの手順をご覧ください。

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

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

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 秒間表示されません。

表の生成日時: 2025-08-20 20:46:56 UTC

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

指標データを読み取る

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

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

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

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