사용자 지정 메트릭 탐색

사용자 지정 메트릭 탐색 (Exploring Custom Metrics)

출처: 문서

본문

사용자 지정 메트릭(Custom Metrics) 섹션은 데이터베이스 인스턴스 세부 정보 페이지에 나타나며, Datadog 에이전트 구성에서 정의한 사용자 지정 쿼리에 대한 시계열 그래프를 표시해요.

개요 (Overview)

Datadog 에이전트의 데이터베이스 통합에서 custom_queries를 구성했다면, 이 섹션은 해당 쿼리를 자동으로 발견해서 각 메트릭 열을 시계열 그래프로 시각화해요. 이렇게 하면 표준 데이터베이스 모니터링 메트릭과 함께 비즈니스별 또는 환경별 데이터베이스 메트릭을 한 곳에서 모니터링할 수 있어요.

작동 방식 (How it works)

1. 에이전트 구성에서 사용자 지정 쿼리를 정의해요. 각 쿼리는 다음을 지정해요.

• SQL 문
• 하나 이상의 메트릭 열(gauge, count, rate 같은 타입)
• 선택적 태그 열
• 선택적 메트릭 접두사
• 선택적 수집 간격

에이전트는 구성된 간격(기본값: 15초마다)으로 SQL 쿼리를 실행해서 메트릭을 수집하고, 그 결과를 Datadog 메트릭으로 내보내요. 사용자 지정 메트릭 섹션은 사용자 지정 쿼리의 각 메트릭 열에 대해 현재 데이터베이스 인스턴스 범위로 한정된 그래프를 표시해요. 메트릭 이름은 <prefix>.<column_name> 형식이에요 (예: postgresql.my_table_row_count).

예시 에이전트 구성 (Example Agent configuration)

다음 PostgreSQL 예시는 테이블 크기와 테이블별 행 수를 추적해요.

init_config:

instances:
  - dbm: true
    host: localhost
    port: 5432
    username: datadog
    password: <PASSWORD>
    custom_queries:
      - metric_prefix: postgresql.custom
        query: |
          SELECT
            table_name,
            pg_total_relation_size(quote_ident(table_name)) AS total_bytes,
            n_live_tup                                       AS live_rows,
            n_dead_tup                                       AS dead_rows
          FROM information_schema.tables
          JOIN pg_stat_user_tables USING (table_name)
          WHERE table_schema = 'public'
        columns:
          - name: table_name
            type: tag
          - name: total_bytes
            type: gauge
          - name: live_rows
            type: gauge
          - name: dead_rows
            type: gauge
        collection_interval: 60
        tags:
          - env:production
          - service:my-app

이 구성은 각각 table_name별로 나뉘어진 세 개의 메트릭을 생성해요.

• postgresql.custom.total_bytes
• postgresql.custom.live_rows
• postgresql.custom.dead_rows

세 메트릭 모두 인스턴스 세부 정보 페이지의 사용자 지정 메트릭 섹션에 별도의 시계열 그래프로 나타나요.

열 타입 (Column types)

사용자 지정 쿼리의 각 열에는 메트릭이 집계되고 표시되는 방식을 제어하는 타입이 할당돼요.

count 및 monotonic_count 열은 sum으로 집계돼요. 다른 모든 메트릭 타입은 avg로 집계돼요.

소스 SQL 보기 (Viewing the source SQL)

각 그래프의 오른쪽 위 모서리에는 SQL 쿼리 보기(View SQL) 버튼이 있어요. 이를 클릭하면 메트릭을 생성하는 원시 SQL 문이 표시되어, 무엇이 측정되고 있는지 이해하고 감사(audit)할 수 있어요.

수집 간격 (Collection interval)

섹션 부제목에는 메트릭이 수집되는 빈도가 표시돼요 (예: "collected every 15s"). 간격이 다른 사용자 지정 쿼리가 여러 개 있는 경우 범위가 표시돼요 (예: "collected every 15s–60s").

요구 사항 (Requirements)

사용자 지정 쿼리는 데이터베이스 통합 구성의 custom_queries 키 아래에 정의해야 해요. 사용자 지정 쿼리가 구성되지 않은 경우 사용자 지정 메트릭 섹션은 숨겨져요.

더 알아보기 (Learn more)

• 데이터베이스 모니터링으로 사용자 지정 메트릭 수집 (Collecting Custom Metrics with Database Monitoring)
• 데이터베이스 모니터링 (Database Monitoring)