버전 태그
version 태그는 Unified Service Tagging 내에서 예약되어 있습니다. 이 태그는 인프라 메트릭(호스트, 컨테이너, 프로세스 및 NPM 검사), 트레이스 메트릭, 트레이스, 프로필 및 로그에 적용됩니다.
version 태그를 사용하여 소프트웨어 배포 전략을 지원하는 배포 및 서비스 동작을 모니터링할 수 있습니다.
version 태그를 설정하지 않은 경우 Unified Service Tagging 설명서에서 설정 정보를 참조하세요.
서비스 페이지에서 버전 태그 사용
서비스 페이지에서 version 태그를 사용할 수 있는 경우, 요청 위젯의 범위를 다음으로 지정할 수 있습니다.
오류 위젯의 범위를 다음으로 지정할 수 있습니다.
- 버전별 총 오류 수
- 버전별 초당 오류 수 또는
- 버전별 오류율(%)
요청 및 오류 위젯은 모두 대시보드와 모니터로 내보낼 수 있습니다.
version 태그를 사용하여 서비스를 구성하면 Automatic Faulty Deployment Detection이 활성화됩니다.
모니터를 설정하여 잘못되었을 가능성이 있는 모든 배포에 관해 자동으로 알림을 받을 수 있습니다. 그러려면 새 모니터 페이지로 이동하여 이벤트를 선택하고, 모니터를 정의하는 쿼리에 tags:deployment_analysis를 포함하세요.
배포된 버전
version 태그를 사용하여 구성된 서비스에는 서비스 페이지의 주 서비스 상태 그래프 아래에 버전 섹션이 있습니다. 버전 섹션에는 선택한 기간 동안 활성이었던 모든 서비스 버전이 표시되고, 맨 위에 활성 서비스가 표시됩니다.
기본적으로 다음이 표시됩니다.
일정 기간 동안 이 서비스에 배포된 버전 이름입니다.
이 버전에 해당하는 트레이스가 처음 및 마지막으로 표시된 시간입니다.
바로 이전 버전에는 나타나지 않았지만 각 버전에는 나타나는 오류 유형 수를 보여주는 Error Types 표시기입니다.
참고: 이 표시기에는 이전 버전의 트레이스에는 표시되지 않았던 오류가 표시됩니다. 그렇다고 이 버전에서 이러한 오류가 생겼다는 의미는 아닙니다. 새 오류 유형을 살펴보는 것은 오류 조사를 시작하는 아주 좋은 방법일 수 있습니다.
초당 요청 수.
총 요청에 대한 백분율로 나타낸 오류율.
이 개요 표에서 열을 추가하거나 제거할 수 있으며 선택 사항이 저장됩니다. 추가로 사용 가능한 열은 다음과 같습니다.
- 버전에서 활성 상태이고 이전 버전에는 없었던 엔드포인트입니다.
- 활성 시간, 즉 해당 버전에 대해 Datadog으로 전송된 첫 번째 트레이스부터 마지막 트레이스까지의 시간 길이입니다.
- 총 요청 수입니다.
- 총 오류 수입니다.
- p50, p75, p90, p95, p99 또는 최댓값으로 측정된 지연 시간입니다.
참고: 버전 섹션은 페이지 상단에서 선택한 기간 동안 보고되는 버전이 두 개 이상인 경우에만 나타납니다.
배포 비교
버전 요약 표에서 원하는 버전 행을 클릭하면 버전 비교 페이지가 열려 동일한 서비스의 두 버전을 비교할 수 있습니다. 기본적으로 선택된 버전은 바로 이전 버전과 비교되지만 지난 30일 이내의 어떤 두 버전이든 선택하여 비교할 수 있습니다.
버전 비교 페이지에서 다음 정보를 확인할 수 있습니다.
- 비교 그래프: 서비스에 대한 요청 및 오류를 시각화한 것으로, 다양한 배포 유형을 관찰하는 데 유용합니다.
- 오류 비교: 버전에 따라 발생했거나 해결되었을 수 있는 오류입니다.
- 엔드포인트 비교: 각 버전에서 엔드포인트 지연 시간 및 오류율이 어떻게 나타나는지 파악할 수 있습니다.
비교 그래프
서비스 페이지의 그래프와 마찬가지로, 요청 및 오류 그래프에도 배포 롤아웃의 개요 또는 오류율 급증이 표시됩니다. 이 페이지에서는 그래프에 비교를 위해 선택한 버전이 강조 표시되고, 다른 모든 버전은 회색으로 표시되어 추가적인 컨텍스트를 제공합니다.
Continuous Profiler가 활성화된 경우, CPU 시간이나 할당된 메모리와 같은 주요 성능 메트릭의 비교가 APM 리소스별로 분류되어 표시됩니다. 여기에서 프로필 비교 페이지로 전환할 수 있습니다.
오류 비교
이 섹션에는 두 버전 간에 감지된 오류 유형의 차이를 나열하며 다음 사항을 강조합니다.
- 소스 버전에만 나타나는 오류 유형이며, 문제 해결에 유용함
- 소스 버전에 더 이상 나타나지 않는 오류 유형. 수정 사항을 검증하는 데 유용함
- 둘 다에서 나타나는 오류 유형.
이 표에서 추가 조사를 위해 선택한 오류에 해당하는 실시간 또는 기록 트레이스로 전환할 수 있습니다.
참고: 오류 비교는 관찰된 오류 유형을 기반으로 합니다. 오류 유형이 드물다면 아직 발견되지 않아서 더 이상 나타나지 않는 것으로 표시될 수 있습니다.
엔드포인트 비교
이 섹션에서는 서비스 내 각 엔드포인트의 성능(요청, 지연 시간 및 오류)을 비교할 수 있습니다. 값 기준으로 표를 정렬하면 배포 후에도 처리량이 가장 많은 엔드포인트가 여전히 정상 상태인지 확인할 수 있고, 변경률(%)을 기준으로 정렬하면 지연 시간 또는 오류율 변동 폭이 큰지 알아볼 수 있습니다.
배포 전략
Datadog의 배포 추적을 사용하면, 잘못된 코드 배포를 감지하고 변경의 영향을 억제하며 인시던트에 더 빠르게 대응하기 위해 다음과 같은 배포 전략(또는 그 외)을 사용할 때 배포된 코드의 성능을 파악할 수 있습니다.
롤링 배포
롤링 배포는 호스트 또는 컨테이너에 새 버전을 하나씩 배포하는 동안 트래픽을 다른 인스턴스로 이동시켜 가동 중지 시간을 없앱니다.
Datadog을 사용하면 롤링 배포를 모니터링하고 그에 따른 오류 증가를 감지할 수 있습니다.
블루 및 그린 배포
블루 및 그린 배포는 트래픽을 모두 허용하는 두 개의 서비스 클러스터를 동시에 실행하거나, 하나를 대기 상태로 유지하다가 다른 클러스터에 문제가 생기면 활성화하여 가동 중지 시간을 줄입니다.
이러한 서비스에 대해 version 태그를 설정하고 조회하면 요청 및 오류를 비교하여 클러스터 중 하나의 오류율이 다른 클러스터보다 높은지, 클러스터가 SLO를 충족하지 않는지, 또는 트래픽을 수신해서는 안 되는 클러스터인지 감지할 수 있습니다.
카나리 배포
카나리 배포를 사용하면 제한된 수의 호스트 또는 일부 고객을 대상으로 서비스를 배포하여 제한된 영향력 내에서 새 배포를 테스트할 수 있습니다.
Datadog 내에서 version 태그를 사용하면 카나리 배포에 대한 오류율, 트레이스 및 서비스 동작을 비교할 수 있습니다.
예를 들어 다음 이미지에서는 카나리 버전이 배포되고 몇 가지 오류가 발생하여 제거되었으며 추가 영향 없이 조사에 사용 가능한 해당 버전에 해당하는 트레이스를 볼 수 있습니다.
섀도우 배포
섀도우 배포에서는 릴리스 후보 버전이 프로덕션 버전과 함께 배포되며, 들어오는 트래픽이 두 서비스 모두로 전송됩니다. 사용자는 프로덕션의 결과만 볼 수 있지만 두 서비스 모두에서 데이터를 수집할 수 있습니다.
섀도우 배포를 사용하면 실제 프로덕션 트래픽을 기준으로 잠재적인 릴리스를 테스트할 수 있습니다. 섀도우에 version 태그를 사용해 태그하면 두 버전의 오류율, 트레이스 및 서비스 동작을 비교하여 섀도우 버전을 릴리스해도 되는지 결정할 수 있습니다.
version 태그는 검색 보기를 특정 버전으로 필터링하거나 다른 버전의 메트릭을 비교하는 등 Datadog 내 어디에서나 사용할 수 있습니다.
리소스 페이지
리소스 페이지에서 버전 태그를 사용할 수 있는 경우 요청 위젯의 범위는 다음 중 하나로 지정될 수 있습니다.
오류 위젯의 범위는 version 태그와 관련된 세 가지 옵션 중 하나로 지정될 수 있습니다.
- 버전별 총 오류 수
- 버전별 초당 오류 수
- 버전별 오류율(%)
이들 모두는 대시보드와 모니터로 내보낼 수 있습니다.
트레이스 검색 및 분석
사용 가능한 경우, 실시간 검색 모드 및 인덱싱된 트레이스를 필터링하거나, 분석 쿼리를 필터링 또는 그룹화하기 위해 Trace Search 및 Analytics 모두에 대한 태그로 version을 사용할 수 있습니다.
version 태그 필터링을 포함한 분석을 대시보드 및 모니터로 내보낼 수 있습니다.
버전별 프로필
특정 버전에 해당하는 프로필을 검색할 수 있습니다. 배포 비교 페이지 상단 오른쪽에 있는 프로필 조회를 클릭하여 비교 중인 두 버전으로 범위가 지정된 Continuous Profiler를 열 수도 있습니다.
배포 간 시간 메트릭
서비스의 새 배포가 감지될 때마다 배포 추적이 time_between_deployments 메트릭에 대한 값을 계산합니다. 새 배포와 그 이전의 최신 버전 배포 사이의 기간(초)으로 계산됩니다.
메트릭 정의
datadog.service.time_between_deployments{env, service, second_primary_tag}- 전제 조건: 이 메트릭은 Unified Service Tagging을 통해 버전 태깅이 활성화된 모든 APM 서비스에 대해 존재합니다.
설명: 서비스의 배포와 그 이전의 최신 버전 배포 사이에 경과한 시간(초)입니다.
메트릭 유형: 분포
태그: 메트릭이 서비스의 env, service 및 두 번째 기본 태그로 태그됩니다.
예시
time = 0에 버전 A를, time = 10에 버전 B를 배포하는 서비스가 있는 경우 메트릭 datadog.service.time_between_deployments의 값은 10이 됨:
- Time = 0
{service: foo, env: prod, cluster-name: dev-shopist, version: A}- Time = 10
{service: foo, env: prod, cluster_name: dev-shopist, version: B}- 배포 간 시간
datadog.service.time_between_deployments{env: prod, cluster_name: dev-shopist} = 10
time = 20에 버전 X를 클러스터 dev-shopist에서, time = 30에 버전 Y를 클러스터 us-staging에서, time = 45에 다시 버전 Y를 클러스터 dev-shopist에서 배포하는 경우 모든 클러스터의 메트릭 datadog.service.time_between_deployments max 값은 25가 됨(최신 Y 시간에서 마지막 X를 뺀 값):
- Time = 20
{service: foo, env: staging, cluster-name: dev-shopist, version: X}- Time = 30
{service: foo, env: staging, cluster-name: us-staging, version: Y}- Time = 45
{service: foo, env: staging, cluster-name: dev-shopist, version: Y}- 배포 간 최대 시간:
max:datadog.service.time_between_deployments{env: staging, cluster-name: *} = 25
추가 자료
