쿼리 - Amazon Managed Grafana
쿼리 에디터쿼리 구문쿼리 탭 UI패널 간 쿼리 결과 공유

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

쿼리

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

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

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

Grafana 작업 공간 패널은 쿼리를 사용하여 데이터 소스와 통신하여 시각화에 필요한 데이터를 가져옵니다. 쿼리는 데이터 소스에서 사용되는 쿼리 언어로 작성된 질문입니다. 쿼리가 제대로 구성되면 데이터 원본이 응답합니다. 패널 데이터 원본 옵션에서 쿼리를 데이터 원본으로 보내는 빈도와 수집되는 데이터 요소 수를 조정할 수 있습니다.

Grafana 작업 공간은 패널당 최대 26개의 쿼리를 지원합니다.

쿼리 에디터

쿼리 편집기는 쿼리 작성에 도움이 되는 양식입니다. 데이터 원본에 따라 쿼리 편집기는 자동 완성, 지표 이름 또는 변수 제안을 제공할 수 있습니다.

쿼리 언어 간의 차이로 인해 데이터 원본의 쿼리 편집기가 다르게 보일 수 있습니다.

쿼리 구문

데이터 원본에는 데이터를 요청하는 다양한 쿼리 언어와 구문이 있습니다. 다음은 두 가지 쿼리 예시입니다.

PostgreSQL 


SELECT hostname FROM host WHERE region IN($region)

PromQL 


query_result(max_over_time(<metric>[${__range_s}s]) != <state>)

데이터 원본에 대한 쿼리를 작성하는 방법에 대한 자세한 내용은 해당 데이터 원본의 설명서를 참조하십시오. 데이터 원본은 에 나열되어 데이터 원본에 연결 있습니다.

쿼리 탭 UI

쿼리 탭은 다음 요소로 구성되어 있습니다.

  • 데이터 소스 선택기

  • 쿼리 옵션

  • 쿼리 인스펙터 버튼

  • 쿼리 에디터 목록

데이터 소스 셀렉터

데이터 소스 선택기는 드롭다운 목록입니다. 선택한 데이터 소스를 선택하여 추가한 데이터 소스를 선택합니다. 패널을 생성하면 Amazon Managed Grafana가 자동으로 기본 데이터 소스를 선택합니다. 데이터 소스에 대한 자세한 내용은 을 참조하십시오. 데이터 원본에 연결

Grafana 작업 공간에서 구성한 데이터 소스 외에도 세 가지 특수 데이터 소스를 사용할 수 있습니다.

  • TestDataDB — 랜덤 워크 데이터를 생성하는 내장 데이터 소스입니다. Grafana 데이터 소스는 시각화를 테스트하고 실험을 실행하는 데 유용합니다.

  • 혼합 — 동일한 패널에서 여러 데이터 소스를 쿼리하기 위한 데이터 소스입니다. 이 데이터 원본을 선택하면 새로 추가하는 모든 쿼리에 대해 데이터 원본을 선택할 수 있습니다.

    • 첫 번째 쿼리는 혼합을 선택하기 전에 선택한 데이터 소스를 사용합니다.

    • 혼합 데이터 원본을 사용하도록 기존 쿼리를 변경할 수 없습니다.

  • 대시보드 - 동일한 대시보드의 다른 패널에 있는 결과 세트를 사용하기 위한 데이터 소스입니다.

쿼리 옵션

선택한 데이터 원본의 설정을 보려면 데이터 원본 선택기 옆의 쿼리 옵션을 선택합니다. 여기서 변경한 내용은 이 패널에서 만든 쿼리에만 영향을 줍니다.

Amazon Managed Grafana는 짙은 회색 텍스트로 표시되는 기본값을 설정합니다. 변경 사항은 흰색 텍스트로 표시됩니다. 필드를 기본 설정으로 되돌리려면 필드에서 흰색 텍스트를 삭제하십시오.

