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

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

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

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

• 新しいGoエージェント：新しいエージェントのインストールのためのヘッドベースおよびテールベースのサンプリングの手順
• 古いGoエージェント：古いGoエージェントがある場合のトレースオプション
• 手動インストルメンテーション：追加のインストルメンテーションのヒント

新しいGoエージェント

標準の分散トレース (ヘッドベースのサンプリング) を試してみたいだけか、無限トレース (テールベースのサンプリング) をセットアップしたいかどうかに関係なく、標準のトレースをセットアップすることから始める必要があります。私たちはあなたを通り抜けます APMヘッドベースのサンプリングを開始するためのエージェントのインストール。 その後、オプションですが推奨される Infinite Tracing を設定できます。

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

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

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

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

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

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

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

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

Start installation

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

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

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

• 分散トレースUIを理解して使用する
• 分散トレースデータのクエリ

無限トレースのセットアップ

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

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

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

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

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

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

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

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

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

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

• トレースオブザーバーの監視を構成する
• スパン属性トレースフィルタを設定する
• ランダムトレースフィルターを構成する

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

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

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

互換性ガイド

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

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

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

追加の手動計装

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

http.HandleFunc("/users", usersHandler)

http.HandleFunc(newrelic.WrapHandleFunc(app, "/users", usersHandler))

func useNewRoundTripper(txn *newrelic.Transaction) (*http.Response, error) {
    client := &http.Client{}
    client.Transport = newrelic.NewRoundTripper(client.Transport)
    request, _ := http.NewRequest("GET", "http://example.com", nil)
    request = newrelic.RequestWithTransactionContext(request, txn)
    return client.Do(request)
}

func external(txn *newrelic.Transaction, req *http.Request) (*http.Response, error) { 
    s := newrelic.StartExternalSegment(txn, req) 
    response, err := http.DefaultClient.Do(req) 
    s.Response = response 
    s.End() 
    return response, err
}

func noGoodForDt(txn *newrelic.Transaction, url string) (*http.Response, error) {
    // Distributed tracing headers are not added to the outgoing request.
    // Use newrelic.NewRoundTripper or newrelicc.StartExternalSegment instead.
    defer newrelic.ExternalSegment{
        StartTime: txn.StartSegmentNow(),
        URL:       url,
    }.End()

    return http.Get(url)
}

InsertDistributedTraceHeaders(h http.Header)

AcceptDistributedTraceHeaders(h http.Header)

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