데이터 쿼리 및 변환 - Amazon Managed Grafana
쿼리 정보쿼리 탭 탐색쿼리 추가쿼리 관리쿼리 옵션

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

데이터 쿼리 및 변환

이 설명서 주제는 Grafana 버전 9.x를 지원하는 Grafana 워크스페이스를 위해 설계되었습니다.

Grafana 버전 10.x를 지원하는 Grafana 워크스페이스의 경우 Grafana 버전 10에서 작업 섹션을 참조하세요.

Grafana 버전 8.x를 지원하는 Grafana 워크스페이스의 경우 Grafana 버전 8에서 작업 섹션을 참조하세요.

Grafana는 다양한 유형의 데이터 소스를 지원합니다. 데이터 소스 쿼리는 Grafana에서 변환하고 시각화할 수 있는 데이터를 반환합니다. 각 데이터 소스는 자체 쿼리 언어를 사용하며, 데이터 소스 플러그인은 각각 쿼리 편집기라고 하는 쿼리 빌드 사용자 인터페이스를 구현합니다.

쿼리 정보

Grafana 패널은 시각화를 위한 데이터를 검색하는 쿼리를 통해 데이터 소스와 통신합니다. 쿼리는 데이터 소스에서 사용하는 쿼리 언어로 작성된 질문입니다.

패널의 데이터 소스 옵션에서 쿼리 빈도 및 데이터 수집 제한을 구성할 수 있습니다. Grafana는 패널당 최대 26개의 쿼리를 지원합니다.

각 데이터 소스의 쿼리 언어에 대한 자세한 내용은 데이터 소스 섹션에서 확인할 수 있습니다.

쿼리 편집기

각 데이터 소스의 쿼리 편집기는 고유한 기능을 활용하는 쿼리를 작성하는 데 도움이 되는 사용자 지정 사용자 인터페이스를 제공합니다.

쿼리 언어 간의 차이로 인해 각 데이터 소스 쿼리 편집기는 모양과 기능이 다릅니다. 데이터 소스에 따라 쿼리 편집기는 자동 완성 기능, 지표 이름, 변수 제안 또는 시각적 쿼리 빌드 인터페이스를 제공할 수 있습니다.

특정 데이터 소스의 고유한 쿼리 편집기 기능에 대한 자세한 내용은 해당 설명서를 참조하세요.

쿼리 구문

데이터 소스는 다양한 쿼리 언어를 사용하여 데이터를 요청합니다. 특정 데이터 소스의 고유한 쿼리 언어에 대한 자세한 내용은 해당 설명서를 참조하세요.

PostgreSQL 예제:

SELECT hostname FROM host WHERE region IN($region)

PromQL 예제:

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

특수 데이터 소스

또한 Grafana에는 Grafana, 혼합, 대시보드와 같은 세 가지 특수 데이터 소스도 포함되어 있습니다. 자세한 내용은 데이터 소스를 참조하세요.

쿼리 탭 탐색

패널의 쿼리 탭은 다음 요소로 구성됩니다.

  • 데이터 소스 선택기 - 쿼리할 데이터 소스를 선택합니다.

  • 쿼리 옵션: 최대 데이터 검색 파라미터 및 쿼리 실행 시간 간격을 설정합니다.

  • 쿼리 검사기 버튼: 쿼리를 보고 최적화할 수 있는 쿼리 검사기 패널을 엽니다.

  • 쿼리 편집기 목록: 작성한 쿼리를 나열합니다.

  • 표현식: 표현식 빌더를 사용하여 경고 표현식을 생성합니다. 표현식에 대한 자세한 내용은 표현식 쿼리 쓰기 섹션을 참조하세요.

쿼리 추가

쿼리는 Grafana가 대시보드 패널에서 시각화하는 데이터를 반환합니다. 패널을 생성하면 Grafana에서 기본 데이터 소스를 자동으로 선택합니다.

쿼리를 추가하는 방법

  1. 쿼리를 추가할 패널을 편집하세요.

  2. 쿼리(Query) 탭을 선택합니다.

  3. 데이터 소스 드롭다운 메뉴를 선택하고 데이터 소스를 선택하세요.

  4. 쿼리 옵션을 선택하여 필요한 최대 데이터 포인트 수를 구성하세요. 기타 옵션에 대한 자세한 내용은 쿼리 옵션 섹션을 참조하세요.

  5. 쿼리 편집기를 사용하여 쿼리를 작성하세요.

  6. 적용을 선택합니다.

Grafana에서 데이터 소스를 쿼리하고 데이터를 시각화합니다.

쿼리 관리

