複数のプロジェクトのトレースを表示する

Cloud Trace を使用すると、別の Google Cloud プロジェクトでホストされているアプリケーションが生成したトレーススパンも、1 つの Google Cloud プロジェクトで表示できます。このクロス プロジェクト シナリオでは、表示権限のないスパンは Trace によって自動的に除外されます。

AB という Google Cloud プロジェクトがあるケースで考えてみましょう。プロジェクト A によってホストされているアプリケーションにプロジェクト B が gRPC 呼び出しを行うとします。Google Cloud Console を開いてプロジェクト A を選択すると、プロジェクト A によってホストされているアプリケーションが生成したトレーススパンしか表示できません。具体的には、プロジェクト B がプロジェクト A に gRPC 呼び出しを行うときに生成されるトレーススパンは表示できません。

しかし、プロジェクト A の Google Cloud Console で Trace のクロス プロジェクト機能を利用すると、プロジェクト A によってホストされているアプリケーションが生成したスパンと、プロジェクト B がプロジェクト A に gRPC 呼び出しを行うときに生成されるスパンを表示できます。

このページでは、関連する Google Cloud プロジェクトのトレーススパンを 1 つのビューで表示できるように Cloud Trace を設定する方法について詳しく説明します。

始めに

複数の Google Cloud プロジェクトにわたるトレーススパンを表示するには、次のようにします。

  1. 各 Google Cloud プロジェクトを同じ組織に関連付けます。

    • 組織のコンテキストで新しいプロジェクトを作成する場合、プロジェクトは組織リソースの下に自動的に作成されます。

      [新しいプロジェクト] ダイアログで、プロジェクトを作成している組織を確認できます。

      組織を表示する [新しいプロジェクト] ペイン。

    • 組織の一部ではない Google Cloud プロジェクトがある場合は、そのプロジェクトを組織内に移動できます。詳細については、組織へのプロジェクトの移行をご覧ください。

  2. 各プロジェクトに対する Cloud Trace ユーザー IAM(Cloud Identity and Access Management)役割とログ閲覧者 IAM 役割があることを確認します。

  3. プロジェクトの組織への読み取りアクセスのための resourcemanager.organizations.get 権限があることを確認します。この権限は、組織閲覧者 IAM 役割の一部です。

    この権限を持っているかどうかをテストするには、Cloud Console の上部にあるプロジェクト セレクタを開き、組織のプルダウン メニューが表示されることを確認します。

    Cloud Trace 組織の表示。

  4. ホストされているプロジェクトにトレースを書き込むようにアプリケーションを構成します。

複数のプロジェクトでトレースの詳細を表示する

「はじめに」の手順を完了したら、次の操作を行います。

  1. Cloud Console で [トレース] > [トレースリスト] の順に選択するか、次のボタンをクリックします。

    [トレースリスト] に移動

    クロス プロジェクト トレースを表示するよう構成したプロジェクトのいずれかを選択してください。 前の例では、プロジェクト A またはプロジェクト B を選択します。

    Stackdriver Trace を初めて使用する場合、トレースが表示されるまでに数分かかることがあります。詳細については、トレースの検索と表示をご覧ください。次のスクリーンショットは、[トレースリスト] ページの例を示しています。

    Cloud トレースリストのページ。

    トレース結果のリストと散布図は、現在選択されているプロジェクトのみに基づいており、トレース内の他のプロジェクトには適用されません。

  2. [トレースリスト] で任意のリクエスト URI をクリックしてトレースの詳細を表示します。トレースの詳細がグラフの下に表示されます。

    Cloud Trace の詳細ペイン。

    トレースに関連付けられたすべてのプロジェクトのトレーススパンがトレースの詳細に表示されます。トレースの詳細は、現在選択されているプロジェクトのトレーススパンに限定されません。

  3. タイムラインでトレーススパンを表す青いバーをクリックすると、[詳細] ペインが表示されます。トレーススパンに関連付けられているプロジェクト ラベルと、関連する詳細情報が表示されます。

次のステップ