- 필수 기능
- 시작하기
- Glossary
- 표준 속성
- Guides
- Agent
- 통합
- 개방형텔레메트리
- 개발자
- Administrator's Guide
- API
- Datadog Mobile App
- CoScreen
- Cloudcraft
- 앱 내
- 서비스 관리
- 인프라스트럭처
- 애플리케이션 성능
- APM
- Continuous Profiler
- 스팬 시각화
- 데이터 스트림 모니터링
- 데이터 작업 모니터링
- 디지털 경험
- 소프트웨어 제공
- 보안
- AI Observability
- 로그 관리
- 관리
커스텀 태그 및 측정 명령을 사용하여 CI Pipeline Visibility의 파이프라인 트레이스에 사용자 정의 텍스트 및 숫자 태그를 추가합니다. datadog-ci
NPM 패키지를 사용하여 파이프라인 트레이스 또는 작업 스팬에 측정값을 추가하는 것 외에도 커스텀 태그를 추가할 수 있습니다. 이러한 커스텀 태그 및 측정값에서 패싯(문자열 값 태그) 또는 측정값(숫자 값 태그)을 생성할 수 있습니다.
패싯과 측정값을 사용하여 CI Visibility Explorer에서 파이프라인에 대한 필터링, 시각화 생성 또는 모니터 생성을 수행할 수 있습니다.
커스텀 태그 및 측정값은 다음 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-ci
MacOS에 독립형 바이너리를 설치하려면 다음을 실행하세요.
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-ci
Windows에 독립형 바이너리를 설치하려면 다음을 실행하세요.
Invoke-WebRequest -Uri "https://github.com/DataDog/datadog-ci/releases/latest/download/datadog-ci_win-x64.exe" -OutFile "datadog-ci.exe"
파이프라인 스팬 또는 작업 스팬에 태그를 추가할 수 있습니다.
이를 위해 tag
명령을 실행합니다.
DATADOG_SITE= datadog-ci tag [--level <pipeline|job>] [--tags <tag1>] [--tags <tag2>] ...
환경 변수 DATADOG_API_KEY
를 사용하여 유효한 Datadog API 키를 지정하고 환경 변수 DATADOG_SITE
를 사용하여 Datadog 사이트를 지정해야 합니다.
다음 예시에서는 파이프라인 스팬에 team
및 service
태그를 추가합니다.
DATADOG_SITE= datadog-ci tag --level pipeline --tags team:backend --tags service:processor
다음 예시에서는 현재 작업의 스팬에 go.version
태그를 추가합니다:
DATADOG_SITE= datadog-ci tag --level job --tags "go.version:`go version`"
태그에서 패싯을 생성하려면 Pipeline Executions 페이지에서 태그 이름 옆에 있는 기어 아이콘을 클릭하고 Create Facet을 클릭합니다.
파이프라인 스팬 또는 작업 스팬에 숫자 태그를 추가하려면 measure
명령을 실행합니다.
DATADOG_SITE= datadog-ci measure [--level <pipeline|job>] [--measures <measure1>] [--measures <measure2>]...
환경 변수 DATADOG_API_KEY
를 사용하여 유효한 Datadog API 키를 지정하고 환경 변수 DATADOG_SITE
를 사용하여 Datadog 사이트를 지정해야 합니다.
다음 예시에서는 파이프라인 스팬에 error_rate
및 size
측정값을 추가합니다.
DATADOG_SITE= datadog-ci measure --level pipeline --measures "error_rate:0.56" --measures "size:2327"
다음 예에서는 현재 실행 중인 작업의 스팬에 측정값 binary.size
를 추가합니다.
DATADOG_SITE= datadog-ci measure --level job --measures "binary.size:`ls -l dst/binary | awk '{print \$5}' | tr -d '\n'`"
측정값을 생성하려면 Pipeline Executions 페이지에서 측정값 이름 옆에 있는 기어 아이콘을 클릭하고 Create Measure을 클릭합니다.
GitHub 작업에 태그 및 측정값을 추가하려면 datadog-ci CLI
버전 2.29.0
이상이 필요합니다.
작업 이름이 워크플로 구성 파일(GitHub 작업 ID)에 정의된 항목과 일치하지 않는 경우 작업 이름을 가리키는 DD_GITHUB_JOB_NAME
환경 변수가 노출되어야 합니다. 예를 들어,
이름 속성을 사용하여 작업 이름을 변경하는 경우:
jobs:
build:
name: My build job name
env:
DD_GITHUB_JOB_NAME: My build job name
steps:
- run: datadog-ci tag ...
매트릭스 전략을 사용하면 작업 이름 끝에 괄호 안에 매트릭스 값을 추가하여 GitHub에서 여러 작업 이름을 생성합니다. 그런 다음 DD_GITHUB_JOB_NAME
환경 변수는 매트릭스 값을 조건으로 해야 합니다.
jobs:
build:
strategy:
matrix:
version: [1, 2]
os: [linux, macos]
env:
DD_GITHUB_JOB_NAME: build (${{ matrix.version }}, ${{ matrix.os }})
steps:
- run: datadog-ci tag ...
추가 유용한 문서, 링크 및 기사: