Google Cloud Observability を使用すると、Cloud Tasks のアクティビティ、キューの増加、実行動作をモニタリングして分析できます。収集された指標とログを使用して、アプリケーションの健全性を評価し、タスクの失敗を診断して、パフォーマンスの問題のトラブルシューティングを行うことができます。
デフォルトでは、Cloud Tasks はシステム指標とリソース指標を Cloud Monitoring に送信し、管理アクティビティ監査ログを Cloud Logging にエクスポートします。データアクセス監査ログはデフォルトで無効になっており、明示的な構成が必要です。
Cloud Logging に監査ログを送信する
Cloud Tasks は、次の種類の監査ログデータを Cloud Logging に送信します。
データアクセスの監査ログは非常に大きくなる可能性があるため、デフォルトでは無効になっています。
詳細については、Cloud Tasks の監査ロギングをご覧ください。
キューで Cloud Logging を使用する
Cloud Logging を Cloud Tasks キューで使用できます。次のオペレーションがログに記録されます。
- タスク オペレーション:
CreateTaskDeleteTask
- 試行オペレーション:
AttemptDispatchAttemptResponse
ロギングを有効にする
ロギングを有効にするには、 Google Cloud コンソールまたは Google Cloud CLI を使用します。
コンソール
Google Cloud コンソールで、[Cloud Tasks] > [キュー] ページに移動します。
ロギングを有効にするキューの名前をクリックします。
[キューの詳細] ページで、[ログ] タブをクリックします。
[ログを有効化] をクリックし、[有効にする] をクリックして確定します。
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: キューの IDLOG_SAMPLING_RATIO: ログに記録されるオペレーションの割合。1.0から0.0の範囲の値では、オペレーションの割合がログに記録されます。すべてのオペレーションをログに記録するには、1.0に設定します。オペレーションをログに記録しない場合は、0.0に設定します（これがデフォルトです）。
ロギングを無効にする
ロギングを無効にするには、 Google Cloud コンソールまたは Google Cloud CLI を使用します。
コンソール
Google Cloud コンソールで、[Cloud Tasks] > [キュー] ページに移動します。
ロギングを無効にするキューの名前をクリックします。
[キューの詳細] ページで、[ログ] タブをクリックします。
省略記号アイコン > [ログを無効化] をクリックします。[無効にする] をクリックして確定します。
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 を検索します。
ログのクエリと分析の詳細については、ログのクエリと表示の概要をご覧ください。
Monitoring に指標を送信する
Cloud Tasks は、モニタリング対象リソースの指標データを Google Cloud Observability に送信します。Monitoring のモニタリング対象リソースは、仮想マシン、データベース、アプリケーションなどの論理エンティティまたは物理エンティティを表します。モニタリング対象リソースには、ダッシュボードを通じて調査、報告したり、アラートの作成に使用したりできる一意の指標セットが含まれています。
Cloud Tasks は、次のモニタリング対象リソースから Google Cloud Observability に指標データを送信します。
各リソースには、リソースに関する追加情報を保持する Key-Value ペアである一連のリソースラベルもあります。リソースラベルは、リソースに関連付けられたすべての指標で使用できます。詳細は次の表をご覧ください。
リソース指標とラベル
すべてのリソースタイプを表示するには、モニタリング対象リソースタイプをご覧ください。すべての指標タイプを表示するには、Google Cloud 指標をご覧ください。
指標データを読み取る
指標データ（時系列データ）は、Cloud Monitoring API の timeSeries.list メソッドを使用して読み取ることができます。このメソッドを呼び出すには、言語固有のクライアント ライブラリを使用する方法や、Metrics Explorer でグラフを作成する方法など、いくつかの方法があります。指標と時系列の概要については、指標、時系列、リソースをご覧ください。指標データの読み取り方法については、時系列データを取得するをご覧ください。
Monitoring ダッシュボードとアラートの使用
Monitoring ダッシュボードとそれに関連するグラフを使用すると、Cloud Tasks 指標のデータを可視化できます。
Monitoring でこうした指標をモニタリングするために、カスタム ダッシュボードを作成できます。こうした指標に基づいてアラートを追加することもできます。