개요

태깅은 Datadog 전반에서 사용되며, 모니터링하는 시스템과 메트릭을 조회하는 데 활용됩니다. 태그를 할당하고 이를 기준으로 필터링할 수 없다면, 환경에서 문제를 찾고 원인을 좁혀 실제 근본 원인을 발견하는 것이 어려울 수 있습니다. 계속 진행하기 전에 Datadog에서 태그 정의 방법을 알아보세요.

태그는 다음과 같은 여러 방식으로 구성할 수 있습니다.

• Datadog Agent 구성 파일 또는 개별 통합 구성 파일에서
• Datadog UI를 통해
• Datadog API를 통해
• DogStatsD를 통해

태그 할당 방법

구성 파일

tags: ["<KEY_1>:<VALUE_1>", "<KEY_2>:<VALUE_2>", "<KEY_3>:<VALUE_3>"]

tags:
    - "<KEY_1>:<VALUE_1>"
    - "<KEY_2>:<VALUE_2>"
    - "<KEY_3>:<VALUE_3>"

# Set the hostname (default: auto-detected)
# Must comply with RFC-1123, which permits only:
# "A" to "Z", "a" to "z", "0" to "9", and the hyphen (-)
hostname: mymachine.mydomain

tags: <KEY_1>:<VALUE_1>, <KEY_2>:<VALUE_2>, <KEY_3>:<VALUE_3>

# Set the hostname (default: auto-detected)
# Must comply with RFC-1123, which permits only:
# "A" to "Z", "a" to "z", "0" to "9", and the hyphen (-)
hostname: mymachine.mydomain

통합 상속

태그를 할당하는 가장 효율적인 방법은 통합 상속을 활용하는 것입니다. AWS 인스턴스, Chef 레시피 및 기타 통합에 할당한 태그는 Datadog으로 전송되는 호스트와 메트릭에 자동으로 상속됩니다.

컨테이너화된 환경에서는 unified service tagging 설명서에 따라 모든 Datadog 텔레메트리의 구성 단일 지점에서 관리하시길 권장합니다.

클라우드 통합

클라우드 통합은 인증 기반으로 동작합니다. Datadog은 가능하면 기본 클라우드 통합 타일(AWS, Azure, Google Cloud 등)을 사용하고 Agent 설치를 함께 수행할 것을 권장합니다. 참고: Agent만 사용하는 경우 일부 통합 태그는 사용할 수 없습니다.

웹 통합

웹 통합은 인증 기반으로 동작합니다. 메트릭은 API 호출을 통해 수집됩니다. 참고: Datadog은 CamelCase 태그를 밑줄(_)로 변환합니다. 예: TestTag –> test_tag.

환경 변수

컨테이너화된 Datadog Agent를 설치한 후 Agent의 기본 구성 파일에서 환경 변수 DD_TAGS를 사용하여 호스트 태그를 설정할 수 있습니다. 여러 태그를 지정하는 경우 각 태그는 공백으로 구분합니다.

참고: DD_TAGS 환경 변수는 공백을 사용하여 태그를 구분합니다. 예를 들어 DD_TAGS="key1:val1 key2:val2"는 두 개의 태그를 설정합니다. 반면 DD_TAGS="test:this is a test"와 같은 값은 네 개의 개별 태그(test:this, is, a, test)를 생성합니다. 공백으로 구분된 각 토큰이 독립적인 태그로 처리되기 때문입니다. 태그 값에 공백을 포함해야 하는 경우에는 대신 YAML 구성 또는 통합 주석을 통해 태그를 구성하세요. 이 방법들은 공백을 밑줄(_)로 변환합니다(예: test:this is a test → test:this_is_a_test).

Datadog은 Docker, Kubernetes, ECS, Swarm, Mesos, Nomad 및 Rancher에서 일반적으로 사용되는 태그를 자동으로 수집합니다. 더 많은 태그를 추출하려면 다음 옵션을 사용하세요.

예시:

DD_KUBERNETES_POD_LABELS_AS_TAGS='{"app":"kube_app","release":"helm_release"}'
DD_CONTAINER_LABELS_AS_TAGS='{"com.docker.compose.service":"service_name"}'

DD_KUBERNETES_POD_LABELS_AS_TAGS를 사용할 때는 다음 형식의 와일드카드를 사용할 수 있습니다.

{"foo": "bar_%%label%%"}

예를 들어 {"app*": "kube_%%label%%"}은 레이블 application에 대해 태그 이름 kube_application으로 해석됩니다. 또한 {"*": "kube_%%label%%"}는 모든 포드 레이블을 kube_ 접두사를 붙인 태그로 추가합니다.

Docker Swarm의 docker-compose.yaml 파일 내에서 DD_CONTAINER_LABELS_AS_TAGS 변수를 사용하는 경우에는 아포스트로피를 제거해야 합니다. 예를 들면 다음과 같습니다.

