콘텐츠로 이동

메트릭 생성


Guance는 현재 워크스페이스의 기존 데이터를 기반으로 새로운 메트릭 데이터를 생성할 수 있도록 지원하여, 필요에 따라 새로운 기술 지표를 설계하고 구현할 수 있습니다.

Warning
  • 메트릭 생성 구성 관리 작업 권한이 있는 역할은 메트릭 생성을 생성/편집할 수 있습니다.
  • 메트릭이 생성되면 현재 기본 데이터 저장 정책에 따라 메트릭 데이터가 저장되며, 생성된 시계열 수에 따라 요금이 부과됩니다.
  • 메트릭이 생성된 후 데이터가 보고되지 않으면 워크스페이스에서 조회 및 분석할 수 없습니다. 예를 들어 메트릭 분석, 차트, 쿼리 도구에서 메트릭 데이터를 조회할 수 없습니다.

새 규칙 생성/복제

로그 > 메트릭 생성 페이지로 이동하여,

  • 새 규칙 생성 버튼을 클릭하여 새 메트릭 생성 규칙을 만들 수 있습니다.
  • 아이콘을 클릭하여 기존 규칙을 복제하여 새 규칙을 만들 수 있습니다.

Step 1: 데이터 소스: 현재 워크스페이스의 모든 인덱스 데이터를 필터링합니다.

Step 2: 데이터 쿼리: 선택한 인덱스 데이터를 기반으로 현재 워크스페이스의 모든/개별 로그 데이터 소스를 필터링하여 새 데이터를 생성할 수 있습니다. 기존 데이터에 필터 및 집계 표현식을 추가하여 새 메트릭 결과 및 데이터 집합을 생성합니다.

  • 로그 소스: 수집이 활성화된 로그 데이터 소스입니다.

    • 참고: “ * ”는 모든 데이터 소스를 의미합니다.
  • 검색: 키워드를 통해 로그 데이터를 필터링할 수 있습니다.

  • 필터: 기존 태그 데이터에 하나/여러 개의 필터 조건을 추가하고, 동일한 행의 필터 조건에 “그리고”(AND), “또는”(OR) 관계를 추가할 수 있습니다.

  • 집계 방법: 아래 표를 참조하세요.

집계 방법 설명
count 개수 통계
avg 평균값 통계, 집계할 필드를 선택해야 함
max 최대값 통계, 집계할 필드를 선택해야 함
min 최소값 통계, 집계할 필드를 선택해야 함
P75 지정된 필드의 75% 값을 통계, 집계할 필드를 선택해야 함
P95 지정된 필드의 95% 값을 통계, 집계할 필드를 선택해야 함
P99 지정된 필드의 99% 값을 통계, 집계할 필드를 선택해야 함
  • 차원: 선택한 객체를 기준으로 데이터를 집계합니다. 즉, 데이터 요청의 각 선택된 객체에 대해 통계값을 생성합니다.

Step 3: 메트릭 생성: 메트릭 생성 방식과 결과를 설정합니다. 여기에는 메트릭 생성 주기, 새로 생성된 메트릭의 태그 이름 및 메저먼트 이름이 포함됩니다.

필드 설명
빈도 메트릭 생성 실행 주기, 기본 1분, 즉 1분마다 새 메트릭 데이터가 생성됩니다.
5분, 15분 선택 가능.
선택한 빈도 시간은 집계 시간으로도 사용됩니다. 빈도를 1분으로 선택하면 1분마다 집계되어 메트릭이 생성되며, 각 집계 시간 범위도 1분입니다.
❗️ 데이터가 1분 이상 지연되는 경우, 해당 데이터는 저장 후 통계되지 않습니다.
시간 범위 선택한 빈도를 시간 간격으로 하여, 차트 기본 조회는 6시간입니다. 즉, 6시간 내의 특정 데이터 통계 표시 효과입니다. 빈도 >= 1시간으로 수정하면 조회 시간 범위는 7일로 고정됩니다.
메저먼트 메트릭이 저장될 메저먼트의 이름을 설정합니다.
메트릭 메트릭의 이름을 설정합니다. 메트릭 이름은 중복될 수 없으며, 여러 메트릭을 추가할 수 있습니다.
태그 쿼리에서 선택한 차원을 기반으로 자동 생성됩니다.
단위 선택 사항입니다. 메트릭의 단위를 설정합니다. 생성된 메트릭에 단위를 설정하면 차트 쿼리에서 적용할 수 있습니다.
설명 선택 사항입니다. 메트릭의 설명을 설정합니다. 생성된 메트릭에 설명을 설정하면 차트 쿼리에서 적용할 수 있습니다.

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

작업 설명

추가된 모든 규칙은 메트릭 생성 인터페이스에 표시됩니다. 사용자는 다음 작업을 수행할 수 있습니다.

규칙 편집

메트릭 생성 페이지에서 생성된 모든 메트릭 생성 규칙을 확인하고 편집할 수 있습니다.

참고: 메트릭 생성 규칙의 데이터 소스, 집계 표현식 등이 데이터 유형을 결정하므로 일부 규칙은 편집 및 수정을 지원하지 않습니다.

규칙 활성화/비활성화

메트릭 생성 페이지에서 규칙 상태를 수정할 수 있습니다. 메트릭 생성 규칙이 비활성화되면 해당 데이터가 메저먼트에 기록되지 않으며, 활성화 후 다시 기록됩니다.

규칙 삭제

메트릭 생성 페이지에서 불필요한 규칙을 삭제할 수 있습니다. 규칙이 삭제되어도 메저먼트는 삭제되지 않지만 데이터 쓰기는 중단됩니다.

일괄 작업

특정 규칙에 대해 일괄 작업(활성화, 비활성화, 삭제)을 수행할 수 있습니다.

메트릭 보기

메트릭 분석에서 보기

메트릭 생성 페이지에서 규칙 오른쪽의 메트릭 분석에서 열기 버튼을 클릭하면 메트릭 분석 페이지로 이동하여 조회 및 분석할 수 있습니다.

참고: 생성된 메트릭은 선택한 빈도에 따라 쿼리 시간 범위 내의 데이터를 집계하여 생성됩니다. 이 기간 동안 데이터가 보고되지 않으면 메트릭을 생성할 수 없으며, 메트릭에서 조회하거나 검색할 수 없습니다.

메트릭 관리에서 보기

메트릭 생성 페이지에서 규칙 오른쪽의 메트릭 관리에서 열기 버튼을 클릭하면 메트릭 관리 페이지로 이동하여 메트릭과 태그를 확인할 수 있습니다. 메트릭 단위와 설명을 편집할 수 있습니다.

추가 사용 사례

차트 쿼리에서 적용

메트릭이 생성된 후 시나리오 > 대시보드 > 새 대시보드에서 시각화 차트에서 메트릭 데이터를 조회하고 분석할 수 있습니다.

DQL 쿼리 도구에서 적용

메트릭이 생성된 후 바로가기 > 쿼리 도구 > DQL 쿼리에서 메트릭 데이터를 조회하고 분석할 수 있습니다.

문서 평가

이 페이지가 도움이 되었나요?