메트릭 생성¶

메트릭 > 메트릭 생성 페이지에서 현재 워크스페이스 내의 기존 데이터로 새로운 메트릭을 생성하거나, 쿼리 가속화 목록에서 대시보드에 등록된 보장형 스트리밍 집계와 그 출처를 확인할 수 있습니다.

사용 전 필수 정보¶

1. 메트릭 생성 탭에서는 "메트릭 생성 설정 관리 권한"이 있는 역할만 메트릭을 생성하고 편집할 수 있습니다.

2. 메트릭이 생성되면 현재 기본 데이터 저장 정책에 따라 저장되며, 생성된 시계열 수에 따라 요금이 부과됩니다.

3. 메트릭 생성 후 데이터가 보고되지 않으면 워크스페이스에서 조회 및 분석할 수 없습니다.

어떤 문제를 해결할 수 있나요?¶

사용 사례 1: 로그에서 비즈니스 메트릭 추출

비즈니스 로그에는 주문 금액, 오류 코드와 같은 중요한 비즈니스 데이터가 포함되어 있으며, 이를 모니터링 가능한 메트릭으로 변환해야 합니다. 메트릭 생성을 통해 로그 데이터 소스를 선택하고, 쿼리 조건을 구성하여 대상 로그를 필터링한 후, 필드를 추출하여 메트릭(예: 오류 로그 수, 평균 응답 시간)을 생성하고, 비즈니스 차원(예: 서비스, 엔드포인트, 상태 코드)별로 그룹화할 수 있습니다.

사용 사례 2: APM 데이터 집계

APM(애플리케이션 성능 모니터링) 추적 데이터를 기반으로 서비스 SLA 메트릭을 생성합니다. APM 데이터 소스를 선택하고, 서비스 및 엔드포인트별로 그룹화하여 통계를 내고, P99 지연 시간, 오류율, 처리량 등의 메트릭을 계산하여 정기적으로 생성하고 지속적으로 모니터링합니다.

사용 사례 3: 리소스 사용량 통계

Kubernetes 클러스터의 리소스 사용 현황을 통계합니다. 기본 객체 또는 리소스 카탈로그 데이터 소스를 선택하고, 클러스터, 네임스페이스, 노드별로 그룹화하여 Pod 수, 리소스 요청/제한 등을 통계하고 리소스 사용률 메트릭을 생성합니다.

사용 사례 4: 다중 소스 데이터 융합

여러 데이터 소스를 결합하여 복합 메트릭을 생성합니다. 각각 생성 규칙을 만들고, 생성된 메트릭을 기반으로 다시 새로운 메트릭을 생성하여 복잡한 비즈니스 모니터링 시스템을 구축합니다.

적용 범위¶

로그, APM(애플리케이션 성능 모니터링), RUM(실제 사용자 모니터링), 메트릭, 신서틱 모니터링, 기본 객체, 리소스 카탈로그.

생성¶

1. 데이터 소스 선택;
2. 데이터 쿼리 조건 구성;
3. 메트릭 생성 내용 정의 – 메트릭 생성 방식과 결과를 설정합니다. 여기에는 메트릭 생성 주기, 새로 생성된 메트릭의 태그 이름 및 메저먼트 이름이 포함됩니다.

데이터 쿼리¶

메트릭 데이터는 PromQL 쿼리를 추가로 지원합니다. 이 외에도 다른 데이터 유형은 모두 간단 쿼리와 DQL 쿼리를 지원합니다.

자세한 내용은 차트 쿼리를 참조하세요.

집계 함수¶

차원¶

선택한 객체별로 데이터를 집계합니다. 즉, 데이터 요청의 각 선택된 객체에 대해 통계값을 생성합니다.

메트릭 생성 내용¶

1. 빈도: 메트릭 생성 실행 주기입니다. 빈도로 선택한 시간이 집계 시간으로도 사용됩니다. 빈도를 1분으로 선택하면 1분마다 집계하여 메트릭을 생성하며, 각 집계 시간 범위도 1분입니다.

   • 1분(기본값, 즉 1분마다 새 메트릭 데이터 생성)
   • 5분(데이터 유형이 "기본 객체" 또는 "리소스 카탈로그"인 경우 기본 선택됨)

2. 데이터 대기 창을 선택하여 작업 창 종료 후 계산 작업의 대기 시간을 지정합니다.

3. 메저먼트: 메트릭이 저장될 메저먼트의 이름을 설정합니다.

4. 메트릭: 메트릭 이름을 설정합니다. 메트릭 이름은 중복이 허용되며, 여러 메트릭을 추가할 수 있습니다.

5. 태그: 쿼리에서 선택한 차원에 따라 자동 생성됩니다.

6. 단위: 선택 사항입니다. 메트릭의 단위를 설정합니다. 생성된 메트릭에 단위를 설정하면 차트 쿼리에서 적용할 수 있습니다.

7. 설명: 선택 사항입니다. 메트릭에 대한 설명을 설정합니다. 생성된 메트릭에 설명을 설정하면 차트 쿼리에서 적용할 수 있습니다.

