アプリケーション モニタリングのトラブルシューティング

このドキュメントでは、[アプリケーション モニタリング] ページに表示されるデータについて説明します。また、アプリケーションのデータを表示できるように Google Cloud プロジェクトを構成する際に役立つ情報も含まれています。

既知の問題

このセクションでは、アプリケーション モニタリングに関連する既知の問題について説明します。

  • アプリケーション モニタリングでは、トレース レイテンシは使用できません。トレースデータを表示するには、[Trace エクスプローラ] ページを使用する必要があります。詳細については、トレースを検索して調査するをご覧ください。

トラブルシューティング

このセクションでは、Application Monitoring に関連する問題を解決する方法について説明します。

アプリケーションを作成するよう求められる

Google Cloud コンソールで [アプリケーション モニタリング] ページを開くと、[アプリケーションを作成して開始] というメッセージが表示されます。App Hub アプリを登録しているため、このメッセージが表示されることはありません。

このエラーを解決するには、リソース選択ツールが App Hub ホスト プロジェクトまたはアプリ対応フォルダの管理プロジェクトに設定されていることを確認します。

一部のゴールデン シグナルのデータがアプリに表示されない

ゴールデン シグナルの値が表示されない理由はいくつかあります。

  • インフラストラクチャが指標タイプをサポートしていない。たとえば、ネットワーク ロードバランサはシステム指標をサポートしていません。詳細については、App Hub でサポートされているリソースをご覧ください。

  • 指標タイプはサポートされていますが、利用可能なデータはありません。たとえば、指標データが収集されていない期間に期間が設定されている場合、ゴールドシグナルに表示するデータはありません。

App Hub ラベルを生成するリソースの一覧については、App Hub でサポートされているリソースをご覧ください。

アプリケーションの指標データがないか、不完全です

サービスまたはワークロードのグラフを表示すると、このグラフに指標データが表示されないか、一部のデータが欠落しています。

何もする必要がない場合があります。サービスまたはワークロードの事前定義済みダッシュボードに追加されるグラフは、そのサービスまたはワークロードで使用されるリソースに基づいて選択されます。ただし、一部のリソースでは、特定の指標タイプのデータが生成されない場合があります。App Hub ラベルを生成するリソースの一覧については、App Hub でサポートされているリソースをご覧ください。

指標データが不完全な場合は、次の操作を行います。

  1. プロジェクト選択ツールが、App Hub ホスト プロジェクトまたはアプリ対応フォルダの管理プロジェクトに設定されていることを確認します。

  2. 組織管理者が、App Hub ホスト プロジェクトの指標スコープまたはアプリ対応フォルダの管理プロジェクトの指標スコープを構成して、アプリケーションの指標データを保存するプロジェクトを一覧表示できるようにします。詳細については、アプリケーション モニタリングを設定するをご覧ください。

アプリケーションのログデータが存在しないか、不完全である

ダッシュボードのログパネルにログエントリが表示されない、またはアプリケーションによって生成されたログエントリがすべて表示されない。

この問題を解決するには、次の操作を行います。

  1. ログデータを表示するために必要な権限を取得するには、次の IAM ロールを付与するよう管理者に依頼します。

    • App Hub ホスト プロジェクト、アプリ対応フォルダの管理プロジェクト、デフォルトのログスコープが指定されている他のプロジェクトに対するログビューア （roles/logging.viewer）。このロールには、_Default ログバケット内のほとんどのログエントリへのアクセス権が付与されます。詳細については、Logging のロールをご覧ください。
    • App Hub ホスト プロジェクトのデフォルトのログスコープまたはアプリ対応フォルダの管理プロジェクトにリストされているログビューに対するログビュー アクセサー （roles/logging.viewAccessor）。ログビューへのアクセス権の付与の詳細については、ログビューへのアクセスを制御するをご覧ください。

  2. 組織管理者が、App Hub ホスト プロジェクトのデフォルトのログスコープまたはアプリ対応フォルダの管理プロジェクトを構成して、アプリケーションのログデータを保存するリソースを一覧表示していることを確認します。詳細については、アプリケーション モニタリングを設定するをご覧ください。

アラート ポリシーがない

