메트릭 생성¶
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 쿼리에서 메트릭 데이터를 조회하고 분석할 수 있습니다.





