본문 바로가기
WIKI 기술 지식 베이스

커스텀 메트릭

원문 보기 위키 갱신

커스텀 메트릭(Custom Metrics)은 애플리케이션의 핵심 지표(KPI)를 추적하기 위해 직접 정의해서 보내는 메트릭이에요. 방문자 수, 평균 장바구니 금액, 요청 지연 시간, 커스텀 알고리즘의 성능 분포 등을 측정할 때 활용할 수 있죠. 이 문서에서는 커스텀 메트릭이 무엇인지, 명명 규칙과 속성, 그리고 제출 방법을 함께 살펴봐요.

출처: 문서

본문

{% callout %}

Join an enablement webinar session

커스텀 메트릭에 대한 Foundation Enablement 세션을 살펴보고 등록해 보세요. 커스텀 메트릭이 방문자 수, 평균 고객 장바구니 크기, 요청 지연 시간, 커스텀 알고리즘의 성능 분포 같은 애플리케이션 KPI를 추적하는 데 어떻게 도움이 되는지 배울 수 있어요.

SIGN UP {% /callout %}

개요

커스텀 메트릭은 애플리케이션 KPI를 추적하는 데 도움을 줘요. 방문자 수, 평균 고객 장바구니 크기, 요청 지연 시간, 커스텀 알고리즘의 성능 분포 같은 것들이죠. 커스텀 메트릭은 메트릭 이름과 태그 값(호스트 태그 포함)의 고유한 조합으로 식별돼요. 아래 예시에서 request.Latency 메트릭은 두 개의 태그 키에서 만들어진 4개의 고유한 태그 값 조합을 가져요.

  • endpoint: 값이 endpoint:X 또는 endpoint:Y
  • status: 값이 status:200 또는 status:400

{% image source="https://docs.dd-static.net/images/account_management/billing/custom_metrics/request_latency.0865373a0589c45484d2dae579a515d9.png?auto=format&fit=max&w=850 1x, https://docs.dd-static.net/images/account_management/billing/custom_metrics/request_latency.0865373a0589c45484d2dae579a515d9.png?auto=format&fit=max&w=850&dpr=2 2x" alt="Request latency" /%}

다음의 경우도 커스텀 메트릭으로 간주돼요.

참고: Datadog Admin 역할 또는 usage_read 권한을 가진 사용자는 usage details 페이지에서 계정의 시간당 월평균 커스텀 메트릭 수와 상위 5,000개의 커스텀 메트릭을 볼 수 있어요. 커스텀 메트릭이 어떻게 집계되는지 자세히 알아보세요.

커스텀 메트릭 속성

Datadog 커스텀 메트릭은 아래와 같은 속성을 가져요. Datadog에서 메트릭을 그래프로 표현하는 방법은 메트릭 소개 문서를 읽어보세요.

속성 설명
<METRIC_NAME> 메트릭의 이름이에요.
<METRIC_VALUE> 메트릭의 값이에요. 참고: 메트릭 값은 32비트여야 해요. 값이 날짜나 타임스탬프를 나타내면 안 됩니다.
<TIMESTAMP> 메트릭 값과 연관된 타임스탬프예요. 참고: 메트릭 타임스탬프는 미래로 10분, 과거로 1시간을 초과할 수 없어요.
<TAGS> 메트릭과 연관된 태그 집합이에요.
<METRIC_TYPE> 메트릭의 타입이에요. 메트릭 타입에 대해 읽어보세요.
<INTERVAL> 메트릭의 <TYPE>이 RATE 또는 COUNT인 경우, 해당하는 간격(interval)을 정의해요.

커스텀 메트릭 명명 규칙

다음 커스텀 메트릭 명명 규칙을 따라야 해요.

  • 메트릭 이름은 반드시 문자(letter)로 시작해야 해요.
  • 메트릭 이름은 ASCII 영숫자, 밑줄, 마침표만 포함할 수 있어요.
    • 공백을 포함한 다른 문자는 밑줄로 변환돼요.
    • 유니코드(Unicode)는 지원되지 않아요.
  • 메트릭 이름은 200자를 넘을 수 없어요. UI 관점에서는 100자 미만을 권장해요.

참고: 메트릭 이름은 Datadog에서 대소문자를 구분해요.

메트릭 단위

Metrics Summary를 통해 메트릭 단위를 설정하거나, 시각화의 그래프 편집기에 있는 Unit override 기능으로 커스텀 메트릭 단위를 설정할 수 있어요. 자세한 내용은 Metrics Units 문서를 참고해 주세요.

커스텀 메트릭 제출

Datadog에 메트릭을 보내는 방법은 여러 가지가 있어요.

또한 Datadog 공식 및 커뮤니티 기여 API/DogStatsD 클라이언트 라이브러리 중 하나를 사용해 커스텀 메트릭을 제출할 수도 있어요.

참고: 커스텀 메트릭 제출에는 강제된 고정 속도 제한이 없어요. 기본 할당량을 초과하면 Datadog 커스텀 메트릭 과금 정책에 따라 과금됩니다.

표준 통합

다음 표준 통합은 커스텀 메트릭을 생성할 수 있어요.

통합 유형 통합
기본적으로 350개의 커스텀 메트릭으로 제한 ActiveMQ XML / Go-Expvar / Java-JMX
커스텀 메트릭 수집에 기본 제한 없음 Nagios / PDH Check / OpenMetrics / Windows performance counters / WMI / Prometheus
커스텀 메트릭을 수집하도록 구성 가능 MySQL / Oracle / Postgres / SQL Server
클라우드 통합에서 전송되는 커스텀 메트릭 AWS

더 알아보기 (Learn more)

추가로 도움이 되는 문서, 링크, 글: