태그 인덱싱 규칙

원문 보기 위키 갱신 2026.10.05

태그 인덱싱 규칙 (Tag Indexing Rules)

태그가 많아질수록 카디널리티가 커지고 비용도 늘어나기 마련이에요. 태그 인덱싱 규칙(Tag Indexing Rules)은 수집(ingestion) 시점에 Datadog이 메트릭 태그를 어떻게 처리할지 정의하는 중앙 집중식 구성입니다. 어떤 태그를 유지하고 어떤 태그를 제외할지 선제적으로 제어해, 불필요한 태그를 제거하고 조직 전반에 일관된 태깅을 확립할 수 있어요.

이 규칙은 이름이나 접두사로 식별되는 메트릭 그룹에 작동합니다. 정의된 패턴과 일치하는 기존 메트릭과 새로 수집되는 메트릭 모두에 적용되어, 사후 정리나 코드 변경의 필요를 줄이고 예측 가능한 비용 관리를 가능하게 합니다.

출처: 문서

본문

개요 (Overview)

태그 인덱싱 규칙은 수집 시점에 Datadog이 메트릭 태그를 어떻게 처리할지 정의하는 중앙 집중식 구성이에요. 유지하거나 제외할 태그를 선제적으로 제어해, 불필요한 태그를 제거해 높은 카디널리티를 줄이고 조직 전반에 일관된 태깅을 보장할 수 있습니다.

태그 인덱싱 규칙은 이름이나 접두사로 식별되는 메트릭 그룹에 작동해요. 정의된 패턴과 일치하는 기존 메트릭과 새로 수집되는 메트릭 모두에 적용되므로, 사후 정리나 코드 변경의 필요가 줄고 더 예측 가능한 비용 관리가 가능합니다.

태그 규칙 만들기 (Create a tag rule)

규칙을 만들면 Datadog이 일치하는 모든 메트릭에 자동으로 적용해요.

Metrics → Settings로 이동하세요.
+ Create Rule을 클릭하세요.
Configure Tag Indexing Rule을 선택하세요.

1단계: 규칙 세부 정보 설정 (Set rule details)

규칙 이름을 입력하세요. 규칙의 목적을 명확히 알 수 있는 설명적인 이름을 쓰면 좋아요.

2단계: 규칙 범위 정의 (Define rule scope)

규칙이 적용될 메트릭을 선택하세요. 다음 옵션 중 하나 이상으로 규칙 범위를 정의합니다.

메트릭 이름 또는 접두사 — 특정 메트릭 이름이나 네임스페이스에 규칙을 적용해요(예: http.*, db.query.*).
접두사 예외 — 규칙 범위에서 특정 접두사를 제외해요(예: http.*에 적용하되 http.client.*는 제외).

같은 메트릭에 여러 규칙이 적용되면 Datadog은 순서대로 평가해요. 선택적으로 Override 동작을 사용해 선택한 메트릭에 대해 이전에 평가된 규칙을 대체할 수 있습니다.

3단계: 태그 동작 구성 (Configure tag behavior)

범위에 있는 메트릭의 태그를 규칙이 어떻게 처리할지 정의하세요.

기존 구성 병합 또는 오버라이드 (Merge or override existing configurations)

이 규칙이 기존 태그 구성을 기반으로 할지, 완전히 대체할지 선택하세요.

Merge (기본값) — 기존 태그 구성 위에 이 규칙을 적용해요. 이전 구성이 없는 메트릭은 영향을 받지 않습니다.
Override — 같은 접두사에 적용되는 다른 모든 규칙을 무시하고 이 규칙만 강제해요. Override all other rules that apply to these prefixes 옵션을 선택하면 이 동작이 활성화됩니다.

참고: 더 좁은 규칙에 Override 동작을 사용하면 더 넓은 규칙의 태그 제외가 쌓이는 것을 막을 수 있어요. 예를 들어 규칙 1이 Merge 동작으로 dd.*에서 host를 제외하고, 규칙 2가 dd.payments.*에서 app_name을 제외한다고 해 볼게요. 규칙 2도 Merge를 사용하면 dd.payments.* 메트릭에서 host와 app_name 모두 제거됩니다. 규칙 2가 Override를 사용하면 app_name만 제거되죠(규칙 1의 효과는 그 접두사에 대해 오버라이드됩니다).

새 메트릭에만 적용 (Apply to new metrics only)

