커스텀 태그 및 메트릭 명령은 CI Visibility 파이프라인 트레이스에 사용자 정의 텍스트 및 숫자 태그를 추가하는 방법을 제공합니다. 이러한 태그를 사용해 패싯 (문자열 값 태그) 또는 측정값 (숫자 값 태그)을 만들 수 있습니다. 또한, 패싯 및 측정값은 파이프라인을 검색, 그래프화 또는 모니터링하는 데 사용할 수 있습니다.
커스텀 태그 및 메트릭은 다음 CI 제공자와 함께 작동합니다:
npm을 사용하여 datadog-ci(>=1.15.0) CLI를 전체적으로 설치합니다:
npm install -g @datadog/datadog-ci또는 npm을 사용하지 않으려면 베타 버전의 스탠드얼론 바이너리를 사용하세요.
Linux에서 스탠드얼론 바이너리를 설치하려면 다음을 실행합니다:
curl -L --fail "https://github.com/DataDog/datadog-ci/releases/latest/download/datadog-ci_linux-x64" --output "/usr/local/bin/datadog-ci" && chmod +x /usr/local/bin/datadog-ciMacOS에 스탠드얼론 바이너리를 설치하려면 다음을 실행합니다:
curl -L --fail "https://github.com/DataDog/datadog-ci/releases/latest/download/datadog-ci_darwin-x64" --output "/usr/local/bin/datadog-ci" && chmod +x /usr/local/bin/datadog-ciWindows에 스탠드얼론 바이너리를 설치하려면 다음을 실행합니다:
Invoke-WebRequest -Uri "https://github.com/DataDog/datadog-ci/releases/latest/download/datadog-ci_win-x64.exe" -OutFile "datadog-ci.exe"태그는 파이프라인 스팬 또는 작업 스팬에 추가할 수 있습니다. 이 작업을 수행하려면 다음을 실행합니다:
datadog-ci tag [--level <pipeline|job>] [--tags <tags>]환경 변수 DATADOG_API_KEY를 사용하여 유효한 Datadog API 키를 지정해야 합니다.
환경 변수 DATADOG_SITE를 사용하여 Datadog 사이트를 지정해야 합니다.
다음 예시에서는 파이프라인 스팬에 team 태그를 추가합니다:
datadog-ci tag --level pipeline --tags team:backend다음 예시에서는 현재 작업의 스팬에 go.version 태그를 추가합니다:
datadog-ci tag --level job --tags "go.version:`go version`"태그에서 패싯을 만들려면 파이프라인 실행 페이지의 태그 이름 옆에 있는 기어 아이콘을 클릭하고 create facet 옵션을 클릭합니다.
파이프라인 스팬 또는 작업 스팬에 숫자 태그를 추가하려면 다음을 실행합니다:
datadog-ci metric [--level <pipeline|job>] [--metrics <metrics>]환경 변수 DATADOG_API_KEY를 사용하여 유효한 Datadog API 키를 지정해야 합니다.
환경 변수 DATADOG_SITE를 사용하여 Datadog 사이트를 지정해야 합니다.
다음 예시에서는 파이프라인 스팬에 error_rate 메트릭을 추가합니다:
datadog-ci metric --level pipeline --metrics "error_rate:0.56"다음 예시에서는 현재 실행 중인 작업의 스팬에 binary.size 메트릭을 추가합니다:
datadog-ci metric --level job --metric "binary.size:`ls -l dst/binary | awk '{print \$5}' | tr -d '\n'`"측정값을 생성하려면 파이프라인 실행 페이지의 메트릭 이름 옆에 있는 기어 아이콘을 클릭하고, create measure 옵션을 클릭합니다.
Additional helpful documentation, links, and articles:
