Explore 시작하기

Explore 시작하기 (Get started with Explore)

Explore는 Grafana에서 데이터를 질의·분석·집계하는 관문이에요. 시각화와 데이터 분석을 만들기 위한 작동하는 쿼리 또는 쿼리 집합을 개발할 때까지 시각적으로 탐색하고 반복할 수 있게 해줘요. 데이터 소스가 그래프와 테이블 데이터를 지원한다면 대시보드를 만들 필요 없이 Explore가 두 형식 모두로 결과를 표시할 수 있어요.

출처: Get started with Explore

본문

Explore로 다음을 할 수 있어요.

• 대시보드에 통합할 시각화 만들기
• 혼합 데이터 소스(Mixed)로 쿼리 만들기
• 단일 인터페이스에서 여러 쿼리 만들기
• 다양한 데이터 소스의 데이터 형태 이해하기
• 실시간 데이터 탐색과 분석 수행

주요 기능은 다음과 같아요.

• 특정 데이터 소스를 기반으로 한 쿼리 편집기로 쿼리 생성·반복
• Query history로 쿼리 추적·유지
• Query inspector로 쿼리 성능 문제 해결

시작하기 전에

Explore에 접근하려면 editor 또는 administrator 기본 역할, 또는 data sources explore 역할이 있어야 해요. 각 역할이 접근할 수 있는 것에 대한 자세한 내용은 Role and permissions를 참고하세요.

Grafana Enterprise의 Role-based access control (RBAC)로 Explore를 역할 기반 권한으로 관리하는 방법을 이해하려면 참고하세요.

Explore 요소

Explore는 툴바, 개요(outline), 쿼리 편집기, 여러 쿼리 추가 기능, 쿼리 이력, 쿼리 인스펙터로 구성돼요.

콘텐츠 개요

콘텐츠 개요는 Explore에서 만든 쿼리와 시각화를 추적하는 사이드 탐색 바예요. 개요는 쿼리와 시각화 사이를 빠르게 탐색하는 데 도움을 줘요. 분할 보기에서 작동하며 각 창에 대해 별도의 개요가 생성돼요.

콘텐츠 개요를 열려면 Explore 화면 왼쪽 위의 Outline 버튼을 클릭해요. 그다음 콘텐츠 개요의 패널 아이콘을 클릭해 해당 패널로 이동할 수 있어요.

툴바

툴바는 자주 사용하는 도구와 설정에 빠른 접근을 제공해요.

• Data source picker - 드롭다운 메뉴에서 데이터 소스를 선택하거나 절대 시간을 사용해요.
• Split - 클릭해 시각화를 나란히 비교해요. 자세한 내용은 Split and compare 참고.
• Add - 클릭해 탐색을 대시보드에 추가해요. 장애 선언, 예측 만들기, 이상치 탐지, 조사 실행에도 사용할 수 있어요.
• Time picker - 시간 선택기에서 시간 범위를 선택해요. 절대 시간 범위도 입력할 수 있어요.
• Run query - 클릭해 쿼리를 실행해요.

시간 선택기 (Time picker)

시간 선택기로 쿼리의 시간 범위를 선택해요. 기본값은 **지난 1시간(last hour)**이에요. 드롭다운에서 다른 옵션을 선택하거나 절대 시간 범위를 사용할 수 있어요. 쿼리와 연결된 시간대를 바꾸거나 회계 연도(fiscal year)를 사용할 수도 있어요.

1. 시간대를 바꾸거나 회계 연도를 적용하려면 Change time settings을 클릭해요.

절대 및 상대 시간 범위에 대한 자세한 내용은 Set dashboard time range를 참고하세요. URL로 시간 범위 제어도 할 수 있어요.

분할 및 비교 (Split and compare)

분할 보기는 시각화를 나란히 쉽게 비교하거나 한 페이지에서 관련 데이터를 동시에 볼 수 있게 해줘요.

분할 보기를 열려면:

1. 분할 버튼을 클릭해 현재 쿼리를 복제하고 페이지를 두 개의 나란한 쿼리로 분할해요.
2. 필요할 때 쿼리를 반복 실행해요.

새 쿼리에 대해 다른 데이터 소스, 또는 다른 지표와 라벨 필터를 선택할 수 있어요. 이를 통해 두 서버에서 같은 쿼리를 비교하거나 스테이징 환경과 프로덕션 환경을 비교할 수 있어요.

시간 선택기에 붙은 시간 동기화 버튼 중 하나를 클릭해 두 패널의 시간 선택기를 연결할 수도 있어요. 연결되면 한 패널에서 시간을 바꾸면 다른 패널도 자동으로 업데이트되어 시작과 종료 시간이 동기화돼요. 이렇게 하면 두 분할 패널이 같은 시간 간격의 데이터를 표시해요.

Close를 클릭해 분할 보기를 종료해요.

쿼리 편집기

쿼리 편집기는 데이터 소스에 대한 쿼리를 구성하는 인터페이스예요. 각 데이터 소스의 쿼리 편집기는 고유한 기능을 활용하는 쿼리를 작성하는 데 도움을 주는 맞춤형 사용자 인터페이스를 제공해요. 여러 데이터 소스에 걸쳐 쿼리를 실행하려면 데이터 소스 선택기에서 Mixed를 선택해야 해요. Mixed를 선택하면 추가하는 각 새 쿼리에 대해 다른 데이터 소스를 선택할 수 있어요.

이전에 만든 쿼리를 saved queries 기능으로 재사용할 수도 있어요. 쿼리 편집기에 대한 자세한 내용은 Query editor in Explore를 참고하세요.

쿼리 이력 (Query history)

