태그 강화 (Tag Enrichment)

원문 보기 위키 갱신 2026.10.05

코드를 재배포하지 않고 Catalog 서비스 정의의 팀 및 시스템 태그로 텔레메트리를 자동으로 강화하는 방법을 안내해요.

출처: 문서

본문

참고: 태그 강화는 프리뷰 상태예요. 액세스를 요청하려면 이 양식을 작성해요.

액세스 요청

개요

태그 강화 규칙을 사용해 코드 변경이나 재배포 없이 로그, APM 스팬, 트레이스 메트릭에 태그를 추가해요. Catalog에 이미 정의한 서비스 메타데이터의 값, 다른 태그의 값 또는 고정 값을 사용할 수 있어요.

사전 요구 사항

태그 강화 규칙을 만들려면 Datadog Admin 역할이 있어야 해요. 자세한 내용은 역할 기반 액세스 제어를 참조하세요.

태그 강화 규칙 생성

기본 태그 강화 규칙

기본 규칙을 활성화하려면 IDP > Manage > Tag Enrichment로 이동해 페이지 하단에서 team 또는 system에 대한 기본 규칙을 켜요.

기본 규칙을 활성화하면 IDP에 정의된 Entity Metadata를 기반으로 서비스의 모든 텔레메트리에 team 또는 system이 적용돼요. Entity Metadata가 채워진 서비스만 강화돼요. 태그는 서비스의 텔레메트리에 해당 태그 값이 아직 없을 때만 추가돼요.

커스텀 태그 강화 규칙

커스텀 규칙을 사용하면 특정 서비스 집합을 대상으로 하고 각 태그 값이 어떻게 소싱되고 적용되는지 정확히 구성할 수 있어요.

Datadog에서 IDP > Manage > Tag Enrichment로 이동하고 + Add Rule을 클릭해요.
강화할 엔터티를 선택해요. 엔터티를 선택하면 쿼리가 백그라운드로 구성돼요. 쿼리를 편집하려면 Build Advanced Query를 선택해요.
- 쿼리에 AND 조건을 추가하려면 Add Condition을 선택해요.
- Value 필드에 여러 값을 추가해 OR 조건을 만드세요.
태그와 강화 방법을 선택해요:
- team 태그, system 태그, custom 태그 또는 여러 개를 선택해요.
- 각 태그에 대해 태그 값이 Entity Metadata에서 오는지, 다른 태그의 값인지, 고정 값인지 선택해요.
- 값이 아직 없을 때만 적용할지, 아니면 해당 태그의 현재 값 목록에 추가할지 선택해요.
기본적으로 태그는 특정 텔레메트리 항목에 값이 없을 때만 추가돼요.
선택 사항으로 규칙의 설명 이름을 입력해요.
규칙을 검토하고 저장해요. 규칙을 저장한 후 강화가 수신 텔레메트리에 완전히 적용되는 데 최대 1시간이 걸릴 수 있어요.

서비스 페이지에서 태그 강화 규칙 추가

team 또는 system 태그가 없는 모든 서비스 페이지에서 Service Config를 클릭해 구성 사이드 패널을 열어요. 패널 상단의 배너는 어떤 태그가 없는지 나타내요.

Add Tags를 클릭해 해당 서비스가 미리 채워진 태그 강화 규칙 모달을 열어요.

태그 강화 동작

영향받는 텔레메트리: 태그 강화는 로그, APM 스팬, 트레이스 메트릭에만 적용돼요. Data Observability: Jobs Monitoring은 작업 텔레메트리를 APM 스팬으로 보내므로 해당 텔레메트리도 강화되지만 Jobs Monitoring 메트릭은 강화되지 않아요. 태그 강화는 커스텀 및 인프라 메트릭, Database Monitoring, Profiling, Kubernetes, Universal Service Monitoring, Events를 포함한 다른 텔레메트리 유형에서는 지원되지 않아요.
기존 데이터: 태그 강화 규칙은 규칙이 활성화된 동안 수집된 텔레메트리에만 적용돼요. 과거 데이터는 소급 업데이트되지 않아요. 규칙을 삭제하거나 수정하면 새 텔레메트리에 적용이 중지되지만 이전에 수집된 데이터는 업데이트되지 않아요.
메타데이터 업데이트: 기본 규칙을 포함해 강화 규칙이 활성화된 동안 서비스에 Entity Metadata를 업데이트하거나 추가하면 해당 태그가 자동으로 업데이트돼요.
규칙 처리 순서: 태그 강화 규칙은 생성된 순서대로 적용돼요. 목록 상단의 규칙이 그 아래 규칙보다 우선해요.
리매핑 규칙과의 상호 작용: 태그 강화 규칙은 서비스 리매핑 규칙 이후에 적용돼요. 서비스 리매핑 규칙이 service 태그를 수정하면 강화는 IDP 메타데이터를 조회할 때 업데이트된 서비스 이름을 사용해요.
주요 태그: 태그 강화는 주요 태그 해석 이후에 적용되므로 강화된 태그는 주요 태그로 사용할 수 없어요.