메트릭 요약

원문 보기 위키 갱신 2026.10.05

메트릭 요약 (Metrics Summary)

Metrics Summary 페이지는 지정된 시간 프레임(지난 1시간, 하루, 또는 1주일)에 Datadog에 보고된 메트릭 목록을 표시해요. Metric 또는 Tag 검색 필드를 사용해 메트릭 이름이나 태그로 메트릭을 검색할 수 있습니다.

검색 필드는 태그 필터링을 위한 불리언(Boolean) 및 와일드카드(card) 구문, 메트릭 검색을 위한 향상된 퍼지 매칭(fuzzy matching)도 지원해요. 특정 태그 키로 태그된 메트릭(team:*)이나 특정 태그 키가 없는 메트릭(NOT team:*)을 식별할 수 있습니다.

출처: 문서

본문

개요 (Overview)

Metrics Summary 페이지는 지정된 시간 프레임 — 지난 1시간, 하루, 또는 일주일 — 에 Datadog에 보고된 메트릭 목록을 표시해요.

Metric 또는 Tag 검색 필드를 사용해 메트릭 이름이나 태그로 메트릭을 검색하세요.

참고: 태그 값은 Tag 검색 필드에 28시간 동안 유지돼요. 지난 28시간 동안 제출되지 않은 값은, 메트릭 상세 사이드 패널에는 계속 보이더라도 검색 옵션으로 나타나지 않습니다.

Metrics 검색 필드의 향상된 퍼지 매칭 지원으로 관련 메트릭도 발견할 수 있어요.

태그 필터링은 불리언과 와일드카드 구문을 지원하므로 다음을 식별할 수 있습니다.

특정 태그 키로 태그된 메트릭, 예: team → team:*
특정 태그 키가 없는 메트릭, 예: team → NOT team:*

검색창은 메트릭 목록을 필터링할 수 있는 가장 포괄적인 동작 세트를 제공해요. 하지만 패싯(facet)으로도 메트릭을 다음 기준으로 필터링할 수 있습니다.

Configuration: 태그 구성이 있는 메트릭
Percentiles: 백분위수/고급 쿼리 기능이 활성화된 distribution 메트릭
Historical Metrics: 과거 메트릭 수집이 활성화된 메트릭
Metric Category: 커스텀 메트릭과 표준 통합 메트릭 구분
Query Activity: 지난 30, 60, 90일 동안 Datadog 또는 API에서 쿼리되지 않은 메트릭
Related Assets: 대시보드, 노트북, 모니터, SLO에서 사용 중인 메트릭
Metric Type: distribution 메트릭과 비-distribution 메트릭(counts, gauges, rates) 구분
Metric Origin: 메트릭이 시작된 제품(예: Logs 또는 APM Spans에서 생성된 메트릭). 다양한 메트릭 오리진 유형에 대해 자세히 알아보려면 메트릭 오리진 정의를 참고하세요.

정의 (Definitions)

메트릭이 지난 30, 60, 90일 동안 모니터, SLO, 실행된 노트북, 열린 대시보드, Metrics Explorer 쿼리, API 호출에서 접근되지 않았다면 쿼리되지 않은(unqueried) 것으로 간주해요.

메트릭은 자산에 존재하는 한, 활발히 쿼리되었는지와 무관하게 사용됨(used) 으로 간주됩니다.

여러 메트릭 구성 (Configuration of multiple metrics)

Configure Metrics를 클릭하면 한 번에 둘 이상의 메트릭을 구성할 수 있는 여러 옵션이 제공돼요.

Manage tags: Metrics without Limits™를 사용해 네임스페이스와 일치하는 여러 커스텀 메트릭의 태그를 구성해요.
백분위수 활성화/비활성화: 여러 distribution 메트릭에 걸쳐 백분위수 집계를 관리합니다. 자세한 내용은 Distributions 페이지를 참고하세요.
과거 메트릭 수집 활성화/비활성화: 과거 메트릭 데이터의 수집을 관리합니다. 자세한 내용은 과거 메트릭 수집 페이지를 참고하세요.

메트릭 상세 사이드 패널 (Metric details sidepanel)

아무 메트릭 이름이나 클릭해 메트릭의 메타데이터와 태그에 대한 자세한 정보를 제공하는 상세 사이드 패널을 여세요.