쿼리 이력에는 Explore에서 만든 쿼리 목록이 들어 있어요. 이력의 쿼리를 saved queries에 추가할 수도 있어요. 쿼리 이력 작업에 대한 자세한 내용은 Query history를 참고하세요.

쿼리 인스펙터 (Query inspector)

쿼리 인스펙터는 쿼리에 대한 상세 통계를 제공해요. 인스펙터는 쿼리를 "검사"하는 일종의 디버깅 도구로 기능해요. Stats 아래에 쿼리 통계, Query 아래에 요청 응답 시간, {} JSON 아래에 데이터 프레임 세부 정보, Data 아래에 데이터의 형태를 제공해요. 자세한 내용은 Query inspector in Explore를 참고하세요.

Explore 접근

Explore에 접근하려면:

1. 왼쪽 메뉴에서 Explore를 클릭해요.

대시보드 패널의 기존 쿼리로 시작하려면 오른쪽 위의 패널 메뉴에서 Explore 옵션을 선택해요. 이렇게 하면 패널의 쿼리가 있는 Explore 페이지가 열려 대시보드 밖에서 쿼리를 조정하거나 반복할 수 있어요.

2. 왼쪽 위 드롭다운에서 데이터 소스를 선택해요.
3. 특정 데이터 소스에 제공된 쿼리 편집기로 쿼리 작성을 시작해요. 각 쿼리 편집기는 각 데이터 소스의 고유 요소에 따라 달라져요.

일부 쿼리 편집기는 미리 작성된 기본 쿼리 목록을 주는 Kick start your query 옵션을 제공해요. 다양한 쿼리 편집기 사용법은 Use query editors를 참고하세요. Grafana에서 데이터 소스 질의 일반 정보는 Query and transform data를 참고하세요.

특정 데이터 소스에 따라 일부 쿼리 편집기는 쿼리에 추가할 라벨을 선택할 수 있게 해줘요. 라벨은 데이터의 정보를 나타내는 키/값 쌍으로 이루어진 필드예요. 일부 데이터 소스는 필드 선택을 허용해요.

4. 오른쪽 위에서 Run query를 클릭해 쿼리를 실행해요.

Explore URL 공유

Explore를 사용할 때 브라우저 주소 막대의 URL은 쿼리를 변경하면서 업데이트돼요. 이 URL을 공유하거나 북마크할 수 있어요.

참고: Explore는 긴 URL을 생성할 수 있는데, 메시징이나 화상회의 애플리케이션 같은 일부 도구는 고정 메시지 길이로 이를 잘라버릴 수 있어요. 이런 경우 Explore는 경고를 표시하고 기본 상태를 로드해요. 이러한 애플리케이션에서 Explore 링크를 공유할 때 문제가 발생하면 단축 링크를 생성할 수 있어요. Share shortened link 참고.

외부 도구에서 Explore URL 생성

Explore URL은 정의된 구조를 갖기 때문에 외부 도구에서 URL을 만들어 Grafana에서 열 수 있어요. URL 구조는 다음과 같아요.

http://<grafana_url>/explore?panes=<panes>&schemaVersion=<schema_version>&orgId=<org_id>

여기서:

• org_id는 조직 ID
• schema_version은 스키마 버전(최신 버전인 1로 설정해야 함)
• panes는 패인(panes)의 URL 인코딩 JSON 객체. 각 키는 패인 ID이고 각 값은 다음 스키마와 일치하는 객체

{
  datasource: string; // the pane's root datasource UID, or `-- Mixed --` for mixed datasources
  queries: {
    refId: string; // an alphanumeric identifier for this query, must be unique within the pane, i.e. "A", "B", "C", etc.
    datasource: {
      uid: string; // the query's datasource UID ie: "AD7864H6422"
      type: string; // the query's datasource type-id, i.e: "loki"
    }
    // ... any other datasource-specific query parameters
  }[]; // array of queries for this pane
  range: {
    from: string; // the start time, in milliseconds since epoch
    to: string; // the end time, in milliseconds since epoch
  }
}

참고: from과 to는 Time units and relative ranges에 정의된 상대 범위도 받아들여요.

단축 링크 공유

Share shortened link 기능은 쿼리 매개변수가 있는 긴 URL 대신 /goto/:uid 형식의 더 작고 단순한 URL을 만들 수 있게 해줘요. 실행한 쿼리의 단축 링크를 만들려면 Explore 툴바에서 Share 옵션을 클릭해요.

절대 시간으로 단축 링크 공유

참고: Grafana 10.3 이상에서 사용 가능.

단축 링크에는 상대 시간(예: 2시간 전부터 지금까지) 또는 절대 시간(예: 8시부터 10시까지) 두 가지 옵션이 있어요. 기본적으로 단축 링크 공유는 상대든 절대든 선택한 시간 범위를 복사해요.

절대 시간으로 짧은 링크를 만들려면:

1. 단축 링크 공유 버튼 옆의 드롭다운 버튼을 클릭해요.
2. Time-Sync URL Links 아래에서 옵션 중 하나를 선택해요.

이렇게 하면 링크를 받는 사람이 언제 열든 당신이 보는 것과 같은 데이터를 보게 돼요. 선택한 시간 범위는 영향을 받지 않아요.

다음 단계

이제 Explore에 익숙해졌으니 다음을 할 수 있어요.

• 대시보드 구축
• 다양한 시각화 만들기
• 로그 작업
• 트레이스 작업
• 상관관계(correlations) 만들기·사용

더 알아보기 (Learn more)

• Query editor in Explore - Explore 쿼리 편집기
• Query management - 쿼리 관리·이력
• Set dashboard time range - 시간 범위 설정
• Explore - Explore 개요
• Get started with Explore - 원문 문서