다음과 같은 패널 데이터 소스 쿼리 옵션을 사용할 수 있습니다.

  • 최대 데이터 포인트 — 데이터 소스에서 지원하는 경우 반환되는 각 시리즈의 최대 데이터 포인트 수를 설정합니다. 쿼리에서 최대 데이터 요소 설정보다 많은 데이터 요소를 반환하는 경우 데이터 원본은 데이터 요소를 통합합니다. 즉, 평균, 최대값 또는 기타 함수를 기준으로 데이터를 집계하여 반환되는 데이터 요소 수를 줄입니다.

    포인트 수를 제한하는 주된 이유는 성능과 라인 평활화라는 두 가지입니다. 디폴트 값은 그래프의 너비 (또는 픽셀 수) 이며, 이 값을 사용하면 그래프 패널에 표시할 수 있는 것보다 많은 데이터 포인트가 포함되지 않습니다.

    스트리밍 데이터의 경우 최대 데이터 포인트 값이 롤링 버퍼에 사용됩니다. (스트리밍은 연속적인 데이터 흐름이고 버퍼링은 스트림을 여러 청크로 나누는 방법입니다.)

  • 최소 간격 - 자동으로 계산되는 간격의 최소 제한 (일반적으로 최소 스크랩 간격) 을 설정합니다. 데이터 포인트가 15초마다 저장되는 경우 간격이 그보다 낮을 필요는 없습니다. 또 다른 사용 사례는 스크랩 간격보다 최소값을 높게 설정하여 더 정확하고 제대로 작동하는 쿼리를 얻는 것입니다.

  • 간격 — 시간별로 데이터 포인트를 집계하거나 그룹화할 때 사용할 수 있는 시간 범위입니다.

    Amazon Managed Grafana는 템플릿 쿼리에서 변수로 사용할 수 있는 적절한 간격을 자동으로 계산합니다. 변수는 초 단위:$__interval; 또는 밀리초 단위입니다. $__interval_ms 일반적으로 또는 와 같은 sum 집계 함수에 사용됩니다. average 예를 들어, 다음은 간격 변수:를 사용하는 Prometheus 쿼리입니다. rate(http_requests_total[$__interval])

    이 자동 간격은 그래프 너비를 기준으로 계산됩니다. 사용자가 많이 축소하면 간격이 더 길어져 집계가 더 거칠어집니다. 사용자가 확대하면 간격이 줄어들어 집계가 더 세밀해집니다.

    자세한 정보는 전역 변수을 참조하세요.

  • 상대 시간 — 개별 패널의 상대 시간 범위를 재정의하여 각 패널이 대시보드 오른쪽 상단의 대시보드 시간 선택기에서 선택한 것과 달라지도록 합니다. 이렇게 하면 여러 기간 또는 날짜의 지표를 동일한 대시보드에 표시할 수 있습니다.

  • 시간 이동 — 개별 패널의 시간 범위를 재정의할 수 있는 또 다른 방법을 제공합니다. 이 기능은 상대적 시간 범위에서만 작동하며 시간 범위를 조정할 수 있습니다.

    예를 들어 패널의 시간 범위를 대시보드 시간 선택기보다 2시간 빠르도록 변경할 수 있습니다. 자세한 정보는 시간 범위 제어을 참조하세요.

  • 캐시 타임아웃 — (이 필드는 데이터 원본에서 사용할 수 있는 경우에만 표시됩니다.) 시계열 저장소에 쿼리 캐시가 있는 경우 기본 캐시 제한 시간을 재정의합니다. 이 값은 초 단위의 숫자 값으로 지정됩니다.

쿼리 인스펙터 버튼

쿼리 관리자를 선택하여 패널 검사기의 쿼리 탭을 열 수 있습니다. 쿼리 탭에서 패널이 보낸 쿼리 요청과 응답을 볼 수 있습니다.

이 패널에서 서버로 보낸 요청의 전체 텍스트를 보려면 [새로 고침] 을 선택합니다.

참고

쿼리 인스펙터가 결과를 반환하려면 먼저 하나 이상의 쿼리를 추가해야 합니다.

패널 검사기에 대한 자세한 내용은 을 참조하십시오. 패널 검사

쿼리 편집기 목록

UI에서 쿼리는 접을 수 있는 쿼리 행으로 구성됩니다. 각 쿼리 행에는 쿼리 편집기가 포함되어 있으며 문자 (A, B, C 등) 로 식별됩니다.

패널 간 쿼리 결과 공유

Amazon Managed Grafana를 사용하면 한 패널의 쿼리 결과를 대시보드의 다른 패널에 사용할 수 있습니다. 패널 간에 쿼리 결과를 공유하면 데이터 소스에 대한 쿼리 수가 줄어들어 대시보드의 성능이 향상될 수 있습니다.

대시보드 데이터 소스를 사용하면 결과를 공유하려는 쿼리가 포함된 대시보드 패널을 대시보드에서 선택할 수 있습니다. Amazon Managed Grafana는 각 패널에 대해 별도의 쿼리를 보내는 대신 하나의 쿼리를 전송하고 다른 패널은 쿼리 결과를 사용하여 시각화를 구성합니다.

예를 들어 여러 패널이 동일한 데이터를 시각화하는 경우 이 전략을 사용하면 쿼리 수를 크게 줄일 수 있습니다.

데이터 소스 쿼리를 다른 패널과 공유하려면

  1. 대시보드 만들기 자세한 정보는 대시보드 생성을 참조하세요.

  2. 패널 추가. 자세한 정보는 패널 추가을 참조하세요.

  3. 제목을 로 변경합니다Source panel. 이 패널을 다른 패널의 소스로 사용하게 됩니다. 공유할 쿼리를 하나 또는 여러 개 정의하십시오. 현재 사용 가능한 데이터 소스가 없는 경우 테스트에 사용할 수 있는 임의의 시계열을 반환하는 Grafana 데이터 소스를 사용할 수 있습니다.

  4. 두 번째 패널을 추가한 다음 쿼리 편집기에서 대시보드 데이터 원본을 선택합니다.

  5. 패널 결과 사용 목록에서 생성한 첫 번째 패널을 선택합니다.

이제 소스 패널에 정의된 모든 쿼리를 새 패널에서 사용할 수 있습니다. 소스 패널에서 만든 쿼리를 여러 패널과 공유할 수 있습니다.

쿼리가 정의된 패널로 이동하려면 해당 쿼리를 선택합니다.