기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 탐색에서의 쿼리 관리
<a name="v9-explore-manage"></a>

****  
이 설명서 주제는 **Grafana 버전 9.x**를 지원하는 Grafana 워크스페이스를 위해 설계되었습니다.  
Grafana 버전 12.x를 지원하는 Grafana 워크스페이스는 섹션을 참조하세요[Grafana 버전 12에서 작업](using-grafana-v12.md).  
Grafana 버전 10.x를 지원하는 Grafana 워크스페이스의 경우 [Grafana 버전 10에서 작업](using-grafana-v10.md) 섹션을 참조하세요.  
Grafana 버전 8.x를 지원하는 Grafana 워크스페이스의 경우 [Grafana 버전 8에서 작업](using-grafana-v8.md) 섹션을 참조하세요.

쿼리 디버깅을 지원하기 위해 탐색에서는 쿼리 검사기를 통해 쿼리 요청 및 응답과 쿼리 통계를 조사할 수 있습니다. 이 기능은 패널 검사기 태스크 [쿼리 성능 검사](v9-panels-panel-inspector.md#v9-panels-query-performance) 및 [쿼리 요청 및 응답 데이터 검사](v9-panels-panel-inspector.md#v9-panels-query-request-response)와 유사합니다.

## 쿼리 기록
<a name="v9-explore-manage-history"></a>

쿼리 기록은 탐색에서 사용한 쿼리 목록입니다. 기록은 Grafana 데이터베이스에 저장되며 다른 사용자와 공유되지 않습니다. 기록에서 쿼리 보존 기간은 2주입니다. 2주가 지난 쿼리는 자동으로 삭제됩니다. 기록을 열고 상호 작용하려면 탐색에서 **쿼리 기록** 버튼을 선택합니다.

**참고**  
별표로 표시된(즐겨찾는) 쿼리에는 2주 보존 기간이 적용되지 않으며 해당 쿼리는 삭제되지 않습니다.

**쿼리 기록 보기**

쿼리 기록을 사용하면 쿼리 기록을 볼 수 있습니다. 각 개별 쿼리에 대해 다음을 수행할 수 있습니다.
+ 쿼리를 실행합니다.
+ 설명을 생성 및/또는 편집합니다.
+ 쿼리를 클립보드에 복사합니다.
+ 쿼리가 포함된 단축 링크를 클립보드에 복사합니다.
+ 쿼리에 별표(즐겨찾기)를 지정합니다.

**즐겨찾기 쿼리 관리**

쿼리 기록 탭에서 별표가 지정된 모든 쿼리는 별표 목록에 표시됩니다. 이를 통해 자주 사용하는 쿼리에 더 빠르게 액세스하고 처음부터 입력하지 않고 이러한 쿼리를 재사용할 수 있습니다.

**쿼리 기록 정렬**

기본적으로 쿼리 기록에는 최신 쿼리가 표시됩니다. 날짜 또는 데이터 소스 이름을 기준으로 오름차순 또는 내림차순으로 기록을 정렬할 수 있습니다.

**쿼리 기록을 정렬하는 방법**

1. **쿼리 정렬 기준** 필드를 선택하세요.

1. 다음 옵션 중 하나를 선택합니다.
   + 최신 항목 우선
   + 가장 오래된 항목 우선

**쿼리 기록 필터링**

쿼리 기록 및 별표 탭에서 쿼리 기록을 특정 데이터 소스로 필터링할 수 있습니다.

**데이터 소스로 기록 필터링**

1. **특정 데이터 소스에 대한 쿼리 필터링** 필드를 선택하세요.

1. 기록을 필터링할 데이터 소스를 선택하세요. 여러 데이터 소스를 선택할 수 있습니다.

**쿼리 기록** 탭에서 슬라이더를 사용하여 날짜별로 쿼리를 필터링할 수도 있습니다.
+ 세로 슬라이더를 사용하여 날짜별로 쿼리를 필터링하세요.
+ 상단 핸들을 끌어 시작 날짜를 조정하세요.
+ 상단 핸들을 끌어 종료 날짜를 조정하세요.

**쿼리 기록에서 검색**

기록의 쿼리 및 설명에서 검색할 수 있습니다. 쿼리 기록 탭 및 별표 탭에서 쿼리를 검색할 수 있습니다.

**쿼리 기록에서 검색하는 방법**

1. **쿼리 검색** 필드를 선택하세요.

1. 검색하려는 용어를 검색 필드에 입력하세요.

**쿼리 편집기 설정**

설정 탭에서 쿼리 기록을 사용자 지정할 수 있습니다. 옵션은 다음 표에 설명되어 있습니다.


| 설정 | 기본값  | 
| --- | --- | 
| 기본 활성 탭 변경 | 쿼리 기록 탭 | 

**참고**  
쿼리 기록 설정은 전역적이며 분할 모드의 두 패널에 적용됩니다.

## Prometheus별 기능
<a name="v9-explore-manage-prometheus"></a>

탐색에서는 Prometheus에 대한 사용자 지정 쿼리 환경을 제공합니다. 쿼리를 실행할 때 실제로 그래프에 대한 일반 Prometheus 쿼리 및 테이블에 대한 *인스턴스 쿼리*라는 두 가지 쿼리를 실행합니다. 인스턴트 쿼리는 각 시계열의 마지막 값을 반환하며, 이는 그래프에 표시된 데이터의 좋은 요약 정보를 보여줍니다.

**지표 탐색기**

쿼리 필드 왼쪽에서 **지표**를 선택하여 지표 탐색기를 엽니다. 그러면 지표가 접두사별로 그룹화된 계층적 메뉴가 표시됩니다. 예를 들어 모든 Alertmanager 지표는 `alertmanager` 접두사 아래에 그룹화됩니다. 이는 사용 가능한 지표만 탐색하려는 경우 좋은 출발점입니다.

**쿼리 필드**

쿼리 필드는 지표 이름 및 함수에 대한 자동 완성을 지원하며 이는 표준 Prometheus 쿼리 편집기와 비슷합니다. Enter 키를 눌러 새 줄을 생성하고 Shift\+Enter를 눌러 쿼리를 실행할 수 있습니다.

자동 완성 메뉴는 Ctrl\+Space를 눌러 트리거할 수 있습니다. 자동 완성 메뉴에는 최근에 실행된 쿼리 목록이 포함된 새 기록 섹션이 포함되어 있습니다.

제안은 쿼리 필드 아래에 표시될 수 있습니다. 제안된 변경 사항으로 쿼리를 업데이트하려면 제안을 선택합니다.
+ 카운터(단조적으로 증가하는 지표)의 경우 비율 함수가 제안됩니다.
+ 버킷의 경우 히스토그램 함수가 제안됩니다.
+ 기록 규칙의 경우 규칙을 확장할 수 있습니다.

**테이블 필터**

테이블 패널의 **레이블** 열에서 필터 버튼을 선택하여 쿼리 표현식에 필터를 추가합니다. 여러 쿼리에 대한 필터를 추가할 수도 있습니다. 모든 쿼리에 대해 필터가 추가됩니다.