메트릭 이름 (Metric name)

Metrics Explorer, 대시보드 등에서 쓰는 메트릭의 이름.

수집된 커스텀 메트릭 (Ingested custom metrics)

메트릭 이름은 연결된 태그 값 조합에 따라 여러 수집 커스텀 메트릭을 방출할 수 있어요. 수집 커스텀 메트릭은 코드로 원래 제출된 모든 데이터를 나타냅니다.

커스텀 메트릭 문서에서 더 알아보세요.

인덱스된 커스텀 메트릭 (Indexed custom metrics)

수집 커스텀 메트릭과 달리, 인덱스 커스텀 메트릭은 Datadog 플랫폼 전역에서 쿼리 가능하게 유지되는 것들을 나타내요. 이 숫자는 백분위수 집계를 추가·제거하거나 Metrics without Limits™를 사용함으로써 영향을 받을 수 있습니다. Metrics without Limits™ 문서에서 더 알아보세요.

호스트 (Hosts)

메트릭을 보고하는 호스트의 총 수.

태그 값 (Tag values)

메트릭에 붙은 고유 태그 값의 총 수.

태깅에 대해 더 알아보기.

메트릭 메타데이터 (Metrics metadata)

메트릭에 붙은 메타데이터. 대부분의 메타데이터는 메트릭 요약 페이지나 Datadog API에서 편집할 수 있어요.

메트릭 단위 (Metric unit)

메트릭의 단위(byte, second, request, query 등). 자세한 내용은 메트릭 단위 페이지를 참고하세요.

커스텀 메트릭을 Datadog에 제출할 때, 그래프에서 메트릭 위에 마우스를 올렸을 때 표시되는 측정 단위를 변경할 수 있어요.

참고: 이것은 메트릭 그래프가 표시되는 방식을 바꾸지 않아요. 메트릭 위에 마우스를 올렸을 때 원시 값이 간주되는 측정 단위만 바꿉니다. 가독성을 위해 서식이 자동 적용됩니다. 예를 들어 byte(B)는 kilobyte(KiB)로 표시될 수 있어요.

메트릭 유형 (Metric type)

메트릭의 유형(gauge, rate, count, distribution). 자세한 내용은 메트릭 유형 페이지를 참고하세요.

경고: 메트릭 유형을 편집하면 해당 메트릭의 동작이 모든 대시보드와 모니터에서 변경됩니다.

통합 이름 (Integration name)

메트릭이 지원되는 통합에서 오는 경우, 메타데이터는 통합 이름을 나열해요. 이 정보는 편집할 수 없습니다.

간격 (Interval)

초 단위의 메트릭 수집 간격.

메트릭 설명 (Metric description)

메트릭 설명은 메트릭이 무엇을 나타내고, 왜 존재하며, 일반적으로 어떻게 사용되는지 이해하는 데 도움을 줘요. 이 필드를 사용해 커스텀 메트릭의 설명을 보고 업데이트할 수 있습니다. 지원되는 통합에서 오는 메트릭에는 설명이 미리 채워져 있어요.

AI 생성 설명 (AI-generated description)

다음 Datadog 사이트를 사용하는 사용자를 위한 중요 안내: app.ddog-gov.com, us2.ddog-gov.com

알림 — 선택한 Datadog 사이트({% placeholder "user-datadog-site-name" /%})에서는 AI 생성 메트릭 설명을 사용할 수 없어요.

커스텀 메트릭의 경우 Datadog은 메트릭 이름, 의미 있는 태그, 쿼리 활동, 연결된 소스 코드 등 사용 가능한 맥락을 사용해 설명을 자동으로 생성할 수 있어요. 소스 코드를 추가 맥락으로 사용하려면 Datadog의 GitHub, GitLab, 또는 Azure DevOps 통합을 설치하고 레포지토리를 연결하세요.

소스 코드 (Source Code)

다음 Datadog 사이트를 사용하는 사용자를 위한 중요 안내: app.ddog-gov.com, us2.ddog-gov.com

알림 — 선택한 Datadog 사이트({% placeholder "user-datadog-site-name" /%})에서는 메트릭 소스 코드(Metric Source Code)를 사용할 수 없어요.

메트릭 사이드 패널의 Source Code 섹션은 모든 커스텀 메트릭과 그 기본 맥락의 중앙 집중식 뷰를 제공해요.

