アプリケーション トポロジを表示する

このドキュメントでは、アプリケーション モニタリングが App Hub のアプリケーション、サービス、ワークロード用に作成するトポロジマップを表示する方法について説明します。アプリケーション トポロジマップは、アプリケーションの関係を動的に表示し、アラートとトラフィックのモニタリングや問題のトラブルシューティングに役立ちます。

トポロジマップについて

アプリケーション トポロジマップは、アプリケーションのパフォーマンスの動的で実用的なビューを提供し、モニタリングとトラブルシューティングを簡素化します。トポロジマップは、次のようにノードとエッジを使用してアプリケーションを表します。

  • ノードは、アプリケーションのサービスとワークロードを表します。

    サンプル アプリケーションのトポロジ。

  • エッジは、サービスとワークロード間のアプリケーションのトラフィックを表します。

    エッジにはレイテンシとエラー率が表示されます。

トポロジマップは完全にインタラクティブです。ノードをズームイン、ズームアウト、移動して、サービスとワークロードの関係を可視化できます。特定のノードまたはエッジのステータスに関する詳細情報を提供するパネルを開くには、ノードまたはエッジをクリックします。

始める前に

アプリケーション トポロジマップを生成するには、トレースデータにアプリケーション固有のラベルが含まれている必要があります。これらのラベルは、OpenTelemetry でアプリを計測し、トレースデータを Telemetry API に送信して、アプリケーションを App Hub に登録した場合にのみ使用できます。

作業を始める前に、次のことを行います。

  1. アプリケーション モニタリングを設定するの説明に沿って、アプリケーション モニタリングを構成します。アプリケーション モニタリングの設定には、トレースデータを保存するすべてのプロジェクトを一覧表示するようにデフォルトのトレース スコープを構成することが含まれます。
  2. アプリ対応フォルダを使用している場合、プロジェクトには App Topology API の使用を禁止するデフォルトの Service Usage Restriction ポリシーが設定されます。この問題を解決するには、組織ポリシー管理者のロールを持つユーザーが、アプリ対応フォルダ管理プロジェクトのポリシー許可リストに apptopology.googleapis.com を追加する必要があります。組織レベルでポリシーが設定されている場合もあります。詳細については、リソース使用量の制限をご覧ください。

  3. Enable the Observability, App Topology, and Telemetry APIs.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the APIs

    トレース スコープに他のプロジェクトを追加した場合は、それらのプロジェクトでも Observability API を有効にすることをおすすめします。アプリケーション トポロジマップには、App Hub プロジェクトと同じ組織内のトレース スコープ プロジェクトのトレースエッジのみが表示されます。

  4. アプリケーション トポロジの表示に必要な権限を取得するには、プロジェクトに対するアプリトポロジ閲覧者（roles/apptopology.viewer）IAM ロールを付与するよう管理者に依頼してください。ロールの付与については、プロジェクト、フォルダ、組織に対するアクセス権の管理をご覧ください。

    この事前定義ロールには、アプリケーション トポロジの表示に必要な権限が含まれています。必要とされる正確な権限については、「必要な権限」セクションを開いてご確認ください。

    必要な権限

    アプリケーション トポロジを表示するには、次の権限が必要です。

    • トポロジを生成するには: apptopology.applicationTopologies.generate

    カスタムロールや他の事前定義ロールを使用して、これらの権限を取得することもできます。

  5. OpenTelemetry を使用するようにアプリケーションを計測し、トレースデータを OTLP エンドポイントに送信します。

トポロジマップを表示する

  1. Google Cloud コンソールで、[アプリケーションのモニタリング] ページに移動します。

    [アプリケーションのモニタリング] に移動

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

  2. Google Cloud コンソールのプロジェクト選択ツールで、App Hub ホスト プロジェクトまたは管理プロジェクトを選択します。

  3. リストからアプリケーションを選択します。

  4. [トポロジ] タブをクリックします。アプリケーションのトポロジマップが表示されます。

トポロジマップは完全にインタラクティブです。ノードをズームイン、ズームアウト、移動して、サービスとワークロードの関係を可視化できます。ノードまたはエッジの詳細を表示することもできます。

  • サービスまたはワークロードの未解決のアラートまたは属性を表示するには、ノードを選択します。
  • 2 つのノード間のレイテンシとエラー率を表示するには、エッジを選択します。

トラブルシューティング

アプリケーション トポロジマップにデータが表示されない理由を判断するための情報については、アプリケーション モニタリングのトラブルシューティングをご覧ください。