Buildkite 파이프라인에 \u0008트레이스 설정

문서 > 지속적 통합 가시성 > Datadog의 Pipeline Visibility > Buildkite 파이프라인에 \u0008트레이스 설정

호환성

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 integration).
- 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 (출력은 러너에 따라 다름)

그 결과, 파이프라인은 다음과 같습니다.

Buildkite pipeline trace with custom tags

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