- DD_CONTAINER_LABELS_AS_TAGS={"com.docker.compose.service":"service_name"}

Docker 컨테이너에 레이블을 추가할 때는 docker-compose.yaml 파일 내에서 labels: 키워드의 위치가 중요합니다. 문제를 방지하려면 Docker unified service tagging 설명서를 따르세요.

컨테이너에 이 구성 외부에서 레이블을 지정해야 하는 경우, labels: 키워드는 services: 섹션의 내부에 배치해야 하며, deploy: 섹션 내부에 두어서는 안 됩니다. 서비스에 레이블을 지정해야 하는 경우에만 labels: 키워드를 deploy: 섹션 내부에 배치하세요. 이와 같이 배치하지 않으면 Datadog Agent는 컨테이너에서 추출할 레이블을 찾을 수 없습니다.

아래는 이러한 레이블 배치 방식을 보여주는 정상 동작 예시 docker-compose.yaml 파일입니다. 아래 예시에서 myapplication: 섹션의 레이블 my.custom.label.project 및 my.custom.label.version는 각각 고유한 값을 가집니다. datadog: 섹션에서 DD_CONTAINER_LABELS_AS_TAGS 환경 변수를 사용하면 레이블이 추출되어 myapplication 컨테이너에 대해 다음 태그가 생성됩니다.

myapplication 컨테이너 내부의 레이블은 my.custom.label.project 및 my.custom.label.version입니다.

Agent가 컨테이너에서 레이블을 추출한 후 생성되는 태그는 다음과 같습니다. projecttag:projectA versiontag:1

샘플 docker-compose.yaml:

services:
  datadog:
    volumes:
      - '/var/run/docker.sock:/var/run/docker.sock:ro'
      - '/proc:/host/proc:ro'
      - '/sys/fs/cgroup/:/host/sys/fs/cgroup:ro'
    environment:
      - DD_API_KEY= "<DATADOG_API_KEY>"
      - DD_CONTAINER_LABELS_AS_TAGS={"my.custom.label.project":"projecttag","my.custom.label.version":"versiontag"}
      - DD_TAGS="key1:value1 key2:value2 key3:value3"
    image: 'registry.datadoghq.com/agent:latest'
    deploy:
      restart_policy:
        condition: on-failure
      mode: replicated
      replicas: 1
  myapplication:
    image: 'myapplication'
    labels:
      my.custom.label.project: 'projectA'
      my.custom.label.version: '1'
    deploy:
      restart_policy:
        condition: on-failure
      mode: replicated
      replicas: 1

변수를 사용자 지정 datadog.yaml에 정의하거나 해당 환경 변수에 JSON 맵 형식으로 설정할 수 있습니다. 맵의 키는 소스(label/envvar) 이름이며, 값은 Datadog 태그 이름입니다.

태그 카디널리티

태그 카디널리티를 설정하는 환경 변수는 DD_CHECKS_TAG_CARDINALITY와 DD_DOGSTATSD_TAG_CARDINALITY 두 가지입니다. DogStatsD는 과금 방식이 다르므로 보다 세밀한 구성을 제공하기 위해 DogStatsD 태그 카디널리티 설정이 별도로 분리되어 있습니다. 그 외에는 두 변수 모두 동일하게 동작하며, 값으로 low, orchestrator, high를 사용할 수 있습니다. 기본값은 모두 low이며, Kubernetes 클러스터 수준 태그를 수집합니다.

각 카디널리티 설정은 다음 대상을 기준으로 합니다.

• low: Kubernetes 클러스터 수준 태그(예: kube_namespace).
• orchestrator: 포드 수준 태그(예: pod_name).
• high: 컨테이너 수준 태그(예: container_id).

카디널리티 설정에 따라 Kubernetes 및 OpenShift, Docker, Rancher 및 Mesos에서 제공되는 기본 태그 세트가 달라집니다. ECS 및 Fargate에서는 변수를 orchestrator로 설정하면 task_arn 태그가 추가됩니다.

참고:

• DogStatsD 메트릭에 컨테이너 태그를 전송하면 메트릭 수가 증가할 수 있습니다(호스트당 하나가 아니라 컨테이너당 하나). 이는 사용자 지정 메트릭 과금에 영향을 줄 수 있습니다.
• 메트릭에서는 타임스탬프가 가장 가까운 초 단위로 반올림됩니다. 타임스탬프가 동일한 데이터 포인트가 여러 개 있는 경우 최신 데이터 포인트가 이전 포인트를 덮어씁니다. 더 높은 카디널리티를 설정하면 이러한 문제를 방지하는 데 도움이 될 수 있습니다.

트레이스

Datadog SDK는 환경 변수, 시스템 속성 또는 코드 내 구성을 통해 구성할 수 있습니다. 각 SDK의 태그 지정 옵션 및 구성에 대한 정보는 Datadog 트레이싱 구성 설명서를 참조하세요. 또한 unified service tagging 설명서를 참고하여 SDK를 unified service tagging용으로 구성할 수 있습니다.