이 규칙을 규칙 생성 후 제출되는 메트릭에만 적용해요. 규칙과 일치하는 기존 메트릭은 변경되지 않습니다.

포함하거나 제외할 태그 선택 (Select tags to include or exclude)

태그 필터링에 허용목록(allowlist)과 차단목록(blocklist) 중 어떤 것을 사용할지 선택하세요.

Include tags — 쿼리 가능하게 유지할 태그의 허용목록을 사용해요.
Exclude tags — 쿼리할 수 없는 태그를 정의하는 차단목록을 사용하거나, 태그 사용량을 이용해 지난 30·60·90일 동안 쿼리되지 않으면서 대시보드나 다른 자산에서도 사용되지 않은 태그를 자동으로 인덱스 해제해요.

포함하거나 제외할 태그 키를 추가하세요.

태그 동작을 구성하면 미리보기가 영향을 받는 메트릭 목록(UI에서 최대 100개)을 보여 줘요.

기본적으로 모든 새 규칙은 현재 규칙 세트의 맨 아래에 추가됩니다.

제한사항 (Limitations)

제외 규칙은 Datadog이 메트릭에서 태그를 관찰한 뒤에 효과가 있어요.
Datadog은 규칙을 순차적으로 평가하며, 각 후속 규칙은 이전 구성을 기반으로 하거나 대체합니다.
태그 연령: Tag Usage를 사용하는 규칙의 경우, 새 태그는 규칙이 적용되기 전에 15일의 유예 기간을 받아요.

규칙 수정하기 (Modify a rule)

Metrics → Settings → Rules로 이동해 기존 규칙을 수정하세요. 변경 후에는 Datadog이 일치하는 모든 메트릭에 자동으로 적용합니다.

규칙 편집 (Edit a rule)

규칙을 선택해 상세 패널을 열고, Edit을 클릭해 규칙의 범위, 태그 선택, merge·override 동작을 변경하세요.

규칙 재정렬 (Reorder rules)

규칙을 끌어서 평가 순서를 변경하세요. 평가 순서는 여러 규칙이 같은 메트릭에 적용될 때 규칙들이 어떻게 상호작용하는지 결정합니다.

규칙 삭제 (Delete a rule)

더 이상 필요 없는 규칙을 제거하세요. 규칙을 삭제하면 Datadog은 남은 규칙을 기준으로 영향받는 메트릭의 태그 구성을 다시 계산합니다.

특정 메트릭에 대한 규칙 오버라이드 (Override rules for a specific metric)

메트릭을 태그 규칙에서 제외하려면, Metrics Summary에서 메트릭의 상세 사이드 패널을 열고 Configure This Metric Individually를 선택한 뒤 메트릭이 모든 태그를 유지하도록 설정하세요. 모든 태그를 유지하면 규칙 자체를 수정하지 않고도 해당 메트릭에 대한 모든 태그 규칙을 우회합니다.

규칙을 다시 적용하려면 같은 패널에서 메트릭의 기본 구성을 복원하세요.

규칙 우선순위 (Rule precedence)

여러 규칙이 같은 메트릭에 적용되면 Datadog은 순차적으로 평가해요. 규칙 순서가 중요한 이유는:

평가 순서에서 더 아래에 있는 규칙이 이전 규칙의 결과를 수정합니다
Override 동작은 일치하는 메트릭의 이전 구성을 덮어써요
Merge 동작은 기존 구성을 기반으로 합니다
여러 규칙이 Override 동작을 사용하면, 마지막으로 적용된 규칙이 최종 구성이 include인지 exclude인지 결정해요

Rules 페이지에서 규칙을 재정렬해 어떤 규칙이 우선하는지 바꾸세요. 아래 예시를 통해 서로 다른 순서가 어떻게 다른 결과를 만드는지 살펴보세요.

우선순위 예시 (Precedence examples)

예시 1: Merge와 Override 동작 (Merge and Override behavior)

태그 규칙은 기존 구성을 오버라이드하거나 병합할 수 있어요. 그 선택에 따라 규칙이 태그 구성을 재설정하는지, 기존 구성 위에 쌓는지가 달라집니다.

시작 태그: host, env, service, team

핵심 인사이트: env 태그는 infra.* 메트릭에만 다시 추가됩니다.

예시 2: 규칙 순서 (Rule order)

