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