Buildkite パイプラインでトレースを設定する

Docs > Continuous Integration Visibility > Datadog におけるパイプラインの可視化 > Buildkite パイプラインでトレースを設定する

互換性

Partial pipelines: 部分リトライとダウンストリームパイプラインの実行を表示します
Manual steps: 手動でトリガーされたパイプラインを表示します
Queue time: パイプラインのジョブが処理される前にキューに残っている時間を表示します
Custom tags and metrics at runtime: ランタイムにカスタムタグとメトリクスを構成します

Datadog インテグレーションの構成

Buildkite の Datadog インテグレーションを有効にする手順は以下の通りです。

Buildkite の Settings > Notification Services に移動し、add a Datadog Pipeline Visibility integration をクリックします。
以下の情報をフォームに入力してください。
- Description: Datadog CI Visibility インテグレーションのように、将来的にインテグレーションを識別するのに役立つ説明です。
- API key: Datadog API キーです。
- Datadog site:
- Pipelines: トレースするすべてのパイプラインまたはパイプラインのサブセットを選択します。
- Branch filtering: すべてのブランチをトレースする場合は空のままにします。または、トレースしたいブランチのサブセットを選択します。
Add Datadog Pipeline Visibility Notification をクリックして、インテグレーションを保存します。

カスタムタグの設定

カスタムタグは buildkite-agent meta-data set コマンドを使用して Buildkite トレースに追加することができます。 dd_tags. で始まるキーを持つメタデータタグはすべて、ジョブとパイプラインのスパンに追加されます。これらのタグを使用して、パイプラインを検索および整理するための文字列ファセットを作成することができます。

以下の YAML は、チーム名と Go バージョンのタグが設定されたシンプルなパイプラインを表しています。

steps:
  - command: buildkite-agent meta-data set "dd_tags.team" "backend"
  - command: go version | buildkite-agent meta-data set "dd_tags.go.version"
    label: Go version
  - commands: go test ./...
    label: Run tests

Datadog では、ルートスパンだけでなく、関連するジョブスパンにも以下のタグが表示されます。

team: backend
go.version: go version go1.17 darwin/amd64 (出力はランナーに依存します)

その結果、パイプラインは次のようになります。

キーが dd-metrics. で始まり、数値を含むメタデータは、数値メジャーの作成に利用できるメトリクスタグとして設定されます。このようなタグを作成するには、buildkite-agent meta-data set コマンドを使用します。これは、例えばパイプラインのバイナリーサイズを計測するのに使うことができます。

steps:
  - commands:
    - go build -o dst/binary .
    - ls -l dst/binary | awk '{print \$5}' | tr -d '\n' | buildkite-agent meta-data set "dd_metrics.binary_size"
    label: Go build