Go アプリケーションのトレース

互換性要件

Go トレーサーには、Go 1.16+ および Datadog Agent >= 5.21.1 が必要です。サポートするライブラリの一覧については、互換性要件ページをご覧ください。

インストールと利用開始

コンフィギュレーションおよび API の使用の詳細については、Datadog の API ドキュメントを参照してください。

APM で使用される用語の説明については、「APM を開始する」セクションを参照してください。寄稿の詳細については、公式リポジトリ README.md を確認してください。

古いバージョンのトレーサー（例: v<0.6.x）から最新バージョンに移行する必要がある場合は、移行ドキュメントを使用してください。

トレースを設定すると、Continuous Profiler も設定され、アプリからプロファイリングデータの受信を開始するために必要なのはプロファイラーを有効にすることだけです。

インストール

アプリ内のドキュメントに従ってください (推奨)

Datadog 内のクイックスタート手順に従って、最高のエクスペリエンスを実現します。例:

デプロイコンフィギュレーション (ホスト、Docker、Kubernetes、または Amazon ECS) を範囲とする段階的な手順。
service、env、version タグを動的に設定します。
セットアップ中に Continuous Profiler、トレースの 100% 取り込み、およびトレース ID のログへの挿入を有効にします。

それ以外の場合は、以下の指示に従って、Datadog トレーシングライブラリをコードに追加します。

自動インスツルメンテーション

Datadog には、一連のライブラリとフレームワークをインスツルメントするためにすぐに使用できるサポートを提供する一連の接続可能パッケージがあります。このパッケージのリストは、互換性要件ページにあります。このインテグレーションをトレースするには、アプリケーションにパッケージをインポートし、各インテグレーションと併せて掲載されているコンフィギュレーション手順に従ってください。

コンフィギュレーション

Datadog では、DD_ENV、DD_SERVICE、DD_VERSION を使用して、サービスの env、service、version を設定することを推奨します。

これらの環境変数の構成方法に関する推奨事項は、統合サービスタグ付けのドキュメントをお読みください。これらの変数は、Go トレーサーのバージョン 1.24.0 以降で利用可能です。

トレーサーの API を通じて、env、service、version を指定することもできます。

package main

import (
    "gopkg.in/DataDog/dd-trace-go.v1/ddtrace/tracer"
)

func main() {
    tracer.Start(
        tracer.WithEnv("prod"),
        tracer.WithService("test-go"),
        tracer.WithServiceVersion("abc123"),
    )

    // トレーサーが停止すると、終了する前にトレーサー内のすべてのデータが Datadog Agent にフラッシュされます。
    // この行は主要な関数内に残すようにしてください。
    defer tracer.Stop()
}

Go トレーサーは、コンフィギュレーション用の追加の環境変数と関数をサポートしています。コンフィギュレーションドキュメントで利用可能なすべてのオプションを参照してください。

DD_VERSION: アプリケーションのバージョン (例: 1.2.3、6c44da20、 2020.02.13) を設定します。
DD_SERVICE: このアプリケーションで使用されるサービス名。
DD_ENV: アプリケーションの環境を設定します。例: prod、pre-prod、staging
DD_AGENT_HOST: デフォルト: localhost
トレース送信のためのデフォルトのトレース Agent ホストアドレスをオーバーライドします。
DD_DOGSTATSD_PORT: デフォルト: 8125
DogStatsD メトリクス送信のためのデフォルトのトレース Agent ポートをオーバーライドします。
DD_TRACE_SAMPLE_RATE: インジェストレートコントロールを有効にします。
DD_TRACE_RATE_LIMIT: 1 秒あたり、Go プロセスごとにサンプリングするスパンの最大数。DD_TRACE_SAMPLE_RATE が設定されている場合、デフォルトは 100 です。それ以外の場合は、Datadog Agent にレート制限を委ねます。
DD_TAGS: デフォルト: []
すべてのスパンとプロファイルに追加されるデフォルトタグのリスト。タグはカンマやスペースで区切ることができます。例えば、 layer:api,team:intake や layer:api team:intake などです。
DD_TRACE_STARTUP_LOGS: デフォルト: true
スタートアップコンフィグレーションと診断ログを有効にします。
DD_TRACE_DEBUG: デフォルト: false
トレーサーでデバッグロギングを有効化します。
DD_TRACE_ENABLED: デフォルト: true
Web フレームワークとライブラリインスツルメンテーションを有効にします。false の場合、アプリケーションコードはトレースを生成しません。
DD_SERVICE_MAPPING: デフォルト: null
構成により、サービス名を動的に変更することができます。サービス名はカンマやスペースで区切ることができ、例えば mysql:mysql-service-name,postgres:postgres-service-name、mysql:mysql-service-name postgres:postgres-service-name のようにすることができます。

APM に Datadog Agent を構成する

インスツルメントされたアプリケーションからトレースを受信するように Datadog Agent をインストールして構成します。デフォルトでは、Datadog Agent は apm_config 下にある datadog.yaml ファイルの enabled: true で有効になっており、localhost:8126 でトレーストラフィックをリッスンします。コンテナ化環境の場合、以下のリンクに従って、Datadog Agent 内でトレース収集を有効にします。

メイン datadog.yaml コンフィギュレーションファイルの apm_config セクションで apm_non_local_traffic: true を設定します。
コンテナ化された環境でトレースを受信するように Agent を構成する方法については、それぞれの説明を参照してください。

アプリケーションがインスツルメントされた後、トレースクライアントはデフォルトで Unix ドメインソケット /var/run/datadog/apm.socket にトレースを送信しようとします。ソケットが存在しない場合、トレースは http://localhost:8126 に送信されます。
同様のルールが Go トレーサーから送られる全てのメトリクス (ランタイムメトリクスや内部テレメトリを含む) に適用されます。クライアントは Dogstatsd データを Unix ドメインソケット /var/run/datadog/dsd.socket に送信しようとし、それが存在しない場合は http://localhost:8125 をデフォルトとします。
異なるホストやポートが必要な場合は、以下の環境変数を 1 つ以上使用します。この例ではデフォルト値を示していますが、他の値に設定することもできます。
```
DD_AGENT_HOST=localhost   # The host to send traces and metrics to. Defaults to localhost.
DD_TRACE_AGENT_PORT=8126  # The port to send traces to. Defaults to 8126.
DD_DOGSTATSD_PORT=8125    # The port to send Dogstatsd metrics to. Defaults to 8125.
```
トレース用の接続は、コードで構成することも可能です。
```
package main

import "gopkg.in/DataDog/dd-trace-go.v1/ddtrace/tracer"

func main() {
    tracer.Start(
        // Unix Domain Socket configuration:
        tracer.WithUDS("/var/run/datadog/apm.socket"),
        // or, for a non-default TCP connection:
        // tracer.WithAgentAddr("localhost:8126"),
        // or, for an alternative UDP connection for Dogstatsd:
        // tracer.WithDogstatsdAddress("localhost:8125"),
    )
    defer tracer.Stop()

    // ...
}
```