Source Code 섹션을 사용해 메트릭의 소스 코드를 식별하고, 어떻게 생성되는지 이해하며, 소유권을 결정하세요. 맥락과 소유권에 대한 가시성을 제공해, 메트릭의 소스 파일, 커밋 기록, blame 데이터에 직접 연결함으로써 더 빠른 트러블슈팅과 최적화를 돕습니다.

누락된 메트릭 트러블슈팅 (Troubleshooting missing metrics)

메트릭이 Source Code에 나타나지 않으면, 그 정의 방식 때문일 수 있어요.

Datadog은 이름이 명시적 문자열로 작성될 때 메트릭을 가장 잘 감지합니다. 변수, 상수, 또는 커스텀 헬퍼로 만들어진 메트릭은 감지되지 않을 수 있어요.

메트릭이 누락되는 일반적인 이유:

메트릭 이름이 동적으로 생성됨
메트릭이 커스텀 래퍼를 통해 방출됨
레포지토리가 완전히 인덱싱되지 않음

모범 사례:

가능하면 메트릭 이름을 명시적 문자열로 정의하기

예시:

변수를 사용해 메트릭 보내기(권장하지 않음)

public static final String METRIC_NAME = "my.metric.name";
statsEmitter.distribution(METRIC_NAME, value, tags);

메트릭을 명시적 문자열로 보내기(권장):

timer = meterRegistry.timer("my.metric.name");

메트릭 소스 코드의 전체 커버리지를 보장하려면 Datadog의 GitHub, GitLab, 또는 Azure DevOps 통합을 설치하고 모든 레포지토리가 연결되어 있는지 확인하세요.

태그 표 (Tags table)

태그 표는 메트릭 데이터에서 활발히 보고되는 모든 태그 키와 태그 값을 탐색하는 여러 방법을 제공해요.

태그 표를 사용해:

Count 열(고유 태그 값 수)로 태그 키를 정렬하세요.
페이지가 매겨진 태그 표에서 특정 태그 키를 검색하세요.
태그 표를 다운로드 가능한 CSV로 내보내세요.
메트릭에 구성한 태그와 원래 제출된 태그 사이를 전환하세요.

특정 태그 키에 대해 다음을 할 수 있어요.

해당 태그 키의 모든 태그 값을 검사하세요.
특정 태그 key:value를 사용해 Metrics Summary 페이지에 표시되는 메트릭 목록을 더 필터링하세요.
Metrics Explorer에서 태그 key:value 쌍으로 필터링된 이 메트릭의 그래프를 여세요.
앱 전체 필터링을 위해 태그 key:value를 복사하세요.

태깅에 대해 더 알아보기.

조직에 대한 어떤 메트릭 이름의 가치를 판단하려면 Metrics Related Assets을 사용하세요. 메트릭 관련 자산은 특정 메트릭을 쿼리하는 대시보드, 노트북, 모니터, 또는 SLO를 말해요.

메트릭 상세 사이드 패널의 맨 아래 Related Assets 섹션까지 스크롤하세요.
드롭다운 버튼을 클릭해 관심 있는 관련 자산 유형(대시보드, 모니터, 노트북, SLO)을 보세요. 검색창으로 특정 자산을 검증할 수도 있습니다.
Tags 열은 각 자산에서 정확히 어떤 태그가 사용되는지 보여 줘요.

커스텀 메트릭 태그 카디널리티 탐색기 (Custom Metrics Tags Cardinality Explorer)

특정 메트릭 이름이 왜 많은 수의 커스텀 메트릭을 방출하거나 급증(spiking)하는지 판단하려면 Custom Metrics Tags Cardinality Explorer를 사용하세요. 급증을 일으키는 태그 키를 정확히 찾아내는 데 도움을 주며, 비용 절감을 위해 Metrics without Limits™로 즉시 제외할 수 있습니다.

Metrics without Limits™

Metrics without Limits™는 에이전트나 코드 수준 변경 없이 커스텀 메트릭의 크기를 제어할 수 있게 해 줘요.

참고: Metrics without Limits™는 커스텀 메트릭에서만 사용할 수 있어요.

Metrics 페이지에서 Configure Metrics > Manage tags로 이동하거나, 메트릭 상세 사이드 패널의 Manage Tags 버튼을 클릭해 태그를 대량 구성할 수 있습니다.