여러 규칙이 같은 메트릭에 적용되면 Datadog은 순서대로 평가해요. 나중에 실행되는 규칙이 이전 규칙의 효과를 세밀화하거나 오버라이드할 수 있습니다.

시작 태그: host, env, service

이 예시에서 규칙 2는 허용목록 역할을 하는 Include 구성을 사용해요. 나열된 태그만 유지되고, 나열되지 않은 태그는 모두 제거됩니다.

순서 1: 구체적 규칙 먼저 (Specific rule first)

핵심 인사이트: 규칙 1이 host 태그를 제거한 뒤, 규칙 2가 host를 다시 추가해요.

순서 2: 일반 규칙 먼저 (General rule first)

핵심 인사이트: host 태그가 마지막에 제거되어 계속 제거된 상태로 유지됩니다.

예시 3: 넓은 규칙에 대한 예외 (Exception to a broad rule)

Override 동작을 가진 넓은 규칙으로 태그를 전역적으로 제외한 다음, Merge 동작을 가진 타겟 규칙으로 특정 메트릭에 태그를 복원하세요.

시작 태그: node, env, pod

핵심 인사이트: 넓은 제외와 좁은 포함이 메트릭에 대해 서로 상쇄되면, 태그 제한이 적용되지 않고 모든 원래 태그가 보존됩니다.

예시 4: 넓은 규칙에 대한 여러 예외 (Multiple exceptions to a broad rule)

Override 동작의 넓은 규칙 위에 Merge 동작의 규칙 여러 개를 겹쳐, 서로 다른 메트릭 접두사에 서로 다른 태그를 복원하세요. 더 구체적인 접두사와 일치하는 메트릭은 더 많은 복원을 쌓게 됩니다.

시작 태그: team, pod, env

핵심 인사이트: Override 동작의 제외 규칙 뒤에 적용되는 Merge 동작의 여러 포함 규칙은 가산적이에요(두 예외 접두사와 일치하는 메트릭은 두 태그 세트 모두 복원됩니다).

Metrics without Limits™ 호환성 (Metrics without Limits™ compatibility)

기존 Metrics without Limits™(MWL) 메트릭별 구성은 태그 인덱싱 규칙보다 우선하며 예외(exemption)로 작동해요. 예외가 활성 상태인 동안에는 메트릭이 어떤 태그 인덱싱 규칙의 영향도 받지 않습니다.

이 예외들은 Tag Indexing Rules 페이지에서 검토하고 제거할 수 있어요. Datadog은 각 예외를 다음과 같이 분류합니다.

Safe to remove (제거해도 안전): 계정의 태그 인덱싱 규칙에 대한 Datadog 분석에 따르면, 예외를 제거하면 커스텀 메트릭 사용량이 줄어들 것으로 예상됩니다.
Needs review (검토 필요): 예외를 제거하면 커스텀 메트릭 사용량에 영향을 주거나, 태그 인덱싱 규칙이 기존 MWL 구성에 포함된 모든 태그를 보존하지 못할 수 있어요. 이런 태그에 의존하는 대시보드, 모니터, 기타 자산이 깨지지 않도록 예외들을 신중히 검토하세요.

참고: Datadog은 검토가 필요한 각 예외에 대해 별도의 태그 인덱싱 규칙을 만드는 것을 권장하지 않아요. 기존 태그 인덱싱 규칙이 이 메트릭들을 적절히 관리할 수 없다면 예외로 유지하세요.

예외는 개별 태그 인덱싱 규칙이 아니라 계정 전체에 적용됩니다. 한 규칙에서 메트릭의 예외를 제거하면 계정의 모든 태그 인덱싱 규칙에서 자동으로 제거돼요. 그러면 해당 메트릭은 현재 순서에 따라 태그 인덱싱 규칙에 대해 평가됩니다.

모범 사례 (Best practices)

태그 인덱싱 규칙을 커스텀 메트릭 그룹 전체의 인덱스 태그를 거버닝하는 기본 방식으로 사용하세요. 대부분의 계정은 메트릭을 관리하는 데 약 10~20개의 규칙이 필요해요. 각 메트릭이나 예외마다 별도 규칙을 만들기보다, 공통 태그 요구사항을 가진 메트릭 그룹에 규칙을 만드세요.

태그 인덱싱 규칙이 적절히 관리하지 못하는 메트릭은 Metrics without Limits™로 개별 구성하거나 기존 예외를 유지하세요.