アラート ポリシーをアプリケーション モニタリング ダッシュボードに表示するには、ポリシーに特定のラベルを追加して、アラート ポリシーをサービスまたはワークロードに関連付ける必要があります。

Google Cloud コンソールを使用してアラート ポリシーをワークロードまたはサービスに関連付けるには、次の操作を行います。

  1. Google Cloud コンソールで、 [アラート] ページに移動します。

    [アラート] に移動

    検索バーを使用してこのページを検索する場合は、小見出しが [Monitoring] である結果を選択します。

  2. Google Cloud コンソールのツールバーで、App Hub ホスト プロジェクトまたはアプリ対応フォルダの管理プロジェクトを選択します。
  3. アラート ポリシーを見つけて、 [その他] をクリックし、[編集] を選択して、[通知と名前] セクションに移動します。
  4. [アプリケーション ラベル] セクションで、アプリケーションを選択してから、ワークロードまたはサービスを選択します。
  5. [ポリシーを保存] をクリックします。

これらの手順を完了すると、次のキーを持つラベルがアラート ポリシーにアタッチされます。これらのラベルは、アプリケーションとサービスまたはワークロードを識別します。

  • apphub_application_location
  • apphub_application_id
  • apphub_service_id または apphub_workload_id

Google Cloud CLI、Terraform、または Cloud Monitoring API を使用して、アラート ポリシーにユーザーラベルを追加することもできます。ただし、前の例に示したラベルキーを使用する必要があります。詳しくは以下をご覧ください。

アラート ポリシーにアプリケーション ラベルを追加したが、ポリシーが表示されない

このエラーを解決するには、ポリシーに次のラベルが含まれていることを確認します。

  • apphub_application_location
  • apphub_application_id
  • apphub_service_id または apphub_workload_id

サービスとワークロードのダッシュボードが異なる

ご対応いただく必要はありません。

サービスまたはワークロードで使用されるリソースによって、そのサービスまたはワークロードに表示されるデータが決まります。

表示しているダッシュボードの変更を保存できない

サービスまたはワークロードのダッシュボードに表示されるデータを探索していて、変更を保存する場合。ツールバーに [ダッシュボードに保存] ボタンが表示されます。ただし、このボタンを選択すると、現在のダッシュボードに変更を保存することはできません。

[ダッシュボードに保存] ボタンは、表示しているダッシュボードが読み取り専用の場合にのみ表示されます。ただし、このボタンを使用して、変更をカスタム ダッシュボードに保存できます。詳細については、ダッシュボードの概要をご覧ください。

グラフを保存できない

テレメトリー データを探索している場合、ツールバーの [ダッシュボードに保存] ボタンは無効になります。

このエラーを解決するには、十分な権限があることを確認してください。

カスタム ダッシュボードへの変更を保存するために必要な権限を取得するには、App Hub ホスト プロジェクトまたはアプリ対応フォルダの管理プロジェクトに対する モニタリング編集者 （roles/monitoring.editor）の IAM ロールを付与するよう管理者に依頼してください。

予期しないインシデントが開かれている

Application Monitoring のリリースにより、metadata.system_labels.apphub_host_project_id ラベルの名前が metadata.system_labels.apphub_application_container に変更されました。この変更により、新しいインシデントが生成されたり、開いているインシデントがクローズされなかったりする可能性があります。たとえば、指標不在ポリシーの場合、ラベルの変更によってモニタリング対象の時系列でサンプルのレポートが停止する可能性があるため、通知が届くことがあります。

ご対応いただく必要はありません。データの受信が停止すると、自動クローズ期間が終了した後にインシデントは自動的にクローズされます。詳細については、部分的な指標データをご覧ください。

アプリ対応フォルダ内のログにアクセスできない

Google Cloud コンソールのリソース選択ツールで、アプリ対応のフォルダを選択しました。その後、ログ エクスプローラ ページなどの Google Cloud Observability ページを開くと、リソース選択ツールがプロジェクトにリセットされます。

これは意図された動作です。アプリ対応のフォルダを選択して Google Cloud Observability ページにアクセスすると、選択したリソースはフォルダの管理プロジェクトにリセットされます。通常、アプリケーションのテレメトリー データを表示する場合は、プロジェクトを選択します。

アプリで有効になっているフォルダのログにアクセスするには、リソース選択ツールを使用してフォルダを手動で選択します。