Metrics Summary 표에서 커스텀 distribution 메트릭 이름을 클릭해 메트릭 상세 사이드 패널을 여세요.
Manage Tags 버튼을 클릭해 태그 구성 모달을 여세요.
Include tags… 또는 Exclude tags… 를 선택해 쿼리하고 싶은/싶지 않은 태그를 커스터마이즈하세요. 태그 구성에 대한 자세한 내용은 Metrics without Limits 문서를 참고하세요.
Save를 선택하기 전에 cardinality estimator로 제안된 태그 구성의 효과를 미리 보세요.

참고: cardinality estimator는 메트릭이 48시간보다 오래되어야 해요.

쿼리 가능한 태그 (Queryable tags)

메트릭을 Metrics without Limits™로 구성하면 어떤 태그가 Queryable로 유지되는지 — 궁극적으로 Indexed Custom Metrics 볼륨에 기여하는 태그 — 볼 수 있어요. 그리고 Ingested Custom Metrics 볼륨에 기여하는 원래 제출·수집된 모든 태그로 다시 전환할 수도 있습니다.

메트릭 오리진 정의 (Metric origin definitions)

이 표는 패싯에 보이는 메트릭 오리진과 메트릭이 제출된 위치 사이의 매핑을 보여 줍니다.

메트릭 오리진	제출 위치
API Catalog	Datadog Catalog 제품이 APIM Endpoint에서 보내는 타임시리즈.
APM	Datadog APM 제품이 트레이스와 스팬 메트릭에서 생성된 메트릭용으로 보내는 타임시리즈.
Agent	Datadog 에이전트가 Agent 통합, 내장 통합, DogStatsD, 또는 커스텀 에이전트 체크에서 수집해 보내는 타임시리즈.
Cloud Security	Datadog Cloud Security 제품이 보내는 타임시리즈.
Cloud Integrations	AWS, Azure, Google Cloud 등 클라우드 공급자의 각각의 통합에서 수집된 타임시리즈.
DBM	Datadog Database Monitoring 제품이 보내는 타임시리즈. MySQL, Oracle, Postgres 활동/쿼리/락에 대한 인사이트를 포함.
DSM	Datadog Data Streams Monitoring 제품이 DSM 스팬과 트레이스에서 생성된 메트릭용으로 보내는 타임시리즈.
Datadog Exporter	OpenTelemetry Collector 또는 Datadog Exporter가 보내는 타임시리즈.
Datadog Platform	메트릭 사용량 보고에 사용되는 메트릭 수집이 보내는 타임시리즈.
Events	Datadog Events 플랫폼에서 생성된 타임시리즈.
Agent Observability	Agent Observability 제품이 `lmobs_to_metrics` 서비스를 사용해 방출하는 타임시리즈.
Logs	Datadog Logs 플랫폼에서 생성된 타임시리즈.
Metrics API	Datadog의 OTLP 수집 엔드포인트와 OTel receiver, Datadog 통합 대응 메트릭이나 추정 사용량 메트릭용 포인트, 또는 Datadog API 클라이언트를 사용해 보내는 타임시리즈.
CNM	Datadog Cloud Network Monitoring 제품이 보내는 타임시리즈.
Observability Pipelines	Datadog Observability Pipelines가 오류·성능 메트릭을 포함해 보내는 타임시리즈.
Other	DD 통합 대응 메트릭이 없는 타임시리즈.
Processes	Datadog Processes 제품에서 생성된 타임시리즈.
RUM	Datadog Real User Monitoring 제품에서 생성된 타임시리즈.
SAAS Integrations	Slack, Docker, PagerDuty 등 인기 SAAS 플랫폼에서 수집된 타임시리즈.
Serverless	Datadog Serverless 플랫폼이 Function, App Services, Cloud Run, Container App 메트릭을 포함해 보내는 타임시리즈.
Catalog	Datadog Catalog 제품이 Scorecard 메트릭을 포함해 보내는 타임시리즈.
Synthetic Monitoring	Datadog Synthetic Monitoring 제품에서 생성된 신디틱 모니터링·연속 테스트 메트릭.
USM	Datadog Universal Service Monitoring 제품에서 생성된 타임시리즈.

메트릭 요약