골든 규칙(Golden Rule)을 먼저 만들기 (Create the Golden Rule first)

골든 규칙은 첫 번째 태그 인덱싱 규칙으로 만들어야 하고, 규칙 순서에서도 첫 번째로 유지해야 해요. 더 타겟화된 규칙이나 메트릭 수준 예외를 추가하기 전에 기준 정책으로 자리 잡게 하는 것입니다.

골든 규칙은 다음과 같아요.

지난 30·60·90일 동안 쿼리되지 않았고 대시보드, 모니터, SLO, 노트북 같은 Datadog 자산 어디에서도 사용되지 않은 모든 태그 키를 인덱스 해제한다.

골든 규칙을 구성하려면:

다른 태그 인덱싱 규칙을 만들기 전에 이 규칙을 만드세요. 기존 규칙이 있다면 골든 규칙을 첫 번째 위치로 옮기세요.
Exclude tags를 선택한 다음 By tag usage를 선택하세요.
쿼리 창을 30, 60, 90일로 설정하세요.
태그 키가 Datadog 자산에서 사용되지 않아야 하도록 요구하세요.
*를 사용해 규칙을 모든 커스텀 메트릭에 적용하세요.

새로 제출된 태그 키는 규칙이 사용량을 평가하기 전에 15일의 유예 기간을 받아요. 이렇게 하면 태그가 인덱스 해제되기 전에 팀이 새 태그를 쿼리하거나 Datadog 자산에서 사용할 시간을 확보할 수 있습니다.

골든 규칙을 확립한 뒤에는 이 기본값과 다른 메트릭을 위한 더 좁은 규칙을 만드세요.

태그 인덱싱 규칙과 Metrics without Limits™ 사이에서 선택하기 (Choose between Tag Indexing Rules and Metrics without Limits™)

태그 인덱싱 규칙은 단일 메트릭, 네임스페이스, 여러 접두사, 또는 모든 커스텀 메트릭에 적용할 수 있는 동적 정책이에요. 새 커스텀 메트릭은 도착할 때 기존 규칙에 대해 자동으로 평가됩니다. 규칙과 일치하는 메트릭은 개별 구성 없이 관리됩니다.

Metrics without Limits 구성은 정적이며 메트릭 하나씩 적용돼요. 특정 메트릭이 다른 인덱스 태그 세트를 필요로 할 때 사용하세요.

기존 Metrics without Limits™ 구성은 태그 인덱싱 규칙보다 우선해요. Metrics without Limits™ 구성이 활성 상태인 동안에는 해당 메트릭이 예외로 취급되어 태그 인덱싱 규칙의 적용을 받지 않습니다.

사용 사례	권장 제어 도구
모든 커스텀 메트릭의 기본 인덱싱 정책 확립	태그 인덱싱 규칙: 골든 규칙
네임스페이스 또는 접두사 세트 전체에 동일한 태그 정책 적용	태그 인덱싱 규칙
기존 정책과 일치하는 새 메트릭·태그 키 자동 관리	태그 인덱싱 규칙
쿼리되지 않고 Datadog 자산에서 사용되지 않는 태그 인덱스 해제	태그 인덱싱 규칙
여러 메트릭에서 알려진 고카디널리티 태그 제거	태그 인덱싱 규칙
여러 메트릭에서 승인된 태그 세트만 유지	태그 인덱싱 규칙
한 메트릭에 대해 다른 인덱스 태그 세트 구성	Metrics without Limits™

추가 규칙을 의도적으로 범위 지정하기 (Scope additional rules intentionally)

골든 규칙을 만든 뒤에는 기본값과 다른 요구사항을 가진 메트릭 그룹이 있을 때만 더 좁은 규칙을 추가하세요.

같은 서비스, 애플리케이션, 또는 팀이 소유한 메트릭에는 네임스페이스나 접두사를 사용하세요.
같은 정책이 관련 메트릭 그룹에 적용될 때는 여러 접두사를 사용하세요.
정책이 모든 커스텀 메트릭에 적용되어야 할 때만 *를 사용하세요.

명확한 규칙 범위를 정의하고 불필요한 중복을 피하세요. 그러면 어떤 정책이 각 메트릭을 관리하는지, 그 변경을 누가 소유하는지 이해하기 쉬워집니다.

새 규칙을 추가할 때마다 골든 규칙이 첫 번째 위치에 유지되는지 확인하세요.

태그 인덱싱 규칙