分散トレースを使用すると、分散システム 全体でのリクエストの全過程を確認できます。Rubyエージェントの場合、2種類の分散トレースを提供します(詳細については、 スパンサンプリングのしくみ を参照してください)。
標準(ヘッドベースのサンプリング):トレースが到着する前に、受け入れて分析するトレースの設定パーセンテージを決定します。これにより、トレースがどのように役立つかを確認するための確実な出発点が得られます。Rubyエージェント8.0.0以降ではデフォルトでオンになっています。
Infinite Tracing (tailベースサンプリング): 当社のクラウドベースのサービスは、すべてのトレースを受け入れ、それらを並べ替えて最も重要なものを見つけます。 Infinite tracing はすべてのトレースを分析し、最も重要なトレースをサンプリングするための設定オプションを提供します。
標準のディストリビューティッド(分散)トレーシング (ヘッドベースサンプリング) を試したい場合でも、無限トレーシング (テールベースサンプリング) もセットアップしたい場合でも、まず標準トレーシングをセットアップする必要があります。
標準の分散トレース サービスに エージェントをまだインストールしていない場合、これが標準のディストリビューティッド(分散)トレーシング を設定するための最良の方法です。 APM
ヒント New Relic Rubyエージェントをインストールすると、標準のディストリビューティッド(分散)トレーシングがデフォルトでオンになります。 オフにしたい場合は、設定ガイド をご覧ください。
サービスを特定する 各トレースデータをNew Relicに送信できるように、どのサービスをインストゥルメントするかを把握します。
APMエージェントを使用して各サービスを計量する あなたの場面に関係するサービスごとに、エージェントの個別の説明を実行します。 一部のサービスで他の言語を使用する場合は、その言語のインストール手順 を繰り返すだけです。
インストール ルーチンを開始するには、下のタイルをクリックします。各エージェントのインストールが完了したら、ここに戻って トレースを表示する ためのヒントを参照してください。
トレースを表示 各サービスをAPMエージェントでインストルメント化した後、アプリケーションでトラフィックを生成して、トレースをキャプチャできるようにします。UIでトレースを表示する2つの方法は次のとおりです。
特定のサービスを含むトレースを表示する 特定のサービスのトレースを確認する1つの方法は次のとおりです。
one.newrelic.com > APM & services に移動します。エンティティ(サービス)をクリックします。 左側のペインのMonitor セクションで、 Distributed tracing をクリックします。 詳細については、個々のトレースをクリックしてください。 上部のメニューでGroup similar traces がオンになっている場合は、トレース グループをクリックしてから、個々のトレースをクリックします。 必要なトレースが表示されない場合は、 trace.id
でフィルタリングできます。 アカウント全体のトレースを表示する アカウントをまたがるトレースを表示するには:
one.newrelic.com > All capabilities > Traces に移動します。左側のペインでエンティティ(サービス)を選択します。 詳細については、個々のトレースをクリックしてください。 上部のメニューでGroup similar traces がオンになっている場合は、トレース グループをクリックしてから、個々のトレースをクリックします。 必要なトレースが表示されない場合は、 trace.id
でフィルタリングできます。 トレースに関連するログを調べる ログとトレースの詳細をまとめて、トラブルシューティングをより簡単かつ迅速に行うことができます。ログをコンテキスト に含めると、NewRelicUIのトレースと一緒にログメッセージを表示できます。
特定のサービスを含むトレースの 表示またはアカウント全体のトレース の表示の手順を使用して興味深いトレースを見つけたら、次の手順を実行します。
コンテキスト内でログを有効にしている場合は、 Logs タブ ( Trace details の横) をクリックします。 個々のログに関連する詳細を表示するには、メッセージを直接クリックします。 UIでトレースを見つけるための詳細については、以下を参照してください。
無限のトレース エージェント用の 標準のディストリビューティッド(分散)トレーシングは トレースの最大 APM10% をキャプチャしますが、すべてのデータを分析して最も関連性の高いトレースを見つけたい場合は、 無限トレーシング を設定できます。
始める前に、まず要件を 満たしていることを確認してください。
標準ディストリビューティッド(分散)トレーシングのセットアップを完了する Infinite Tracing セットアップは、標準のディストリビューティッド(分散)トレーシングに基づいて構築されています。 したがって、上記の手順 を完了したことを確認してから、トレース オブザーバーのセットアップを続行してください。
トレース オブザーバーをセットアップする トレースオブザーバーは、すべてのトレースを収集して分析するNewRelicAWSベースのサービスです。トレースオブザーバーの設定 の手順に従います。完了したら、トレースオブザーバー情報をここに戻し、次の手順に進んでエージェントを構成します。
無限トレース構成設定には、標準の分散トレースに加えて、トレースオブザーバーに関する情報が含まれます。サーバー側の構成は、無限トレースでは使用できないことに注意してください。
RubyInfiniteTracing構成 設定の概要は次のとおりです。構成の詳細については、 Rubyエージェントの構成 を参照してください。
Infinite Tracingを設定するには、InfiniteTracinggemをインストールする必要があります。このgemはrubygems.org で入手できます。Bundlerを使用するアプリケーションの場合、GemfileにInfiniteTracinggemを追加で含めます。
gem 'newrelic-infinite_tracing'
Ruby on Railsバージョン3以降を使用している場合、Railsは自動的にBundler.require
を呼び出し、アプリケーションの起動時にnewrelic-infinite_tracing
が必要になります。Sinatraまたは別のフレームワークを使用している場合は、 require 'newrelic/infinite_tracing'
を呼び出すか、手動でBundler.require
を呼び出す必要があります。
タイプ
必要な構成
無限のトレース
構成オプション:
構成ファイル( newrelic.yml
):
環境変数:
ヒント プロキシ設定についてサポートが必要な場合は、 プロキシサポート を参照してください。
(オプション) 無限トレースをカスタマイズする エージェント構成設定を追加すると、NewRelicUIにデータが表示されるようになります。データの分析に時間を費やした後、無限トレースの機能のいくつかを調整することをお勧めします。
手動計装(自動計装が機能しない場合) 推奨事項: カスタムインストゥルメンテーションを実行する前に、以下をお読みください。
サービスがトレースヘッダーを他のサービスに渡していない場合は、分散トレースペイロードAPIを使用して、呼び出し元のサービス と呼び出され たサービスをインストルメント化できます。呼び出し元のサービスは、API呼び出しを使用してペイロードを生成します。このペイロードは、呼び出されたサービスによって受け入れられます。
通話サービスを計測する 通話サービスをインストルメント化するには:
発呼側サービスをモニターするAPMエージェントのバージョンが 分散トレースをサポートしていることを確認してください。
ディストリビューティッド(分散)トレーシングペイロードを生成するためのエージェントAPI呼び出しを呼び出します( RubyエージェントAPI を参照)。
重要 トレース内のスパンの適切な順序を維持するには、 generate the payload in the context of the span that sends it 必ず実行してください。
そのペイロードを宛先サービスに対して行われた呼び出しに追加します(たとえば、ヘッダーで)。
(オプション)呼び出しを外部呼び出しとして識別します( RubyエージェントAPI を参照)。
呼び出されたサービスを計測する 呼び出されたサービスをインストルメント化するには:
呼び出されたサービスを監視するAPMエージェントのバージョンが 分散トレースをサポートしていることを確認します。 呼び出されたサービスのNewRelicエージェントがNewRelicトランザクションを識別しない場合は、エージェントAPIを使用してトランザクションを宣言します。RackベースのWebフレームワークを使用していて、New RelicのRackインストルメンテーションを有効にしている場合、Rubyエージェントがトランザクションの開始を処理します。その他の使用例については、 add_transaction_tracer
APIメソッド を参照してください。 受信した呼び出しからペイロードを抽出します(たとえば、ヘッダーで)。 ペイロードを受け入れるための呼び出しを呼び出します( RubyエージェントAPI を参照してください)。