Explore의 쿼리 검사기

Explore의 쿼리 검사기

그라파나 Explore의 쿼리 검사기(Query inspector)는 쿼리에 대한 상세한 통계를 보여줘서 쿼리를 이해하고 문제를 해결하는 데 도움을 줍니다. 검사기를 통해 원본 데이터를 살펴보고, CSV 파일로 내보내고, 로그 결과를 TXT로 내보내고, 쿼리 요청을 볼 수 있어요. 한 번 익혀두면 디버깅 시간을 크게 줄일 수 있답니다.

출처: Query inspector in Explore

본문

쿼리 검사기 UI 열기

쿼리 검사기를 여는 방법은 다음과 같습니다.

  1. Explore 페이지로 이동합니다.
  2. 검사하고 싶은 쿼리를 실행합니다.
  3. Query inspector를 클릭합니다.

Explore 페이지 하단에 쿼리 검사기 창이 열리며, 다음 탭들을 볼 수 있습니다.

  • Stats 탭 – 쿼리 실행에 걸린 시간, 데이터 처리 시간, 반환된 데이터 양 등 쿼리에 대한 통계를 보여줍니다.
  • Query 탭 – 그라파나가 데이터 소스를 조회할 때의 원시 요청·응답 데이터와 시각을 제공합니다.
  • JSON 탭 – JSON 데이터와 JSON 데이터 프레임 구조를 보고 복사할 수 있습니다.
  • Data 탭 – 쿼리가 반환한 원시 데이터를 보여줍니다. 정보를 CSV 파일로 내려받을 수 있습니다.
  • Error 탭 – 에러를 보여줍니다. 쿼리가 에러를 반환할 때만 표시됩니다.

Stats 탭

Stats 탭에서 쿼리 성능을 점검할 수 있습니다. 쿼리가 얼마나 오래 걸리는지, 몇 개의 쿼리를 보내는지, 반환된 행 수와 trace ID를 표시해줍니다. 특히 어떤 숫자가 예상보다 너무 높거나 낮다면 이 정보로 쿼리를 트러블슈팅할 수 있어요.

검사기를 연 뒤 Stats 탭을 클릭하면 통계가 읽기 전용으로 표시됩니다.

Query 탭

Query 탭에서 원시 요청과 응답을 볼 수 있습니다.

  1. 쿼리 검사기를 열고 Query 탭을 클릭합니다.
  2. Refresh를 클릭합니다.

그라파나가 쿼리를 서버로 보내고 결과를 표시합니다. 쿼리의 특정 부분을 드릴다운하거나 전체를 펼치고 접을 수 있으며, Copy to clipboard로 다른 애플리케이션에서 쓸 데이터를 복사할 수 있습니다.

JSON 탭

JSON 탭에서 데이터 결과를 JSON 및 데이터 프레임 JSON 모델로 볼 수 있습니다.

  1. 쿼리 검사기를 열고 JSON 탭을 클릭합니다.
  2. Select source 드롭다운에서 다음 중 하나를 선택합니다. Panel data – 시각화가 Explore에서 가져온 데이터를 나타내는 JSON 객체를 표시합니다. DataFrame JSON (from query) – 변환과 필드 구성이 적용되지 않은 원시 데이터 결과 집합을 표시합니다.

Data 탭

Data 탭에서 원시 쿼리 결과를 보고, 점검하고, 내려받을 수 있습니다.

  1. 쿼리 검사기를 열고 Data 탭을 클릭합니다.
  2. Data options를 클릭해 Show data frame 아래에 있는 옵션을 봅니다.
  3. 드롭다운 메뉴에서 데이터 결과 집합을 선택합니다.
  4. 쿼리가 여러 개이거나 여러 노드에 대한 쿼리라면 드롭다운에서 Series joined by time을 선택해 모든 쿼리의 원시 데이터를 한 번에(열마다 하나의 결과 집합) 볼 수 있습니다. 열 머리글을 클릭하면 데이터를 정렬할 수 있습니다.
  5. Formatted data를 토글해 패널의 형식과 맞춥니다.
  6. Download for Excel을 토글하면 Excel용으로 특별히 포맷된 CSV 파일을 내려받습니다.
  7. 결과를 CSV 파일로 내려받으려면 쿼리 검사기 창 오른쪽 위의 Download CSV를 클릭합니다.

로그 결과를 TXT로 내려받기

데이터 소스 유형(Loki 등)에 따라, 또는 결과 집합에 로그가 있을 때, 그라파나는 로그 원시 데이터 결과를 TXT 파일로 생성해 기본 브라우저 다운로드 위치에 저장합니다. 원하는 뷰어로 열면 됩니다.

  1. Query inspector를 클릭합니다.
  2. Data 탭을 클릭해 로그 쿼리 결과를 봅니다.
  3. Download logs를 클릭합니다.

트레이스 결과 내려받기

데이터 소스 유형(Tempo 등)에 따라, 그라파나는 트레이스 결과를 지원되는 형식(Jaeger, Zipkin, OTLP 중 하나)의 JSON 파일로 생성합니다.

  1. Query inspector를 클릭합니다.
  2. Data 탭을 클릭해 트레이스 결과를 봅니다.
  3. Download traces를 클릭합니다.

더 알아보기