사용하는 SDK와 관계없이 스팬 메타데이터는 유형이 지정된 트리 구조를 따라야 합니다. 트리의 각 노드는 .로 구분되며 하나의 유형만 가질 수 있습니다..

예를 들어 하나의 노드는 객체(하위 노드 포함)이면서 동시에 문자열일 수 없습니다.

{
  "key": "value",
  "key.subkey": "value_2"
}

위의 스팬 메타데이터 예시는 유효하지 않습니다. key 값은 문자열("value")을 참조하면서 동시에 하위 트리({"subkey": "value_2"})를 참조할 수 없기 때문입니다.

UI

Host Map 페이지를 사용하여 UI에서 호스트 태그를 할당할 수 있습니다. 페이지에서 육각형(호스트)을 클릭하면 화면 하단에 호스트 오버레이가 표시됩니다. 그런 다음 User 섹션에서 Add Tags 버튼을 클릭합니다. 태그를 쉼표로 구분하여 입력한 후 Save Tags를 클릭합니다. UI에서 변경한 호스트 태그는 적용되기까지 최대 5분이 걸릴 수 있습니다.

Infrastructure List 페이지를 사용하여 UI에서 호스트 태그를 할당할 수 있습니다. 호스트를 클릭하면 페이지 오른쪽에 호스트 오버레이가 표시됩니다. 그런 다음 User 섹션에서 Add Tags 버튼을 클릭합니다. 태그를 쉼표로 구분하여 입력한 후 Save Tags를 클릭합니다. UI에서 변경한 호스트 태그는 적용되기까지 최대 5분이 걸릴 수 있습니다. 태그를 추가한 후에는 추가 태그를 입력하기 전에 해당 태그가 UI에 표시되는지 확인하세요.

모니터 관리 페이지에서 태그를 추가할 모니터 옆의 체크박스를 선택합니다(하나 또는 여러 개 선택 가능). Edit Tags 버튼을 클릭합니다. 태그를 입력하거나 이전에 사용한 태그를 선택합니다. 그런 다음 Add Tagtag:name 또는 Apply Changes를 클릭합니다. 이미 태그가 추가되어 있는 경우 태그 체크박스를 사용하여 여러 태그를 한 번에 할당할 수 있습니다. 자세한 내용은 모니터 관리 설명서를 참조하세요.

모니터를 생성할 때는 4단계 Say what’s happening 또는 Notify your Team 아래에서 모니터 태그를 지정합니다.

Distribution Metrics에서 메트릭에 최대 10개의 태그 허용 목록을 적용하여 백분위수 집계를 생성할 수 있습니다. 이렇게 하면 조회 가능한 모든 태그 값 조합에 대해 시계열이 생성됩니다. Distribution Metrics에서 생성되는 사용자 지정 메트릭 및 시계열 계산 방식에 대한 자세한 내용은 Custom Metrics를 참조하세요.

최대 10개의 태그를 적용할 수 있습니다. 제외 태그는 허용되지 않습니다.

AWS 통합 타일을 사용하면 계정 수준의 모든 메트릭과 자동 구독 트리거를 통해 전송되는 로그에 추가 태그를 할당할 수 있습니다. <KEY>:<VALUE> 형식의 태그를 쉼표로 구분하여 사용하세요.

SLO를 생성할 때 3단계 Add name and tags에서 태그를 할당합니다.

API

Web server 1: api.metric('page.views', [(1317652676, 100), ...], host="example_prod_1")
Web server 2: api.metric('page.views', [(1317652676, 500), ...], host="example_prod_2")

Web server 1: api.metric('page.views', [(1317652676, 100), ...], tags=['domain:example.com'])
Web server 2: api.metric('page.views', [(1317652676, 500), ...], tags=['domain:example.com'])

sum:page.views{domain:example.com}

sum:page.views{domain:example.com} by {host}

DogStatsD

DogStatsD로 전송하는 모든 메트릭, 이벤트 또는 서비스 검사에 태그를 추가할 수 있습니다. 예를 들어 알고리즘 버전 태그를 타이머 메트릭에 추가하여 두 알고리즘의 성능을 비교할 수 있습니다.

@statsd.timed('algorithm.run_time', tags=['algorithm:one'])
def algorithm_one():
    # Do fancy things here ...

@statsd.timed('algorithm.run_time', tags=['algorithm:two'])
def algorithm_two():
    # Do fancy things (maybe faster?) here ...

참고: 태깅은 StatsD에 대한 Datadog 전용 확장 기능입니다.

DogStatsD 메트릭에 host 태그를 할당할 때는 특별한 주의가 필요합니다. 호스트 태그 키에 대한 자세한 내용은 메트릭 제출: DogStatsD 설명서를 참조하세요.

추가 자료

추가 유용한 문서, 링크 및 기사:

태그 시작하기설명서 Datadog에서 태그를 사용하는 방법 알아보기설명서