Grafana에서는 축소 가능한 쿼리 행으로 쿼리를 구성합니다. 각 쿼리 행에는 쿼리 편집기가 포함되어 있으며 문자(A, B, C 등)로 식별됩니다.

쿼리를 관리하기 위해 쿼리를 복사하고, 쿼리를 숨기며, 쿼리를 제거하고, 쿼리를 재정렬하며, 쿼리 편집기에 대한 도움말을 전환할 수 있습니다.

쿼리 옵션

선택한 데이터 소스에 대한 설정을 보려면 데이터 소스 선택기 옆에 있는 쿼리 옵션을 선택합니다. 여기서 변경한 내용은 이 패널에서 수행된 쿼리에만 영향을 줍니다.

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

패널 데이터 소스 쿼리 옵션은 다음을 포함합니다.

  • 최대 데이터 포인트 - 데이터 소스가 지원하는 경우 반환되는 각 시리즈의 최대 데이터 포인트 수를 설정합니다. 쿼리가 최대 데이터 포인트 설정보다 더 많은 데이터 포인트를 반환하는 경우 데이터 소스는 평균, 최대 또는 다른 함수별로 집계하여 반환되는 포인트 수를 줄입니다.

    포인트 수를 제한하여 쿼리 성능을 개선하거나 시각화된 라인을 평활화할 수 있습니다. 기본값은 그래프의 너비 또는 픽셀 수입니다. 그래프 패널에 표시할 공간이 있는 만큼의 데이터 포인트만 시각화할 수 있기 때문입니다.

    스트리밍 데이터에서 Grafana는 롤링 버퍼에 최대 데이터 포인트 값을 사용합니다. 스트리밍은 데이터의 지속적인 흐름이며 버퍼링은 스트림을 청크로 나눕니다. 예를 들어 Loki에서는 라이브 테일링 모드에서 데이터를 스트리밍합니다.

  • 최소 간격 - 자동으로 계산된 간격의 최소 한도(보통 최소 스크레이프 간격)을 설정합니다. 데이터 포인트를 15초마다 저장하는 경우 간격을 이보다 짧게 설정하지 않아도 됩니다. 또한 보다 대략적이지만 잘 작동하는 쿼리를 가져오기 위해 이 값을 스크레이프 간격보다 더 높은 최솟값으로 설정할 수 있습니다.

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

    Grafana는 템플릿 쿼리에서 변수로 사용할 수 있는 적절한 간격을 자동으로 계산합니다. 변수는 초($__interval) 또는 밀리초($__interval_ms)로 측정됩니다.

    간격은 일반적으로 합계 또는 평균과 같은 집계 함수에 사용됩니다. 예를 들어 간격 변수(rate(http_requests_total[$__interval]))를 사용하는 Prometheus 쿼리입니다.

    이 자동 간격은 그래프의 너비를 기준으로 계산됩니다. 사용자가 시각화를 축소하면 간격이 증가하고 대략적인 집계가 생성됩니다. 마찬가지로 사용자가 확대하면 간격이 감소하고 보다 세분화된 집계가 생성됩니다.

    자세한 내용은 전역 변수 단원을 참조하십시오.

  • 상대 시간 - 대시보드의 오른쪽 상단에 있는 대시보드 시간 선택기에서 선택한 것과 다르게 개별 패널의 상대 시간 범위를 재정의합니다. 이를 사용하여 동일한 대시보드에 서로 다른 기간 또는 일수의 지표를 표시할 수 있습니다.

    참고

    대시보드의 시간 범위가 절대값인 경우 패널 시간 재정의가 영향을 미치지 않습니다.

    예 상대적 시간 필드

    지난 5분

    now-5m

    지금까지 일수

    now/d

    지난 5일

    now-5d/d

    이번 주까지

    now/w

    지난 2년

    now-2y/y

  • 시간 전환 - 시간 선택기에 상대적인 시작 및 종료를 전환하여 개별 패널의 시간 범위를 재정의합니다. 예를 들어 패널의 시간 범위를 대시보드 시간 선택기보다 2시간 빠르게 전환할 수 있습니다.

    참고

    대시보드의 시간 범위가 절대값인 경우 패널 시간 재정의가 영향을 미치지 않습니다.

    예 시간 전환 필드

    지난 주 전체

    1w/w

    2주 전 전체

    2w/w

    지난 달 전체

    1M/M

    올해 한 해 전체

    1d/y

    지난 한 해 전체

    1y/y

  • 캐시 제한 시간 - (데이터 소스에서 사용할 수 있는 경우에만 표시됨) 시계열 저장소에 쿼리 캐시가 있는 경우 기본 캐시 제한 시간을 재정의합니다. 이 값을 초 단위의 숫자 값으로 지정합니다.