기록된 쿼리

이 설명서 항목은 Grafana 버전 8.x를 지원하는 Grafana 작업 영역을 위해 설계되었습니다.

Grafana 버전 10.x를 지원하는 Grafana 작업 영역에 대한 내용은 을 참조하십시오. Grafana 버전 10에서 작업하기

Grafana 버전 9.x를 지원하는 Grafana 작업 영역에 대한 내용은 을 참조하십시오. Grafana 버전 9에서 작업하기

기록된 쿼리를 사용하여 일정 간격으로 데이터 포인트의 스냅샷을 찍으면 시간 경과에 따른 추세를 확인할 수 있습니다. 이를 통해 과거 동향을 파악할 수 있습니다.

시계열을 반환하지 않는 플러그인의 경우 과거 데이터를 도표화하는 것이 유용할 수 있습니다. 예를 들어 요청 응답 시간 기록을 확인하기 ServiceNow위해 쿼리하고 싶지만 현재 point-in-time 지표만 반환할 수 있습니다.

기록된 쿼리의 작동 방식

기록된 쿼리는 백엔드 데이터 소스 플러그인에서만 작동합니다. 자세한 내용은 백엔드 데이터 소스 플러그인을 참조하십시오. 세 가지 유형의 쿼리를 기록할 수 있습니다.

• 단일 행 및 열 - 단일 행과 열을 반환하는 쿼리입니다.

• 행 개수 - 계산할 의미 있는 행을 반환하는 쿼리입니다.

• 표현식 - 모든 표현식 식을 만들고 사용하는 방법에 대해 자세히 알아보려면 표현식을 참조하십시오.

기록된 쿼리가 생성되거나 활성화되면 즉시 스냅샷이 생성되고 설정된 간격에 따라 스냅샷이 계속 생성됩니다. 기록된 쿼리는 비활성화, 삭제 또는 Grafana가 실행되지 않을 때 스냅샷 촬영을 중지합니다. 기록된 쿼리를 실행하고 각 결과를 원격 쓰기 기능이 있는 Prometheus 인스턴스로 전달하여 백엔드에서 데이터 포인트를 수집합니다.

참고

기록된 쿼리를 사용하려면 먼저 Prometheus 데이터 소스를 구성하고 원격 쓰기 대상에 연결해야 합니다.

기록된 쿼리 생성

기록된 쿼리를 만들려면 다음 단계를 완료하세요.

1. 대시보드에 기록하려는 쿼리를 편집 패널에서 찾거나 생성합니다. 쿼리는 행과 열을 하나만 반환해야 합니다. 더 많이 반환되는 경우에도 count 옵션을 사용하여 반환된 결과 수를 기록할 수 있습니다. 쿼리의 데이터 원본은 백엔드 데이터 원본이어야 합니다. 식을 사용하여 시계열 쿼리의 데이터를 집계할 수 있습니다. 식을 만들고 사용하는 방법에 대한 자세한 내용은 식을 참조하십시오.

2. 쿼리 편집기에 있는 쿼리 레코드 메뉴를 선택합니다.

3. 기록된 쿼리 정보를 입력합니다. 달리 명시되지 않는 한 모든 필드는 필수입니다.

   • 이름 - 기록된 쿼리의 이름.

   • 설명 - (선택 사항) 기록된 쿼리 목록에 표시하려는 대로 기록된 쿼리를 설명합니다.

   • 간격 - 스냅샷을 찍을 간격입니다. 이 간격은 기록된 쿼리를 생성할 때 시작되고 기록된 쿼리를 일시 중지하거나 삭제하면 중지됩니다. 기록된 쿼리를 일시 중지하고 삭제하는 방법에 대한 자세한 내용은 기록된 쿼리 관리를 참조하십시오.

   • 범위 - 쿼리의 상대적 시간 범위입니다. 범위 30m, 간격 1h를 선택하면 쿼리는 지난 30분 동안 1시간마다 스냅샷을 찍습니다.

   • 쿼리 결과 계산 - 쿼리에서 반환된 행을 세려면 이 옵션을 켜십시오. 이 옵션을 끄면 쿼리에서 값이 하나인 행 하나를 반환해야 합니다.

4. 기록된 쿼리 테스트 버튼을 선택하여 기록된 쿼리를 테스트합니다.

5. 쿼리 녹화 시작을 선택합니다.

기록된 쿼리 추가

기록된 기존 쿼리를 대시보드의 패널에 추가할 수 있습니다. 기록된 쿼리를 추가할 때마다 Prometheus 쿼리가 생성됩니다. generated_recorded_query_name{id="generated_id", name="recorded query name"} Prometheus에서 생성된 쿼리는 기록된 쿼리의 수집된 모든 스냅샷을 반환합니다.

1. 기록된 쿼리를 추가하려는 대시보드의 패널로 이동합니다.

2. + 기록된 쿼리 메뉴를 선택합니다.

3. 기록된 쿼리를 데이터 소스별로 필터링하려면 데이터 소스별 필터링 드롭다운 메뉴에서 데이터 소스를 선택합니다.

4. 기록된 쿼리에서 추가 메뉴를 선택하여 패널에 추가합니다.

기록된 쿼리를 패널에 추가하면 패널 데이터 소스가 됩니다-- Mixed --. 기록된 쿼리는 기록된 Prometheus 쿼리 이름과 일치하는 이름 레이블이 있는 쿼리로 표시됩니다. Prometheus 데이터 소스에 대한 자세한 내용은 Prometheus를 참조하십시오.

기록된 쿼리를 추가한 후 Prometheus -- Mixed -- 데이터 소스 대신 데이터 소스를 사용하는 쿼리가 나타나면 기록된 쿼리에 대해 원격 쓰기 타겟이 설정되지 않았음을 Prometheus 의미할 수 있습니다. 원격 쓰기 지점을 설정하려면 원격 쓰기 대상을 참조하십시오.

기록된 쿼리 사용

기록된 쿼리를 사용하려면 쿼리를 만들어 대시보드에 추가하세요. 그런 다음 기록된 쿼리 탭의 기본 설정에서 관리할 수 있습니다.

기록된 쿼리 관리

기록된 쿼리는 환경설정의 기록된 쿼리 탭에서 일시 중지하거나 활성화하고 삭제할 수 있습니다. 기록된 쿼리를 삭제하면 Grafana에서 삭제되지만 Prometheus에서 수집한 정보는 그대로 유지됩니다. 기록된 쿼리를 일시 중지해도 다시 시작할 때까지 더 이상 새 데이터 포인트를 수집하지 않습니다.

원격 쓰기 타겟

원격 쓰기 타겟은 기록된 쿼리 데이터 포인트가 기록되는 Prometheus 데이터 소스입니다. 원격 쓰기가 활성화된 Prometheus가 필요하며 이 Prometheus에 대한 데이터 소스를 생성해야 합니다.

원격 쓰기 대상을 편집하려면 환경설정의 기록된 쿼리 탭에 있는 콘솔 메뉴에서 원격 쓰기 대상 편집을 선택합니다. 원격 쓰기가 활성화된 Prometheus 데이터 소스를 선택하고 원격 쓰기 경로를 입력합니다.