Datadog ソースコードインテグレーション

コンテナでアプリを実行している場合、Datadog はイメージの Docker ラベルから直接ソースコード情報を抽出することができます。ビルド時に、オープンコンテナスタンダード に従って、git commit SHA とリポジトリ URL を Docker ラベルとして追加します。

docker build . \
  -t my-application \
  --label org.opencontainers.image.revision=$(git rev-parse HEAD) \
  --label org.opencontainers.image.source=git-provider.example/me/my-repo

Kubernetes を使用している場合は、Datadog のタグオートディスカバリー を使用してデプロイされたポッドにポッドアノテーションを付けます。

ad.datadoghq.com/tags: '{"git.commit.sha": "<FULL_GIT_COMMIT_SHA>", "git.repository_url": "git-provider.example/me/my-repo"}'

git.commit.sha と git.repository_url はテレメトリーでタグ付けされています。

Datadog は、Serverless Monitoring for AWS Lambda 設定 に従って、サーバーレスアプリケーションからソースコード情報を直接抽出することができます。

トレース、スパン、プロファイルに git.commit.sha と git.repository_url というタグを付けるには、環境変数 DD_TAGS でトレーサーを構成します。

export DD_TAGS="git.commit.sha:<FULL_GIT_COMMIT_SHA>,git.repository_url:git-provider.example/me/my-repo"
./my-application start

Go はバージョン 1.18 からバイナリにバージョン管理情報を埋め込む ようになりました。

サービスが以下の要件をすべて満たしていることを確認します。

• Go >= 1.18 のバージョンを使用している。
• Datadog Go Tracer >= 1.48.0 のバージョンを使用している。
• アプリケーションは go.mod を使ってモジュールとしてビルドされました。モジュールパスはコードリポジトリの URL です。

GitHub SaaS ユーザーの場合、テレメトリーをソースコードにリンクさせるために、Datadog の GitHub インテグレーション を GitHub インテグレーションタイル にインストールします。インテグレーションタイルで権限を指定する際、Contents に対して Datadog の読み取り権限を有効にしてください。

GitHub とのインテグレーションを設定することで、エラー追跡にインラインコードスニペットを表示することができます。詳しくは、インラインソースコード をご覧ください。

テレメトリーをソースコードにリンクさせるために、Datadog は datadog-ci git-metadata upload コマンドで Git リポジトリから全てのコミット SHA についてメタデータを収集します。

Git リポジトリ内で datadog-ci git-metadata upload を実行すると、Datadog はリポジトリの URL、現在のブランチのコミット SHA、そして追跡したファイルのパスのリストを受け取ります。

検証

データが収集されていることを確認するために、CI パイプラインで datadog-ci git-metadata upload を実行します。

以下のような出力が期待できます。

Reporting commit 007f7f466e035b052415134600ea899693e7bb34 from repository git@github.com:my-org/my-repository.git.
180 tracked file paths will be reported.
✅  Handled in 0.077 seconds.

トレースは GitHub のソースリポジトリのエラー追跡 で直接アクセスできます。

1. APM > Error Tracking の順に移動します。
2. 課題をクリックします。右側に Issue Details パネルが表示されます。
3. Latest Event の下で、フレームの右側にある View ボタンをクリックするか、View file、View Git blame、View commit を選択すると、ソースコード管理ツールにリダイレクトされます。

トレースは、Continuous Profiler で GitHub 上のソースリポジトリに直接アクセスすることができます。

1. APM > Profile Search の順に移動します。
2. プロファイルをクリックし、フレームグラフのメソッドにカーソルを合わせます。右側に More actions というラベルの付いたケバブアイコンが表示されます。
3. More actions* > View in repo をクリックし、トレースをソースコードリポジトリで開きます。