• ログイン今すぐ開始

本書は、お客様のご参考のために原文の英語版を機械翻訳したものです。

英語版と齟齬がある場合、英語版の定めが優先するものとします。より詳しい情報については、本リンクをご参照ください。

問題を作成する

Goアプリケーションの分散型トレースを実現

分散トレースを使用すると、分散システム全体でのリクエストの全過程を確認できます。Goエージェントには、2種類の分散トレースを提供しています(詳細については、 スパンサンプリングの仕組みを参照してください)。

  • 標準(ヘッドベースのサンプリング):トレースが到着する前に、受け入れて分析するトレースの設定パーセンテージを決定します。これにより、トレースがどのように役立つかを確認するための確実な出発点が得られます。Goエージェント3.16.0以降ではデフォルトでオンになっています。
  • 無限トレース(テールベースのサンプリング):当社のクラウドベースのサービスは、すべてのトレースを受け入れ、それらをソートして最も重要なものを見つけます。標準トレースを設定した後、このオプションを追加することをお勧めします。これは、すべてのトレースを分析し、最も重要なトレースをサンプリングするための構成オプションを提供するためです。

分散トレースを開始するために必要なすべての手順は、次のとおりです。

新しいGoエージェント

標準の分散トレース(ヘッドベースのサンプリング)を試すだけの場合でも、無限トレース(テールベースのサンプリング)を設定する場合でも、標準のトレースを設定することから始める必要があります。ヘッドベースのサンプリングを実行するために、APMエージェントのインストールについて説明します。その後、Infinite Tracingを設定できます。これはオプションですが、推奨されます。

ヒント

Goエージェントでは、他のNew Relicエージェントの自動インストルメンテーションとは異なり、Goサービスを手動でインストルメントする必要があります。つまり、Goエージェントを使用して分散トレースを有効にするには、コードにいくつかの行を追加する必要があります。

エージェントをインストールして、標準の分散トレースを取得します

これは、サービスにAPMエージェントをまだインストールしていない場合、または追加のサービスをインストルメント化する場合に、標準の分散トレースを設定するための最良のアプローチです。

このAPMエージェントでインストルメント化されたサービスがすでにいくつかあり、それらを分散トレースに含めたい場合は、各サービスの分散トレースを手動で有効にする必要があります。古いGoエージェントのオプションを参照してください。

ヒント

分散トレースを設定するには、NewRelicアカウントが必要です。まだお持ちでない場合は、無料のアカウントをすばやく作成できます

ステップ1.サービスを特定する

どのサービスがリクエストに対応しているかを把握し、各サービスをインストルメント化してトレースデータをNewRelicに送信できるようにします。

ステップ2.各サービスをAPMエージェントでインストルメント化する

トランザクションに関係するサービスごとに、エージェントのインストールルーチンを繰り返します。一部のサービスが他の言語を使用している場合は、それらの言語のインストール手順を繰り返すだけです。

インストールルーチンを開始するには、下のタイルをクリックします。各エージェントのインストールが完了したら、ここに戻ってトレースを表示するためのヒントを確認してください。

Golang
Start installation

ステップ3.トレースを表示する

各サービスをAPMエージェントでインストルメント化した後、アプリケーションでトラフィックを生成して、トレースをキャプチャできるようにします。UIでトレースを表示する方法は次のとおりです。

UIでトレースを見つけるための詳細については、以下を参照してください。

無限トレースの設定(推奨)

APMエージェントの標準分散トレース(上記)は、トレースの最大10%をキャプチャしますが、すべてのデータを分析して最も関連性の高いトレースを見つけたい場合は、無限トレースを設定できます。

ヒント

この機能の詳細については、「 無限トレース」を参照してください。

開始する前に、まず要件を満たしていることを確認してください。

手順1.新しいエージェントのインストールを完了します

Infinite Tracingセットアップは、標準の分散トレース用の新しいエージェントインストールからのインストルメンテーションステップに基づいています。

ステップ2.トレースオブザーバーを設定します

トレースオブザーバーは、すべてのトレースを収集して分析するNewRelicAWSベースのサービスです。トレースオブザーバーの設定の手順に従います。完了したら、トレースオブザーバー情報をここに戻し、次の手順に進んでエージェントを構成します。

手順3:エージェントを無限トレース用に構成する

無限トレース構成設定には、標準の分散トレースに加えて、トレースオブザーバーに関する情報が含まれます。

ステップ4.(オプション)無限トレースをカスタマイズする

エージェント構成設定を追加すると、NewRelicUIにデータが表示されるようになります。データの分析に時間を費やした後、無限トレースの機能のいくつかを調整することをお勧めします。

古いGoエージェントのオプション

古いGoエージェントがある場合は、このセクションを使用して、必要な分散トレース機能がサポートされているかどうかを確認してください。

互換性情報に続いて、標準の分散トレースをオンにするための基本的な構成設定を示すセクションがあります。古いエージェントがInfiniteTracingをサポートしていて、それを設定する場合は、上記の手順を参照してください。

互換性ガイド

以下の互換性情報を確認した後、構成設定に従います。

古いGoエージェントを構成します

分散トレースを有効にするには、以下の設定を参照してください。

ヒント

分散トレースを使用せずに古いエージェントを使用している場合は、分散トレースをオンにする前に、APMへの影響を確認してください。

追加の手動計装

Goエージェントと分散トレースのすべてのインストールには、 Goエージェント構成設定にリストされている設定を使用した手動のインストルメンテーションが必要です。それでも、セットアップを選択するには、追加の構成が必要になる場合があります。トランザクションとHTTPリクエストをインストルメント化するためのガイドラインを次に示します。

これらの使用方法の詳細については、 Go agent GitHub repo を参照してください。

Copyright © 2022 New Relic株式会社。

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.