Stackdriver Trace について

Google Cloud Platform(GCP)向けの分散トレース システムである Stackdriver Trace は、アプリケーションがユーザーまたは他のアプリケーションから受信したリクエストの処理にかかる時間や、リクエストを処理するときに実行される RPC 呼び出しなどのオペレーションが完了するまでにかかる時間を理解するために役立ちます。

Stackdriver Trace は、App EngineHTTP(S) ロードバランサStackdriver Trace API でインストゥルメントされたアプリケーションからレイテンシ データを収集するため、以下の疑問の解決に役立ちます。

  • アプリケーションがリクエストを処理するのにどのくらい時間がかかるか?
  • アプリケーションがリクエストを処理するのになぜそんなに時間がかかるのか?
  • 一部のリクエストが他のリクエストより時間がかかるのはなぜか?
  • アプリケーションへのリクエストの全体的なレイテンシは?
  • アプリケーションのレイテンシは時間とともに増加しているのか、減少しているのか?
  • アプリケーションのレイテンシを小さくするにはどうすればよいか?
  • アプリケーションにどのような依存関係があるか?

アプリケーションのデバッグまたはプロファイリングについては、アプリケーションのパフォーマンス管理をご覧ください。

環境サポート

Stackdriver Trace は、次の環境の Linux 上で動作します。

Stackdriver Trace は、App Engine スタンダード環境と統合されています。アプリケーションの実行中、App Engine スタンダード環境は、アプリケーション URI へのリクエストに関するレイテンシ データを Stackdriver Trace に自動的に送信します。これらのリクエストには、App Engine サービスへのラウンドトリップ RPC 呼び出しに関するレイテンシ データが含まれています。Stackdriver Trace は、Cloud SQL を除いたすべての App Engine Admin API と連携します。

VM またはコンテナ(Compute Engine、App Engine フレキシブル環境、GKE、他のクラウド プロバイダやオンプレミスで実行されているものを含む)上のアプリケーションは、クライアント ライブラリを使用して、トレース情報を取得するようアプリケーションをインストゥルメントする必要があります。言語ごとの設定手順については、Stackdriver Trace の設定をご覧ください。

言語のサポート

クライアント ライブラリは、主要なすべての言語で用意されています。一部の言語では、Stackdriver Trace 用の OpenCensus ライブラリが利用可能です。

言語 OpenCensus ライブラリ
C# ASP.NET Core ×
C# ASP.NET ×
Go
Java
Node.js
PHP
Python
Ruby ×

ご使用の言語で利用可能な場合は、OpenCensus ライブラリを使用することをおすすめします。OpenCensus では、対応する Stackdriver Trace クライアント ライブラリの複雑さが部分的に解消されるため、インストゥルメンテーションが簡素化されます。

一般的な設定手順については、Stackdriver Trace の設定をご覧ください。

コンポーネント

Stackdriver Trace は、データを収集して GCP プロジェクトに送信するトレース クライアントと、エージェントによって収集されたデータの表示や分析を可能にする GCP 上のコンソール インターフェースから構成されます。

トレース クライアント

App Engine スタンダード環境を使用する場合は、何もする必要はありません。App Engine スタンダード環境は、自動的にトレースを取得して GCP プロジェクトに送信します。

コードをインストゥルメントする場合は、Trace SDK ライブラリをインポートしてからトレースデータを作成し、Stackdriver Trace API を使用してそれを GCP プロジェクトに送信します。OpenCensus ライブラリでは、トレースデータの作成と送信のプロセスが簡素化されます。さらに、トレースデータはバッチ処理されてバックグラウンドで送信されるため、パフォーマンスが向上する可能性があります。

トレース インターフェース

エージェントが収集したトレースデータを、ほぼリアルタイムで Stackdriver Trace インターフェースに表示して分析できます。このインターフェースには、[概要]、[トレースリスト]、[分析レポート] という 3 つのウィンドウがあります。

Stackdriver Trace の使用を開始するには、GCP Console で [概要] ウィンドウを開きます。

Trace の概要を開く

アプリケーションを App Engine スタンダード環境にデプロイしたか、Trace データを受信する GCP プロジェクトへのアクセス権がある場合以外は、Trace コンソールにデータは表示されません。

概要

