메트릭 관리¶
지표 데이터 수집을 완료한 후 메트릭 관리에서 모든上报된 메저먼트와 이에 연결된 메트릭, 태그, 시계열 수량 통계, 전일 대비 변화 및 데이터 저장 정책을 확인할 수 있습니다.
메저먼트¶
메저먼트는 동일한 유형의 메트릭 모음으로, 여러 개의 메트릭과 태그를 포함합니다. 시스템에 표시되는 개별 메저먼트에는 다음 정보가 포함됩니다.
메트릭¶
메트릭은 시스템 실행 상태(예: CPU 사용률, 페이지 로드 시간 등)를 반영하며, 메트릭 이름(식별자)과 메트릭 값(구체적인 숫자)으로 구성됩니다.
메저먼트 이름을 클릭하면 전체 메트릭 상세 정보(메트릭 이름, 원본 메트릭, 필드 유형, 단위, 설명)를 확인할 수 있으며, 다음 작업을 지원합니다.
- 검색창에서 키워드를 기반으로 메트릭 필터링
- 메트릭 목록을 CSV 파일로 내보내기
- 작업 열에서 원클릭 메트릭 분석 지원
- 메트릭 데이터를 펼쳐서 메트릭 구성을 편집 가능
권한 및 우선순위
- 편집 권한: 표준 멤버 이상의 역할만 작업 가능
- 구성 우선순위: 메트릭 관리에서 사용자 정의한 단위 및 설명의 우선순위는 기본 수집 데이터보다 높습니다. 예를 들어, 단위를
B에서GB로 변경하면 시나리오의 차트 조회 시 자동으로GB단위로 데이터가 표시됩니다.
태그¶
데이터 포인트 수집 대상의 속성은 태그를 통해 식별됩니다. 이러한 태그는 키-값 쌍 형태로 제공되며, 태그 이름과 태그 값으로 구성됩니다. 하나의 데이터 포인트에는 여러 개의 태그가 포함될 수 있습니다.
메저먼트 이름을 클릭하면 해당 태그 목록을 확인할 수 있습니다. 태그 이름, 태그 값 통계 수량, 설명 등의 정보가 포함되며, 다음 작업을 지원합니다.
- 검색창에서 키워드를 기반으로 태그 필터링
- 태그 목록을 CSV 파일로 내보내기
시계열¶
시계열은 태그 조합에 의해 동적으로 생성되며, 메트릭, 태그(필드) 및 데이터 저장 기간을 포함합니다. 여기서 "메트릭 + 태그(필드 조합)"은 데이터 저장 기본 키를 구성합니다.
Guance에서는 현재 메저먼트의 전체 시계열 수를 표시하며, 메트릭 통계 차트 및 태그 통계 차트를 통해 개별 메트릭/태그의 고유 값 수, 시계열 수 및 전일 대비 변화를 보여줍니다.
계산 로직¶
메트릭/태그 통계 차트는 전체 메트릭 → 개별 메트릭 → 해당 메트릭의 태그별 그룹화 → 특정 태그의 구체적인 값 → 모든 태그의 글로벌 뷰 + 태그 자체 통계 계층에 따라 통계가 계산됩니다.
통계 차트에서 각 필드의 계산 로직은 다음과 같습니다.
| 필드 | 설명 |
|---|---|
| 고유 값 수 | 글로벌 또는 개별 메트릭 차원에서 태그의 중복 제거 개수를 집계합니다(즉, 해당 태그에 포함된 중복되지 않은 고유 값의 수) |
| 시계열 수 | 개별 메트릭/개별 태그 값과 관련된 시계열 수 |
| 1d | 전일 대비 시계열 수 변화량 |
| 1d% | 1d / 전일 시계열 수 |
| 전체 비율 |
| 용어 | 설명 |
|---|---|
| Database | 데이터를 저장하는 데이터베이스 컨테이너 |
| Measurement | 메저먼트(MySQL 테이블과 유사) |
| Field | 메트릭 키-값 쌍(실제 숫자 값을 저장하며 인덱싱되지 않음) |
| Field Set | 여러 Field의 집합 |
| Field Key | Field의 키 이름(예: cpu_usage) |
| Field Value | Field의 숫자 값(예: 85.3) |
| Tag | 태그 키-값 쌍(설명적 메타데이터이며 인덱싱됨) |
| Tag Set | 여러 Tag의 집합 |
| Tag Key | Tag의 키 이름(예: host) |
| Tag Value | Tag의 값(예: server-01) |
| TimeStamp | 데이터 포인트 타임스탬프(나노초 정밀도) |
| Retention Policy | 데이터 보존 기간(예: 30일) |
| Series | 고유 시계열(Measurement + Tag Set 조합) |
저장 정책¶
저장 정책은 두 가지 수준으로 나뉩니다.
정책 수정¶
메저먼트 사용자 정의 설정의 우선순위는 워크스페이스 전역 설정보다 높습니다. 즉, 특정 메저먼트에 대해 저장 정책을 사용자 정의한 후 전역 설정을 수정해도 해당 메저먼트에는 영향을 미치지 않습니다.
참고
정책을 수정할 때마다 즉시 데이터가 삭제되므로 중요한 데이터는 미리 백업하시기 바랍니다.
주의사항¶
메저먼트 저장 정책을 수정할 때는 다음 주요 규칙을 주의해야 합니다.
- 데이터 즉시 삭제: 정책을 수정하면 기존 정책 하의 해당 메저먼트 데이터가 영구적으로 삭제되며 복구할 수 없습니다. 이후 정책을 다시 수정하면 현재 정책의 데이터도 동일하게 삭제됩니다.
- 독립 저장 메커니즘: 정책을 사용자 정의하면 메저먼트 데이터가 독립적으로 저장됩니다. 이때 전역 정책 기간을 수정해도 이미 사용자 정의된 메저먼트에는 영향을 미치지 않습니다.
- 전역 정책 복원: "전역 기본값"으로 다시 변경하면 데이터가 전역 저장소에 다시 저장됩니다. 이후 전역 정책을 수정하면 해당 메저먼트에도 동기적으로 영향을 미칩니다.
- 기간이 같다고 정책이 동일하지는 않음: 사용자 정의 기간이 전역 기간과 동일하더라도 데이터는 여전히 독립적으로 저장됩니다. 예: 전역 7일인 상태에서 특정 메저먼트를 7일로 설정해도 독립 저장에 해당합니다.
수정 경로¶
전역 설정¶
관리 > 워크스페이스 설정 > 위험한 작업 > 데이터 저장 정책 변경 > 메트릭으로 이동하여 저장 기간을 선택합니다.
메저먼트 사용자 정의 설정¶
메트릭 > 메트릭 관리로 이동하여 개별 메저먼트 오른쪽 작업 열에서 아이콘을 클릭하면 기간을 선택할 수 있습니다. 설정하지 않으면 자동으로 전역 정책을 상속합니다.
중요 제한 사항 설명
- 권한 제어: 워크스페이스 소유자만 구성 가능
- 데이터 위험: 정책 수정으로 인해 기존 정책의 데이터가 즉시 영구 삭제됨