작성을 완료한 후 확인을 클릭하면 메트릭 생성 규칙이 완료되고 데이터 수집이 시작됩니다.

데이터 대기 창¶

작업 창이 종료된 후 시스템이 데이터 도착을 계속 기다리는 시간입니다. 활성화하면 데이터 보고 지연을 수용하여 메트릭 정확도를 높일 수 있습니다.

메트릭 생성 시 시스템은 설정한 빈도(예: 1분)에 따라 정기적으로 쿼리를 실행합니다. 각 쿼리는 고정된 시간 범위(즉, "작업 창")를 검색합니다. 그러나 데이터가 생성되어 보고되고入库될 때까지 지연이 발생하여 일부 데이터가 작업 창이 끝난 후에 도착할 수 있으며, 이러한 "지연" 데이터는 통계에서 누락될 수 있습니다.

데이터 대기 창을 활성화하면 시스템이 작업 창이 종료된 후 일정 시간 동안 기다리므로 지연 보고된 데이터가 통계에 포함될 기회를 얻어 메트릭 정확도가 향상됩니다.

1. 다음 시나리오에서는 데이터 대기 창을 활성화하는 것이 좋습니다.

2. 계산 로직 예시(빈도 1분, 데이터 대기 창 1분):

작업 실행 시간: 13:01:00
작업 창(실제 쿼리할 time 범위): 13:00:00 ~ 13:01:00
데이터 대기 창: 1분
실제 쿼리 실행 시간: 13:02:00(1분 대기 후)

즉, 시스템은 13:02:00에 쿼리를 실행하여 time이 13:00:00 ~ 13:01:00인 데이터를 검색합니다. 이때 일부 데이터가 13:01:00 이후에入库되더라도 time이 13:00:00 ~ 13:01:00에 속하면 통계에 포함될 수 있습니다.

관리 목록¶

• 편집: 생성된 모든 메트릭 생성 규칙을 확인하고 편집할 수 있습니다.

• 활성화/비활성화: 규칙의 상태를 수정합니다. 메트릭 생성 규칙이 비활성화되면 해당 데이터가 메저먼트에 기록되지 않으며, 활성화 후에 기록이 재개됩니다.

• 삭제: 불필요한 규칙을 삭제합니다. 규칙이 삭제되어도 메저먼트는 삭제되지 않지만 데이터 기록은 중단됩니다.

• 일괄 작업: 특정 규칙에 대해 활성화, 비활성화, 삭제 및 규칙 내보내기 등 일괄 작업을 수행할 수 있습니다.

• 가져오기: 메트릭 생성 데이터를 가져옵니다.

• 메트릭 보기

  • 메트릭 분석에서 보기: 메트릭 분석 페이지로 이동하여 조회 및 분석합니다.

  • 메트릭 관리에서 보기: 메트릭 관리 페이지로 이동하여 메트릭과 태그를 확인하고, 메트릭 단위와 설명을 편집할 수 있습니다.

쿼리 가속화 목록¶

메트릭 > 메트릭 생성 > 쿼리 가속화 목록으로 이동하면 대시보드 쿼리에서 보장 가속화를 활성화한 후 등록된 스트리밍 집계와 그 출처를 확인할 수 있습니다.

목록은 실제 등록된 스트리밍 집계를 기준으로 중복 제거됩니다. 쿼리에 변수가 포함된 경우 변수가 해석된 실제 쿼리를 표시합니다. 동일한 스트리밍 집계에 여러 출처가 있는 경우 해당 대시보드와 차트가 함께 표시됩니다.

보장 가속화를 활성화하거나 비활성화하는 방법은 보장형 스트리밍 집계 가속화를 참조하세요.

목록에는 스트리밍 집계, 출처, 등록 시간 및 최근 적중 시간이 표시되며, 쿼리문, 대시보드 또는 차트별로 검색 및 필터링할 수 있습니다.

출처 상세 정보 보기¶

목록에서 스트리밍 집계를 클릭하면 오른쪽 상세 정보에서 다음을 확인할 수 있습니다.

• 전체 스트리밍 집계 쿼리문 및 등록 정보
• 출처 대시보드, 차트 및 쿼리 템플릿
• 쿼리에 변수가 포함된 경우 해당 변수 값

대시보드 이름을 클릭하면 해당 대시보드로 이동할 수 있으며, 보기 및 이동 권한은 해당 대시보드의 권한 설정을 따릅니다.

보장 가속화 중지¶

보장 가속화는 출처 대시보드에서 제어되며, 쿼리 가속화 목록에서 직접 중지할 수 없습니다. 보장 가속화 중지를 클릭하면 안내에 따라 출처 대시보드로 이동하여 해당 옵션을 끕니다. 여러 출처가 있는 경우 모든 출처 대시보드에서 꺼야 합니다. 모든 출처에서 끄면 해당 레코드가 자동으로 제거됩니다.

사용 사례¶

차트 쿼리¶

시각화 차트에서 메트릭 데이터를 조회하고 분석합니다.

쿼리 도구¶

바로가기 > 쿼리 도구 > DQL 쿼리에서 메트릭 데이터를 조회하고 분석합니다.