[概要] ウィンドウには、アプリケーションに関する要約情報が表示されます。

Stackdriver Trace の概要ページ

該当する場合は、[分析情報] ペインに、アプリケーションのパフォーマンス分析情報のリストが表示されます。このペインでは、アプリケーションでの一般的な問題がハイライト表示されます。たとえば、関数の連続呼び出しを一括処理することで効率が高まる可能性があるなどです。

[最近のトレース] ペインには、直近のトレースが表示されます。それぞれについて、レイテンシ、URI、時間が表示されます。この要約を使用して、アプリケーションでの現在のアクティビティを理解できます。

[頻度が高い URI] と [頻度が高いリモート プロシージャ コール] には、前日の最も頻度の高い URI(および RPC)が平均レイテンシとともに表示されます。これらの表でリンクをクリックすると、一致するリクエストを表示するように事前構成された [トレースリスト] ウィンドウが開きます。[トレースリスト] ウィンドウを使用すると、レイテンシを時間の関数として表示し、個々のトレースの詳細を調べることができます。

[課金対象のトレーススパン] ペインには、現在のカレンダー月に取り込まれたスパンの数と前月の合計が表示されます。この情報を使用して、Stackdriver Trace を使用するための費用をモニタリングできます。費用の詳細については、料金をご覧ください。

[日次分析レポート] ペインには、前日のレイテンシ データが表示され、7 日前のレイテンシ データと比較されます。このデータを使用して、レイテンシの動作が時間とともに変化しているかどうかを確認できます。このページのレポートの形式は変更できません。ただし、カスタム分析レポートを作成できます。

Stackdriver Trace の [概要] ウィンドウの詳細については、GCP Console でのトレースの表示をご覧ください。

トレースリスト

[トレースリスト] ウィンドウでは、個々のトレースを詳細に調べることができます。デフォルトでは、このビューには、すべてのトレースのレイテンシのプロットが表示され、最新のトレースが表に示されます。

調べる特定のトレースを選択すると、2 つの新しいペインが開きます。トレース内のすべてのスパンを表示する [タイムライン] ペインと、選択したスパンに関する詳細を表示する情報ペインです。デフォルトでは、ルートスパンが選択されており、詳細にはリクエストに関する要約情報が含まれています。調査のためにトレースを見つけるには、フィルタを使用します。

トレース詳細のフィルタおよび表示について詳しくは、トレースリストの使用およびトレース詳細の表示をご覧ください。

分析レポート

[分析レポート] ウィンドウでは、カスタム レポートを作成できます。これらのレポートには、すべてのトレースを含めるか、フィルタを指定してトレースのサブセットのみを含めることができます。また、2 つの異なるレイテンシ データを比較するレポートを作成することもできます。詳細については、分析レポートの作成をご覧ください。

料金

レイテンシ データは、スパンで構成されるトレースにまとめられます。スパンは Stackdriver Trace バックエンドによって取り込まれ、その後、データは GCP Console でリアルタイムで表示およびレポートできるようになります。トレースデータを表示すると、保存されたスパンが取得プロセスの一部としてスキャンされます。

Stackdriver Trace の月額料金は、取り込まれたトレーススパン数とスキャンされたトレーススパン数によって決まります。詳細については、Trace の料金をご覧ください。

取り込まれたスパン数が事前定義のしきい値を超えた場合に通知するアラートを作成できます。詳細については、アラート ポリシーの作成をご覧ください。

割り当て

Stackdriver Trace では、API リクエストに対するレート割り当てと、Trace に送信したスパンに対する取り込み割り当てが適用されます。詳細については、割り当てと制限をご覧ください。

現在の使用状況を確認するには:

  1. Stackdriver Trace API の概要ページから、Trace の [概要] ウィンドウに移動します。

    Trace API の概要に移動

  2. [割り当て] をクリックします。

割り当てを超えた場合に通知するアラートを作成できます。詳細については、アラート ポリシーの作成をご覧ください。

次のステップ

Stackdriver Trace コンソールの詳細については、GCP Console でのトレースの表示をご覧ください。

Stackdriver Trace の使用を開始するには:

このページは役立ちましたか?評価をお願いいたします。

フィードバックを送信...

ご不明な点がありましたら、Google のサポートページをご覧ください。