このドキュメントでは、合成モニターの実行履歴を確認する方法と、収集された指標とログを表示する方法について説明します。
始める前に
Google Cloud コンソールを使用して合成モニターの実行結果を表示するために必要な権限を取得するには、プロジェクトに対する次の IAM ロールの付与を管理者に依頼してください。
-
モニタリング閲覧者（
roles/monitoring.viewer） -
Cloud Functions デベロッパー（
roles/cloudfunctions.developer） - ログ閲覧者（
roles/logging.viewer）
ロールの付与の詳細については、アクセス権の管理をご覧ください。
必要な権限は、カスタムロールや他の事前定義ロールから取得することもできます。
合成モニターの実行履歴を表示する
実行の成否の履歴を確認するには、合成モニターの [合成モニターの詳細] ページをご覧ください。
-
Google Cloud コンソールで、
[合成モニタリング] ページに移動します。
検索バーを使用してこのページを検索する場合は、小見出しが [Monitoring] である結果を選択します。
- [合成モニターの詳細] ページを開くには、表示する合成モニターを見つけて、その名前をクリックします。
[合成モニターの詳細] ページに、成功率と期間や最新のステータスなどの概要情報が表示されます。このページには、実行の記録された所要時間のグラフも表示され、実行ごとに 1 行の表が表示されます。
テーブルの各行には、ステータス、日付、期間が表示され、その実行に関連する現在のコードとログを表示するページへのリンクも表示されます。
実行のログを表示する
実行のログ、トレース、概要情報を表示するには、[合成モニターの詳細] ページで、実行へのリンクをクリックします。このページでは、次のことができます。
- ログデータを表示する。
- トレースデータを表示する。
現在のコードを表示します。
Cloud Run 関数にアクセスします。
Mocha テストの場合は、各テストの結果を確認します。たとえば、合成モニターに 4 つの Mocha テストが含まれている場合、[テスト結果] ペインには 4 つのエントリが表示されます。リスト内の各エントリには、成功または失敗のアノテーションが付けられます。
失敗とマークされたエントリを選択すると、失敗したコードが表示され、ハイライト表示されます。
ログデータを表示
ログは Cloud Monitoring によって自動的に収集されます。これらのログには、テストと失敗の詳細に関する情報が含まれています。使用可能なログは、Cloud Run Functions によって異なります。たとえば、Mocha を使用する場合、ログには、テストの成否の情報と、テスト期間に関する情報が含まれます。テストが失敗した場合は、完全なスタック トレースの情報も含まれます。スタック トレースには、失敗したコード行、エラータイプ、エラー メッセージが含まれます。
関連するログの詳細を表示するには、[実行ログ] ペインでログエントリを開きます。
ログエントリが JSON 形式で表示されます。ログ エクスプローラを使用してログを表示する場合は、[ログ エクスプローラで開く] をクリックします。ログ エクスプローラが開き、クエリが事前構成されます。
トレースデータを表示する
トレースデータは、Cloud Run Functions の実行時に自動的に収集されます。次のスクリーンショットは、汎用テンプレートを使用した場合にトレースがキャプチャするデータの種類を示しています。
前のスクリーンショットでは、ガントチャートの最初の行に Cloud Monitoring が開始した HTTP リクエストが表示されています。トレースデータは、Winston ロガーに渡されたテキストと、axios get 呼び出しによって発行された送信 HTTP リクエストを表示します。
トレース フライアウトで [Trace で表示] をクリックすると、Cloud Trace エクスプローラを使用してトレースデータを表示できます。トレースはすでに展開され、詳細が表示されています。トレースまたはスパンに円が表示されている場合は、その円をクリックしてログエントリを表示できます。Cloud Run Function は resource.labels.service_name フィールドを表示することで確認できます。
コンソール
トレースデータを表示するには、次のいずれかを行います。
トレースの概要情報を表示するには、実行の詳細ページのツールバーで [トレースの詳細表示] をクリックします。
レイテンシ データの概要を表示するフライアウトが開きます。トレースとそのスパンの詳細については、Cloud Trace でデータを表示します。Cloud Trace を開くには、[Trace で表示] をクリックします。
Cloud Trace でトレースを表示します。
-
Google Cloud コンソールで、[Trace エクスプローラ] ページに移動します。
このページは、検索バーを使用して見つけることもできます。
- 散布図または表で、トレースを選択します。
- スパンに関連付けられたログやイベントごとに、スパンには円でアノテーションが付けられます。イベントまたはログの詳細を確認するには、円を選択します。
-
トレースデータの探索の詳細については、トレースを検索して調査するをご覧ください。
API
トレースデータの表示には Google Cloud コンソールを使用することをおすすめします。ただし、Cloud Trace API を使用する場合は、traces.list メソッドを使用して使用可能なトレースを一覧表示し、traces.get メソッドを使用してトレースの詳細を取得します。
Cloud Run Functions のログと指標を表示する
ログと指標には、Cloud Run 関数が実行しているアクションに関する情報が含まれます。たとえば、値が GoogleStackdriverMonitoring-UptimeChecks の userAgent という名前のフィールドを含むログは、サービスが稼働時間チェック サービスからリクエストを受信したことを示します。
このセクションの後半では、Cloud Run 関数によって収集されたログと指標を表示する方法について説明します。
関数のログを表示する
コンソール
Cloud Run Functions の関数のログを表示するには、次のようにします。
- 合成モニターの名前を含むペインで、Cloud Run Functions の関数名をクリックします。
- [関数の詳細] ページで、[ログ] タブを選択します。
グラフ内のログデータを詳細に調べるには、ログエントリを展開して、[ログ エクスプローラで開く] を選択します。ログ エクスプローラで、クエリの絞り込み、ログベースの指標の作成、またはログベースのアラートの作成などのアクションを実行します。
API
Cloud Run の関数のログをプログラムで読み書きする方法については、ログの作成、表示、処理をご覧ください。
関数の指標を表示する
合成モニターの場合、Cloud Monitoring と Cloud Run の両方の関数によって指標が収集されます。
Cloud Monitoring は、合成モニターの各実行に関する指標を収集します。これらの指標には、コード実行のレイテンシと成功履歴が含まれます。これらの指標を表示する方法については、合成モニターの実行履歴を表示するをご覧ください。
Cloud Run Functions は、各 Cloud Run 関数に関する指標を収集します。これらの指標には、実行時間、メモリ使用率、インスタンス数、セクションごとの呼び出し数が記録されます。このセクションの残りの部分では、これらの指標を表示する方法について説明します。
コンソール
Cloud Run Functions の関数の指標を表示するには、次のようにします。
- 合成モニターの名前を含むペインで、Cloud Run Functions の関数名をクリックします。
- [関数の詳細] ページで、[指標] タブを選択します。
特定の期間を拡大するには、次の操作を行います。
- グラフ上で、期間の一方の終端にポインタを置き、ポインタを左クリックします。
- 期間のもう一方の端までポインタを水平方向にドラッグし、ポインタ ボタンを放します。
グラフに表示されるデータを詳細に調べるには、グラフ ツールバーで more_vert [その他のグラフ オプション] を選択します。次のような操作を行うことができます。
- グラフを PNG または CSV としてダウンロードする
- （省略可）グラフをカスタム ダッシュボードに保存
- Metrics Explorer を開く
- グラフの凡例を展開または折りたたむ
- ズームをリセットする
API
Cloud Run 関数の指標をプログラムで読み取る方法については、モニタリング指標の表示をご覧ください。