기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 기록된 쿼리
****
이 설명서 주제는 **Grafana 버전 8.x**를 지원하는 Grafana 워크스페이스를 위해 설계되었습니다.
Grafana 버전 12.x를 지원하는 Grafana 워크스페이스는 섹션을 참조하세요[Grafana 버전 12에서 작업](using-grafana-v12.md).
Grafana 버전 10.x를 지원하는 Grafana 워크스페이스는 [Grafana 버전 10에서 작업](using-grafana-v10.md) 섹션을 참조하세요.
Grafana 버전 9.x를 지원하는 Grafana 워크스페이스는 [Grafana 버전 9에서 작업](using-grafana-v9.md) 섹션을 참조하세요.
기록된 쿼리를 사용하여 설정된 간격으로 데이터 포인트의 스냅샷을 생성해 시간 경과에 따른 추세를 확인할 수 있습니다. 이를 통해 과거 추세에 대한 인사이트를 얻을 수 있습니다.
시계열을 반환하지 않는 플러그인의 경우 기록 데이터를 도표화하는 것이 유용할 수 있습니다. 예를 들어 요청 응답 시간 기록을 보기 위해 **ServiceNow**를 쿼리할 수 있지만 이 경우 현재 특정 시점 지표만 반환할 수 있습니다.
## 기록된 쿼리 작동 방식
기록된 쿼리는 백엔드 데이터 소스 플러그인에서만 작동합니다. 자세한 내용은 [Backend data source plugin](https://grafana.com/tutorials/build-a-data-source-backend-plugin/)을 참조하세요. 세 가지 유형의 쿼리를 기록할 수 있습니다.
+ 단일 행 및 열 - 단일 행 및 열을 반환하는 쿼리.
+ 행 수 - 의미 있는 행을 계산할 수 있도록 반환하는 쿼리.
+ 표현식 - 모든 표현식. 표현식 생성 및 사용에 대한 자세한 내용은 [Expressions](https://grafana.com/docs/grafana/next/panels-visualizations/query-transform-data/expression-queries/)를 참조하세요.
기록된 쿼리가 생성되거나 활성화된 후에는 즉시 스냅샷을 생성하고 설정된 간격으로 스냅샷을 계속 생성합니다. 기록된 쿼리는 비활성화되거나 삭제되거나 Grafana가 실행 중이 아닐 때 스냅샷 캡처를 중지합니다. 기록된 쿼리를 실행하고 각 결과를 원격 쓰기 지원 Prometheus 인스턴스로 전달하여 백엔드에서 데이터 포인트가 수집됩니다.
**참고**
기록된 쿼리를 사용하려면 먼저 Prometheus 데이터 소스를 구성하고 원격 쓰기 대상에 연결해야 합니다.
## 기록된 쿼리 생성
기록된 쿼리를 생성하려면 다음 단계를 완료하세요.
1. 편집 패널의 대시보드에서 기록할 쿼리를 찾거나 생성하세요. 쿼리는 하나의 행과 열만 반환해야 합니다. 더 많이 반환하는 경우에도 *개수* 옵션을 사용하여 반환된 결과 수를 기록할 수 있습니다. 쿼리의 데이터 소스는 백엔드 데이터 소스여야 합니다. 표현식을 사용하여 시계열 쿼리의 데이터를 집계할 수 있습니다. 표현식 생성 및 사용에 대한 자세한 내용은 [Expressions](https://grafana.com/docs/grafana/next/panels-visualizations/query-transform-data/expression-queries/)를 참조하세요.
1. 쿼리 편집기에 있는 **쿼리 기록** 메뉴를 선택하세요.
1. 기록된 쿼리 정보를 입력하세요. 별도의 설명이 없는 한 모든 필드는 필수 필드입니다.
+ 이름 - 기록된 쿼리의 이름.
+ 설명 - (선택 사항) 기록된 쿼리 목록에 표시할 기록된 쿼리를 설명합니다.
+ 간격 - 스냅샷을 생성할 간격. 간격은 기록된 쿼리를 생성할 때 시작되며 기록된 쿼리를 일시 중지하거나 삭제하면 중지됩니다. 기록된 쿼리 일시 중지 및 삭제에 대한 자세한 내용은 [기록된 쿼리 관리](https://grafana.com/docs/grafana/latest/enterprise/recorded-queries/#manage-recorded-queries)를 참조하세요.
+ 범위 - 쿼리의 상대 시간 범위. 30분 범위와 1시간 간격을 선택하면 쿼리는 1시간마다 지난 30분의 스냅샷을 생성합니다.
+ 쿼리 결과 개수 - 쿼리에서 반환된 행을 계산하려면 이 옵션을 켭니다. 이 옵션이 꺼져 있는 경우 쿼리는 하나의 값을 포함하는 행 하나를 반환해야 합니다.
1. 기록된 쿼리 테스트 버튼을 선택하여 기록된 쿼리를 테스트하세요.
1. **쿼리 기록 시작**을 선택하세요.
## 기록된 쿼리 추가
대시보드의 패널에 기존의 기록된 쿼리를 추가할 수 있습니다. 추가하는 각 기록된 쿼리에 대해 Prometheus 쿼리(`generated_recorded_query_name{id="generated_id", name="recorded query name"}`)가 생성됩니다. Prometheus에서 생성된 쿼리는 기록된 쿼리의 수집된 모든 스냅샷을 반환합니다.
1. 대시보드에서 기록된 쿼리를 추가하려는 패널로 이동하세요.
1. **\+ 기록된 쿼리** 메뉴를 선택하세요.
1. 데이터 소스별로 기록된 쿼리를 필터링하려면 데이터 소스별 필터 드롭다운 메뉴에서 데이터 소스를 선택하세요.
1. 기록된 쿼리에서 **추가** 메뉴를 선택하여 패널에 추가하세요.
패널에 기록된 쿼리를 추가하면 패널 데이터 소스는 `-- Mixed --`가 됩니다. 기록된 쿼리는 기록된 쿼리 이름과 일치하는 이름 레이블의 `Prometheus` 쿼리로 표시됩니다. Prometheus 데이터 소스에 대한 자세한 내용은 [Prometheus](https://grafana.com/docs/grafana/latest/datasources/prometheus/)를 참조하세요.
기록된 쿼리를 추가한 후 Prometheus 데이터 소스 대신 `-- Mixed --` 데이터 소스를 포함하는 쿼리가 나타나는 경우, 기록된 쿼리에 대해 `Prometheus ` 원격 쓰기 대상이 설정되지 않았음을 의미할 수 있습니다. [원격 쓰기 대상](https://grafana.com/docs/grafana/latest/enterprise/recorded-queries/#remote-write-target)을 참조하여 원격 쓰기 포인트를 설정하세요.
## 기록된 쿼리 사용
기록된 쿼리를 사용하려면 쿼리를 생성하고 대시보드에 추가하세요. 그런 다음, **기록된 쿼리** 탭의 **기본 설정**에서 관리할 수 있습니다.
## 기록된 쿼리 관리
기록된 쿼리는 기본 설정의 기록된 쿼리 탭에서 활성화 및 삭제하거나 일시 중지할 수 있습니다. 기록된 쿼리를 삭제하면 Grafana에서 제거되지만 Prometheus에서 수집된 정보는 그대로 유지됩니다. 기록된 쿼리를 일시 중지하면 다시 시작될 때까지 새 데이터 포인트가 더 이상 수집되지 않습니다.
## 원격 쓰기 대상
원격 쓰기 대상은 기록된 쿼리 데이터 포인트를 쓰는 **Prometheus** 데이터 소스입니다. 원격 쓰기가 활성화된 Prometheus가 필요하며 이 Prometheus에 대한 데이터 소스를 생성해야 합니다.
원격 쓰기 대상을 편집하려면 콘솔 메뉴에서 **기본 설정**의 **기록된 쿼리** 탭에 있는 **원격 쓰기 대상 편집**을 선택하세요. 원격 쓰기가 활성화된 **Prometheus** 데이터 소스를 선택하고 원격 쓰기 경로를 입력하세요니다.