기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
둘러보기
이 설명서 항목은 Grafana 버전 8.x를 지원하는 Grafana 작업 영역을 위해 설계되었습니다.
Grafana 버전 10.x를 지원하는 Grafana 작업 영역에 대한 내용은 을 참조하십시오. Grafana 버전 10에서 작업하기
Grafana 버전 9.x를 지원하는 Grafana 작업 영역에 대한 내용은 을 참조하십시오. Grafana 버전 9에서 작업하기
Grafana 작업 영역에서 대시보드 UI는 시각화를 위한 대시보드를 구축하기 위한 도구를 제공합니다. Explore는 모든 대시보드 및 패널 옵션을 제거하므로 쿼리에 집중할 수 있습니다. 제대로 작동하는 쿼리가 나올 때까지 반복한 다음 대시보드를 계획하고 구축하세요.
인프라 모니터링 및 사고 대응을 위해 더 이상 다른 도구로 전환하여 무엇이 잘못되었는지 디버깅할 필요가 없습니다. Explore를 사용하여 메트릭과 로그를 더 자세히 분석하여 원인을 찾을 수 있습니다.
Explore를 사용하면 대시보드를 만들지 않고도 데이터를 더 쉽게 볼 수 있습니다. 데이터 원본이 그래프 및 표 데이터를 지원하는 경우 Explore는 결과를 그래프와 표로 모두 표시합니다. 이를 통해 데이터의 추세와 더 자세한 정보를 동시에 확인할 수 있습니다.
탐색을 시작하세요
참고
기본적으로 뷰어 역할을 가진 사용자는 편집할 수 없으며 Explore에 액세스할 수 없습니다.
왼쪽 메뉴의 탐색 아이콘을 클릭하면 빈 탐색 탭이 열립니다.
패널의 기존 쿼리로 시작하려면 패널 메뉴에서 탐색 옵션을 선택합니다. 그러면 패널의 쿼리가 포함된 탐색 탭이 열립니다. 그런 다음 대시보드 외부에서 쿼리를 조정하거나 반복할 수 있습니다.
왼쪽 상단의 드롭다운 목록에서 데이터 소스를 선택합니다. Prometheus는 사용자 지정 Explore를 구현했습니다. 다른 데이터 소스는 표준 쿼리 편집기를 사용합니다.
쿼리 필드에서 쿼리를 작성하고 데이터를 탐색할 수 있습니다. 쿼리 필드 옆에는 지우기 버튼 (X), 쿼리 추가 버튼 (+), 쿼리 제거 버튼 (-) 이라는 세 개의 버튼이 있습니다. 패널 쿼리 편집기에서처럼 여러 쿼리를 추가하고 제거할 수 있습니다.
분할 및 비교
분할 보기 기능은 그래프와 표를 side-by-side 비교하거나 관련 데이터를 한 페이지에서 함께 볼 수 있는 방법입니다. 현재 쿼리를 복제하고 페이지를 두 개의 side-by-side 쿼리로 분할하려면 [Split] 을 선택합니다. 새 쿼리에 대해 다른 데이터 소스를 선택할 수 있습니다. 이렇게 하면 서로 다른 두 서버의 동일한 쿼리를 비교하거나 스테이징 환경을 프로덕션 환경과 비교할 수 있습니다.
분할 보기에서는 시간 선택기에 연결된 시간 동기화 버튼 중 하나를 선택하여 두 패널의 시간 선택기를 연결할 수 있습니다 (하나를 변경하면 다른 패널도 변경됨). 시간 선택기를 연결하면 분할 보기 쿼리의 시작 시간과 종료 시간을 동기화하여 두 분할 패널에서 동일한 시간 간격을 확인할 수 있습니다.
[Split 닫기] 를 선택하여 새로 만든 쿼리를 닫을 수 있습니다.
단축 링크 공유
단축 링크 공유 기능을 사용하면 복잡한 쿼리 매개변수가 포함된 더 긴 URL을 공유하는 /goto/:uid
대신 해당 형식의 URL을 더 작고 간단하게 만들 수 있습니다. 탐색 도구 모음에서 공유 옵션을 선택하여 단축 링크를 만들 수 있습니다. 사용하지 않는 단축 링크는 7일 후에 자동으로 삭제됩니다.
쿼리 기록
쿼리 기록은 Explore에서 사용한 쿼리 목록입니다. 기록은 브라우저에 로컬로 저장되며 공유되지 않습니다. 기록을 열고 상호작용하려면 Explore에서 쿼리 기록을 선택합니다.
쿼리 기록 보기
F쿼리 기록에서 다음을 수행할 수 있습니다.
-
쿼리를 실행합니다.
-
댓글을 만들거나 편집하세요.
-
쿼리를 클립보드에 복사합니다.
-
쿼리가 포함된 단축 링크를 클립보드에 복사합니다.
-
쿼리에 별표를 표시합니다.
즐겨찾는 쿼리 관리
쿼리 기록 탭에서 별표 표시한 모든 쿼리는 별표 표시 탭에 표시됩니다. 자주 사용하는 쿼리에 더 빠르게 액세스하고 다시 입력할 필요 없이 해당 쿼리를 재사용할 수 있습니다.
쿼리 기록 정렬
기본적으로 쿼리 기록에는 가장 최근 쿼리가 표시됩니다. 기록을 날짜 또는 데이터 원본 이름을 기준으로 오름차순 또는 내림차순으로 정렬할 수 있습니다.
쿼리 기록 오른쪽의 드롭다운 목록에서 다음 옵션 중 하나를 선택합니다. 필드.
-
최신순 순
-
오래된 것부터
-
데이터 소스 A-Z
-
데이터 소스 Z-A
참고
분할 보기인 경우 정렬 모드는 활성 패널에만 적용됩니다.
쿼리 기록 필터링
쿼리 기록 및 별표 표시 탭에서 데이터 원본 이름을 기준으로 쿼리 기록을 필터링할 수 있습니다.
-
특정 데이터 원본에 대한 쿼리 필터링을 선택합니다.
-
기록을 필터링하는 데 사용할 데이터 소스를 선택합니다. 여러 데이터 소스를 선택할 수 있습니다.
쿼리 기록 탭에서 세로 슬라이더를 사용하여 날짜별로 쿼리를 필터링할 수 있습니다.
-
아래쪽 핸들을 드래그하여 시작일을 조정합니다.
-
위쪽 핸들을 드래그하여 종료일을 조정합니다.
참고
분할 보기 상태인 경우 필터는 활성 패널에만 적용됩니다.
쿼리 기록에서 검색
기록에서 검색어와 댓글을 검색할 수 있습니다. 쿼리 기록 및 별표 표시 탭에서 쿼리를 검색할 수 있습니다.
-
검색 쿼리 필드를 선택합니다.
-
검색 필드에 검색어를 입력합니다.
쿼리 기록 설정
설정 탭에서 쿼리 기록을 사용자 지정할 수 있습니다. 다음 표에는 사용 가능한 옵션이 나열되어 있습니다.
설정 | 기본값 |
---|---|
Grafana가 쿼리 기록을 저장하는 기간을 지정하십시오. | 1주 |
기본 활성 탭을 변경하세요. | 쿼리 기록 탭 |
Explore에서 현재 활성화된 데이터 원본에 대한 쿼리만 표시합니다. | True |
쿼리 기록을 지웁니다. | (저장된 모든 쿼리를 영구 삭제하려면 쿼리 기록 지우기를 선택합니다.) |
참고
쿼리 기록 설정은 글로벌 설정이며 분할 모드에서 두 패널에 모두 적용됩니다.
프로메테우스 전용 기능
Explore의 첫 번째 버전은 Prometheus를 위한 사용자 지정 쿼리 환경을 제공합니다. 쿼리를 실행할 때 Grafana는 실제로 두 개의 쿼리를 실행합니다. 그래프에 대한 일반 Prometheus 쿼리와 테이블에 대한 인스턴트 쿼리입니다. 인스턴트 쿼리는 각 시계열의 마지막 값을 반환하며, 그래프에 표시된 데이터를 잘 요약한 것입니다.
메트릭 탐색기
쿼리 필드 왼쪽에서 지표를 선택하여 지표 탐색기를 엽니다. 그러면 지표가 접두사별로 그룹화된 계층적 메뉴가 표시됩니다. 예를 들어, 모든 Alertmanager 지표는 접두사 아래에 그룹화됩니다. alertmanager
이는 사용 가능한 지표를 탐색하기 위한 좋은 출발점입니다.
쿼리 필드
Query 필드는 지표 이름, 함수에 대한 자동 완성을 지원하며 표준 Prometheus 쿼리 편집기와 거의 동일한 방식으로 작동합니다. Enter를 눌러 쿼리를 실행합니다.
Ctrl+Space를 눌러 자동 완성 메뉴에 액세스할 수 있습니다. 자동 완성 메뉴에는 최근에 실행한 쿼리 목록이 있는 새 기록 섹션이 있습니다.
쿼리 필드 아래에 제안이 표시될 수 있습니다. 제안을 선택하여 제안된 변경 내용으로 쿼리를 업데이트하세요.
-
카운터 (단조롭게 증가하는 지표) 의 경우 비율 함수를 사용하는 것이 좋습니다.
-
버킷의 경우 히스토그램 함수를 사용하는 것이 좋습니다.
-
기록 규칙의 경우 규칙을 확장할 수 있습니다.
테이블 필터
테이블 패널의 레이블 열에서 필터 버튼을 선택하여 쿼리 표현식에 필터를 추가합니다. 여러 쿼리에 대한 필터도 추가할 수 있습니다. 모든 쿼리에 필터가 추가됩니다.
로그 통합
Explore를 사용하여 다음 데이터 소스로 로그를 조사할 수도 있습니다.
-
InfluxDB
-
Elasticsearch
로그 시각화
로그 쿼리 결과는 그래프에 히스토그램으로 표시되며 개별 로그는 아래에 표시됩니다. 데이터 원본이 요청된 시간 범위에 대한 히스토그램 데이터를 전송하지 않는 경우 로그 모델은 자동으로 계산된 시간 간격으로 버킷화된 로그 행 수를 기반으로 시계열을 계산합니다. 그러면 결과에서 나온 첫 번째 로그 행의 타임스탬프가 히스토그램의 시작 부분을 고정합니다. 시계열의 끝은 시간 선택기의 To 범위에 고정됩니다.
로그 수준
수준 레이블이 지정된 로그의 경우 Grafana는 레이블 값을 사용하여 로그 수준을 결정하고 그에 따라 색상을 업데이트합니다. 로그에 지정된 레벨 레이블이 없는 경우 Grafana는 로그를 파싱하여 콘텐츠가 지원되는 표현식과 일치하는지 확인합니다. 로그 수준은 항상 첫 번째 일치 항목에 의해 결정됩니다. Grafana가 로그 수준을 결정할 수 없는 경우 알 수 없는 로그 수준으로 시각화됩니다. 다음 표에는 로그 수준과 로그 수준 약어 및 표현식의 매핑이 나열되어 있습니다.
지원되는 표현식 | 로그 수준 | 색상 |
---|---|---|
이머지 | 결정적인 | 퍼플 |
치명적입니다 | 결정적인 | 퍼플 |
알림 | 결정적인 | 퍼플 |
크릿 | 결정적인 | 퍼플 |
결정적인 | 결정적인 | 퍼플 |
오류 | error | red |
오류 | error | red |
error | error | red |
경고하다 | warning | yellow |
warning | warning | yellow |
info | info | green |
정보 | info | green |
주의 | info | green |
디버그 | debug | blue |
debug | debug | blue |
추적 | 추적 | 라이트 블루 |
* | 불명 | 그레이 |
시각화 옵션
로그 표시 방식을 사용자 지정하고 표시할 열을 선택할 수 있습니다.
Time
이 옵션은 시간 열을 표시하거나 숨깁니다. 데이터 소스에서 보고된 로그 라인과 관련된 타임스탬프입니다.
고유 레이블
이 옵션은 비공통 레이블만 포함하는 고유 레이블 열을 표시하거나 숨깁니다. 모든 공통 레이블이 위에 표시됩니다.
랩 라인
디스플레이에서 줄 바꿈을 사용하려면 이 값을 True로 설정하십시오. 이 옵션을 False로 설정하면 가로 스크롤이 발생합니다.
데이터 중복 제거
로그 데이터는 매우 반복적일 수 있습니다. Explore는 중복된 로그 줄을 숨겨서 도움이 될 수 있습니다. 다양한 중복 제거 알고리즘 중에서 선택할 수 있습니다.
-
완전 일치 — 날짜 필드를 제외한 전체 행에서 정확히 일치합니다.
-
숫자 — 기간, IP 주소 등과 같은 숫자를 제거한 후 해당 회선에서 매칭이 이루어집니다.
-
서명 — 가장 공격적인 중복 제거로 모든 문자와 숫자를 제거합니다. 나머지 공백과 문장 부호도 일치시킵니다.
결과 순서 뒤집기
수신된 로그의 순서를 기본 내림차순 (최신순) 에서 오름차순 (가장 오래된 것부터) 으로 변경할 수 있습니다.
레이블 및 탐지된 필드
각 로그 행에는 레이블과 감지된 필드가 포함된 확장 가능한 영역이 있어 상호 작용이 더욱 원활해집니다. 모든 레이블에 대해 선택한 레이블을 필터링 (포지티브 필터) 하거나 필터링 (네거티브 필터) 할 수 있습니다. 또한 각 필드 또는 레이블에는 표시된 모든 로그와 관련된 일회성 통계를 표시하는 통계 아이콘이 있습니다.
탐지된 필드를 전환합니다.
로그가 JSON 또는 logfmt로 구조화된 경우 탐지된 필드를 표시하거나 숨길 수 있습니다. 로그 라인을 확장한 다음 눈 모양 아이콘을 선택하여 필드를 표시하거나 숨깁니다.
{{< docs-imagebox img=” /img/docs/explore/parsed-fields-7-2.gif "max-width="800px” caption="탐색에서 탐지된 필드 전환” >}}
추적 통합
Explore에서 추적 데이터 원본의 추적을 시각화할 수 있습니다. 현재 지원되는 데이터 소스:
쿼리 편집기 사용에 대한 자세한 내용은 특정 데이터 원본의 설명서를 참조하십시오.
헤더
헤더에는 다음 항목이 포함됩니다.
-
루트 스팬의 이름과 트레이스 ID를 보여주는 헤더 제목
-
검색: 검색된 텍스트가 포함된 범위를 강조 표시합니다.
-
트레이스에 대한 메타데이터
미니맵
미니맵은 요약된 뷰 또는 트레이스 타임라인을 보여줍니다. 미니맵 위로 마우스를 드래그하면 더 작은 시간 범위로 확대할 수 있습니다. 확대/축소하면 기본 타임라인도 업데이트되므로 더 짧은 기간을 쉽게 확인할 수 있습니다. 미니맵에서 일시 중지한 경우 확대/축소했을 때 줌을 재설정하는 선택 재설정 버튼을 볼 수 있습니다.
타임라인
타임라인에는 트레이스 내 범위 목록이 표시됩니다. 각 스팬 행은 다음 구성 요소로 구성됩니다.
-
하위 항목 확장 버튼: 선택한 범위의 모든 하위 범위를 확장하거나 축소합니다.
-
서비스 이름: 해당 범위를 기록한 서비스의 이름
-
작업 이름: 이 범위가 나타내는 작업의 이름
-
스팬 지속 시간 표시줄: 트레이스 내 작업 기간을 시각적으로 표현한 것입니다.
스팬 행의 아무 곳이나 선택하면 스팬 세부 정보가 표시됩니다.
스팬 세부 정보
스팬 세부 정보에는 다음 항목이 포함됩니다.
-
작업 이름
-
스팬 메타데이터
-
태그 (이 스팬과 관련된 모든 태그)
-
프로세스 메타데이터 (이 범위를 기록한 프로세스에 대한 메타데이터)
-
로그: 이 범위별로 기록된 로그 및 관련 키 값의 목록입니다. Zipkin 로그 섹션의 경우 Zipkin 주석이 표시됩니다.
Explore와 대시보드 사이를 탐색하기
Explore에서 대시보드로 또는 그 반대로 정기적으로 전환하는 워크플로를 가속화하기 위해 패널의 드롭다운에서 Explore로 이동한 후 원본 대시보드로 돌아갈 수 있는 기능을 추가했습니다.
Explore로 이동한 후에는 Explore 툴바에 “뒤로” 버튼이 있는 것을 확인할 수 있습니다.
버튼을 선택하기만 하면 원본 대시보드로 돌아가거나, Explore에서 변경한 내용을 대시보드로 다시 가져오려면 버튼 옆의 화살표를 선택하면 “변경 사항이 있는 패널로 돌아가기” 메뉴 항목이 나타납니다.
쿼리 인스펙터
쿼리 디버깅을 지원하기 위해 Explore를 사용하면 쿼리 검사기를 통해 쿼리 요청 및 응답은 물론 쿼리 통계를 조사할 수 있습니다. 이 기능은 패널 인스펙터 통계 탭 및 쿼리 탭과 비슷합니다. 자세한 내용은 쿼리 성능을 검사하세요. 및 데이터 소스에 대한 원시 요청 및 응답 보기 단원을 참조하세요.