合成モニターの結果を確認する

このドキュメントでは、合成モニタの実行履歴を調べる方法と、収集された指標とログを表示する方法について説明します。

この機能は Google Cloud プロジェクトでのみサポートされています。App Hub 構成の場合は、App Hub ホスト プロジェクトまたはアプリ管理用フォルダの管理プロジェクトを選択します。

始める前に

合成モニターを保存する Google Cloud プロジェクトで、次の操作を行います。

• Google Cloud コンソールを使用して合成モニターの実行結果を表示するために必要な権限を取得するには、プロジェクトに対する次の IAM ロールを付与するよう管理者に依頼してください。

  • モニタリング閲覧者（roles/monitoring.viewer）
  • Cloud Functions デベロッパー（roles/cloudfunctions.developer）
  • ログ閲覧者（roles/logging.viewer）

  ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。

  必要な権限は、カスタムロールや他の事前定義ロールから取得することもできます。

合成モニターの実行履歴を表示する

実行の成否の履歴を確認するには、合成モニターの [合成モニターの詳細] ページをご覧ください。

1. Google Cloud コンソールで、[ 合成モニタリング] ページに移動します。

   [合成モニタリング] に移動

   このページを検索バーで検索する場合は、小見出しが「Monitoring」の結果を選択します。

2. Google Cloud コンソールのツールバーで、 Google Cloud プロジェクトを選択します。App Hub 構成の場合は、App Hub ホスト プロジェクトまたはアプリ管理用フォルダの管理プロジェクトを選択します。
3. [合成モニターの詳細] ページを開くには、表示する合成モニターを見つけて、その名前をクリックします。

[合成モニターの詳細] ページに、成功率と期間、最新のステータスなどの概要情報が表示されます。このページには、実行について記録された所要時間のグラフが表示されます。また、実行ごとに 1 行の表も表示されます。

表の各行には、ステータス、日付、所要時間が表示されます。また、その実行に関連する現在のコードとログを示すページへのリンクも表示されます。

実行のログを表示して追跡する

実行のログ、トレース、概要情報を表示するには、[合成モニターの詳細] ページで実行のリンクをクリックします。このページでは、次のことができます。

• ログデータを表示する。
• トレースデータを表示する。

• 現在のコードを表示する。

• Cloud Run functions の関数にアクセスします。

• Mocha テストの場合は、各テストの結果を表示します。たとえば、合成モニターに 4 つの Mocha テストが含まれている場合、[テスト結果] ペインには 4 つのエントリが表示されます。リスト内の各エントリには、成功または失敗のアノテーションが付けられます。

  失敗とマークされたエントリを選択すると、失敗したコードがハイライト表示されます。

ログデータを表示する

ログは Cloud Monitoring によって自動的に収集されます。これらのログには、テストと障害の詳細に関する情報が含まれています。使用可能なログは、Cloud Run Functions の関数によって異なります。たとえば、Mocha を使用する場合、ログには、テストの成否の情報と、テスト期間に関する情報が含まれます。テストが失敗した場合は、完全なスタック トレースの情報も含まれます。スタック トレースには、失敗したコード行、エラータイプ、エラー メッセージが含まれます。

関連するログの詳細を表示するには、[実行ログ] ペインでログエントリを開きます。

ログエントリは JSON 形式で表示されます。ログ エクスプローラでログを表示する場合は、[ログ エクスプローラで開く] をクリックします。ログ エクスプローラが開き、クエリが事前構成されます。

トレースデータを表示する

トレースデータは、Cloud Run Functions の関数の実行時に収集されます。トレースデータを表示するには、 Google Cloud コンソールまたは Cloud Trace API を使用してトレースデータを表示します。

Cloud Run Functions の関数のログと指標を表示する

ログと指標には、Cloud Run functions の関数が実行しているアクションに関する情報が含まれます。たとえば、値が GoogleStackdriverMonitoring-UptimeChecks の userAgent というフィールドを含むログは、サービスが稼働時間チェック サービスからリクエストを受信したことを示します。

このセクションの後半では、Cloud Run functions の関数によって収集されたログと指標を表示する方法について説明します。

関数のログを表示する

関数の指標を表示する

合成モニターの場合、指標は Cloud Monitoring と Cloud Run functions の両方によって収集されます。

• Cloud Monitoring は、合成モニターの各実行に関する指標を収集します。これらの指標には、コード実行のレイテンシと成功履歴が含まれます。これらの指標を表示する方法については、合成モニターの実行履歴を表示するをご覧ください。

• Cloud Run functions は、各 Cloud Run functions の関数に関する指標を収集します。これらの指標は、実行時間、メモリ使用率、インスタンス数、セクションあたりの呼び出し回数を記録します。このセクションの残りの部分では、これらの指標を表示する方法について説明します。