複数のプロジェクトにわたるトレースの表示

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(Identity and Access Management)ロールとログ閲覧者 IAM ロールがあることを確認します。

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

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

    Cloud Trace の組織ビュー。

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

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

「スタートガイド」セクションの手順を完了したら、次の操作を行います。

  1. Google Cloud コンソールで [トレース] を選択し、  [Trace エクスプローラ] を選択するか、次のボタンをクリックします。

    Trace エクスプローラに移動

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

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

    Cloud Trace エクスプローラ ページの例。

    [Trace エクスプローラ] ページには、現在選択されているプロジェクトのトレースが表示されます。このページには、他のプロジェクトのトレースやスパンは表示されません。

  2. 特定のトレースを調べるには、散布図またはテーブルでトレースを選択します。選択すると、[Trace エクスプローラ] ページが変更され、トレースの詳細が表示されます。

    このトレースの調査方法については、トレースを調査するをご覧ください。

次のステップ