본문으로 건너뛰기

OpenMetrics 탐색기

OpenMetrics 탐색기는 OpenAgent가 수집한 메트릭을 화면에서 직접 조회하고 분석할 수 있는 도구입니다. PromQL 형식의 쿼리를 입력해 차트와 원시 데이터를 바로 확인할 수 있습니다.

탐색기 진입​

프로젝트 메뉴의 OpenMetrics > OpenMetrics 탐색기로 이동합니다.

  • WhaTap AI 버튼을 클릭하면 WhaTap AI 기능을 활용할 수 있습니다.

화면 구성​

탐색기 화면은 검색 영역, Graph 섹션, Raw 섹션으로 나뉩니다.

검색 영역​

ElementDescription
조회 타입 선택기Series 또는 Instant 타입을 선택합니다. Series는 구간 데이터를, Instant는 특정 시점의 데이터를 조회합니다.
시간 선택기조회 기간을 분 단위까지 선택할 수 있습니다. 한 번에 최대 31일 범위의 데이터 조회를 지원합니다.
쿼리 입력창PromQL 형식의 쿼리를 입력해 원하는 데이터를 조회합니다. Series 타입을 선택한 경우 구간에 맞는 subquery가 자동으로 실행됩니다.
+ 대시보드에 추가 버튼현재 조회 중인 메트릭 차트를 Flex 보드에 추가합니다. Flex 보드 수정 권한이 있어야 합니다.

메트릭 조회 방법​

  1. 조회 타입 선택기에서 Series 또는 Instant를 선택하세요.

  2. 시간 선택기에서 조회 기간을 설정하세요. 분 단위 선택이 가능하며, 최대 31일 범위까지 지원합니다.

  3. 쿼리 입력창에 PromQL 형식의 쿼리를 입력하세요. Series 타입에서는 입력한 구간에 맞는 subquery가 자동으로 실행됩니다.

  4. 조회 결과는 Graph 섹션(Series 타입에서만 지원)과 Raw 섹션에 나뉘어 표시됩니다.

  5. 자주 사용하는 메트릭 차트는 + 대시보드에 추가 버튼을 클릭해 Flex 보드에 저장하세요. Flex 보드 수정 권한이 필요합니다.

Graph 섹션​

Series 타입에서만 지원합니다. 수집한 메트릭을 시계열 차트로 표시합니다. 섹션 오른쪽의 Line / Bar 토글 버튼으로 차트 유형을 전환할 수 있습니다.

시리즈 구분 기준​

그래프의 각 시리즈(선)는 레이블 조합으로 구분됩니다. cluster_name, instance, job 등 레이블 값이 다르면 별도의 시리즈로 표시되고, 각각 다른 색으로 렌더링됩니다. 범례(legend)에는 해당 시리즈의 레이블 조합이 JSON 형태로 표시됩니다.

{ "cluster_name": "tomcat-proxy-demo-aerospike", "instance": "10.21.11.83:9145", "job": "aerospike-e..." }

툴팁​

그래프의 특정 시점에 마우스를 올리면 해당 시리즈의 전체 레이블 목록과 값을 툴팁으로 확인할 수 있습니다.

2026-05-19 07:24:07
{
  "cluster_name": "tomcat-proxy-demo-aerospike",
  "instance": "10.21.11.83:9145",
  "job": "aerospike-exporter",
  "le": "8192",
  "latitude": "0",
  "longitude": "0",
  "ns": "demo",
  "pcode": "49649",
  "service": "10.21.11.83:3000"
}

Raw 섹션​

Raw 섹션은 Table / Raw 탭으로 구성됩니다.

TabDescription
Table메트릭 값을 표 형태로 나열합니다. 레이블 조합을 비교하거나 특정 시점의 값을 정확히 확인할 때 사용합니다.
Raw엔드포인트에서 수집한 원시 데이터를 표시합니다. 수집 자체가 정상인지, 레이블 구조가 예상대로인지 검증할 때 활용합니다.
노트

쿼리 결과가 없는 경우 "데이터 없음" 메시지와 함께 Total: 0이 표시됩니다.

최종 수정: