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

PostgreSQL 데이터 소스에 연결

PostgreSQL 데이터 소스를 사용하여 Amazon Aurora PostgreSQL 데이터베이스에서 데이터를 쿼리하고 시각화할 수 있습니다.

데이터 소스 추가

데이터 소스 옵션

최소 시간 간격

$_interval$_interval_ms변수의 하한값입니다. 예를 들어 데이터가 1분마다 기록되는 1m 경우 쓰기 빈도로 설정하는 것이 좋습니다. 대시보드 패널의 데이터 소스 옵션에서 이 옵션을 재정의/구성할 수도 있습니다. 이 값은 숫자 뒤에 유효한 시간 식별자가 오는 형식이어야 합니다 (예: 1m (1분) 또는 (30초)). 30s 지원되는 시간 식별자는 다음과 같습니다.

데이터베이스 사용자 권한

다음 예제 코드는 권한이 제한된 특정 PostgreSQL 사용자를 생성하는 방법을 보여 줍니다.

 CREATE USER grafanareader WITH PASSWORD 'password';
 GRANT USAGE ON SCHEMA schema TO grafanareader;
 GRANT SELECT ON schema.table TO grafanareader;

사용자가 공개 역할에서 원치 않는 권한을 받지 않았는지 확인하십시오.

쿼리 편집기

PostgreSQL 쿼리 편집기는 그래프 또는 싱글스탯 패널의 편집 모드의 메트릭 탭에서 찾을 수 있습니다. 패널 제목을 선택하여 편집 모드로 전환한 다음 편집합니다.

쿼리 편집기에는 쿼리가 실행된 후 패널 편집 모드에 있는 동안 표시되는 생성된 SQL 링크가 있습니다. 선택하면 실행된 원시 보간 SQL 문자열이 확장되어 표시됩니다.

테이블, 시간 열, 지표 열 (FROM) 을 선택합니다.

처음으로 편집 모드로 전환하거나 새 쿼리를 추가하면 Grafana는 타임스탬프 열과 숫자 열이 있는 첫 번째 테이블로 쿼리 빌더를 미리 채우려고 합니다.

FROM 필드에서 Grafana는 데이터베이스 사용자의 테이블을 제안합니다. search_path 내 테이블이나 뷰에 없는 테이블을 선택하려면 다음과 같은 정규화된 이름 (schema.table) 을 수동으로 search_path 입력할 수 있습니다. public.metrics

시간 열 필드는 시간 값이 들어 있는 열의 이름을 나타냅니다. 지표 열 필드의 값 선택은 선택 사항입니다. 값을 선택하면 지표 열 필드가 시리즈 이름으로 사용됩니다.

지표 열 제안에는 텍스트 데이터 유형 (char, varchar, text) 의 열만 포함됩니다. 데이터 유형이 다른 열을 지표 열로 사용하려면 캐스트:를 사용하여 열 이름을 입력할 수 있습니다. ip::text 다음과 같은 hostname || ' ' || container_name 텍스트 데이터 유형으로 평가되는 임의의 SQL 표현식을 메트릭 열 필드에 입력할 수도 있습니다.

열, 창 및 집계 함수 (SELECT)

SELECT행에서 사용할 열과 함수를 지정할 수 있습니다. 열 필드에 다음과 같은 column1 * column2 / column3 열 이름 대신 임의의 표현식을 작성할 수 있습니다.

쿼리 편집기에서 사용할 수 있는 함수는 데이터 소스를 구성할 때 선택한 PostgreSQL 버전에 따라 달라집니다. 집계 함수를 사용하는 경우 결과 세트를 그룹화해야 합니다. 집계 함수를 추가하면 편집기가 자동으로 추가합니다. GROUP BY time

편집기는 쿼리의 이 부분을 단순화하고 통합하려고 합니다.

더하기 버튼을 선택하고 메뉴에서 열을 선택하여 값 열을 더 추가할 수 있습니다. 여러 값 열이 그래프 패널에 별도의 시리즈로 표시됩니다.

데이터 필터링 (WHERE)

필터를 추가하려면 WHERE 조건 오른쪽에 있는 더하기 아이콘을 선택합니다. 필터를 선택하고 제거를 선택하여 필터를 제거할 수 있습니다. 현재 선택한 시간 범위의 필터가 새 쿼리에 자동으로 추가됩니다.

그룹화 기준

시간이나 다른 열을 기준으로 그룹화하려면 GROUP BY 행 끝에 있는 더하기 아이콘을 선택합니다. 제안 드롭다운 목록에는 현재 선택한 테이블의 텍스트 열만 표시되지만 원하는 열을 수동으로 입력할 수 있습니다. 항목을 선택한 다음 제거를 선택하여 그룹을 제거할 수 있습니다.

그룹화를 추가하는 경우 선택한 모든 열에 집계 함수가 적용되어야 합니다. 그룹화를 추가할 때 쿼리 작성기는 집계 함수 없이 모든 열에 집계 함수를 자동으로 추가합니다.

갭 메우기

Amazon Managed Grafana는 시간별로 그룹화할 때 누락된 값을 채울 수 있습니다. time 함수는 두 개의 인수를 받아들입니다. 첫 번째 인수는 그룹화 기준으로 사용할 시간 창이고, 두 번째 인수는 Grafana가 누락된 항목을 채우는 데 사용할 값입니다.

텍스트 편집기 모드 (RAW)

햄버거 아이콘을 선택하고 편집기 모드 전환을 선택하거나 쿼리 아래의 SQL 편집을 선택하여 원시 쿼리 편집기 모드로 전환할 수 있습니다.

매크로

쿼리 내에서 매크로를 사용하여 구문을 단순화하고 동적 부분을 허용할 수 있습니다.

테이블 쿼리

쿼리 옵션이 테이블 형식으로 설정된 경우 기본적으로 모든 유형의 SQL 쿼리를 수행할 수 있습니다. 테이블 패널에는 쿼리가 반환하는 모든 열과 행의 결과가 자동으로 표시됩니다.

일반 as SQL 열 선택 구문을 사용하여 테이블 패널 열의 이름을 제어할 수 있습니다.

시계열 쿼리

예를 들어Time series, 그래프 패널에서 사용하기 위해 Format을 로 설정하는 경우 쿼리는 SQL 날짜/시간 또는 Unix Epoch를 나타내는 숫자 데이터 유형을 time 반환하는 이름이 지정된 열을 반환해야 합니다. time및 metric 를 제외한 모든 열은 값 열로 취급됩니다. 값 열의 지표 이름으로 사용되는 이름이 지정된 metric 열을 반환할 수 있습니다. 여러 개의 값 열과 이름이 지정된 열을 반환하는 metric 경우 이 열이 시리즈 이름의 접두사로 사용됩니다.

시계열 쿼리의 결과 세트는 시간을 기준으로 정렬해야 합니다.

다음 예제 코드는 metric 열을 보여줍니다.

SELECT
  $__timeGroup("time_date_time",'5m'),
  min("value_double"),
  'min' as metric
FROM test_data
WHERE $__timeFilter("time_date_time")
GROUP BY time
ORDER BY time

다음 코드 예제는 $__TimeGroup 매크로에서 fill 매개 변수를 사용하여 널 값을 대신 0으로 변환하는 방법을 보여줍니다.

SELECT
  $__timeGroup("createdAt",'5m',0),
  sum(value) as value,
  measurement
FROM test_data
WHERE
  $__timeFilter("createdAt")
GROUP BY time, measurement
ORDER BY time

다음 예제 코드는 여러 열을 보여줍니다.

SELECT
  $__timeGroup("time_date_time",'5m'),
  min("value_double") as "min_value",
  max("value_double") as "max_value"
FROM test_data
WHERE $__timeFilter("time_date_time")
GROUP BY time
ORDER BY time

템플릿 작성

메트릭 쿼리에 서버, 애플리케이션, 센서 이름 등을 하드코딩하는 대신 변수를 대신 사용할 수 있습니다. 변수는 대시보드 상단의 드롭다운 선택 상자로 표시됩니다. 이 드롭다운 상자를 사용하여 대시보드에 표시되는 데이터를 변경할 수 있습니다.

템플릿 및 템플릿 변수에 대한 자세한 내용은 을 참조하십시오. 템플릿

쿼리 변수

이 유형의 템플릿 변수를 추가하면 드롭다운 선택 상자로 표시되는 측정 이름Query, 키 이름 또는 키 값 등을 반환할 수 있는 PostgreSQL 쿼리를 작성할 수 있습니다.

예를 들어 템플릿 변수 Query 설정에서 이와 같은 쿼리를 지정하면 테이블의 hostname 열에 대한 모든 값을 포함하는 변수를 만들 수 있습니다.

SELECT hostname FROM host

쿼리는 여러 열을 반환할 수 있으며 Grafana는 해당 열을 기반으로 목록을 자동으로 생성합니다. 예를 들어 다음 쿼리는 및 값이 포함된 목록을 반환합니다. hostname hostname2

SELECT host.hostname, other_host.hostname2 FROM host JOIN other_host ON host.city = other_host.city

$__timeFilter(column)쿼리에서와 같이 시간 범위 종속 매크로를 사용하려면 템플릿 변수의 새로 고침 모드를 On Time Range Change로 설정해야 합니다.

SELECT event_name FROM event_log WHERE $__timeFilter(time_column)

또 다른 옵션은 키/값 변수를 만들 수 있는 쿼리입니다. 쿼리는 이름이 __text 및 인 열 두 개를 반환해야 합니다. __value __text열 값은 고유해야 합니다 (고유하지 않은 경우 첫 번째 값이 사용됨). 드롭다운 목록의 옵션에는 텍스트로 친숙한 이름을 텍스트로, id를 값으로 사용할 수 있는 텍스트와 값이 있습니다. 텍스트와 hostname 값을 사용하는 예제 쿼리는 id 다음과 같습니다.

SELECT hostname AS __text, id AS __value FROM host

중첩 변수를 만들 수도 있습니다. 라는 region 변수를 사용하여 hosts 변수에 현재 선택한 지역의 호스트만 표시하도록 할 수 있습니다. 다음 코드 예제는 다음과 같은 쿼리를 보여줍니다. 다중 값 변수인 경우 region 여러 값을 = 비교하는 대신 IN 비교 연산자를 사용하십시오.

SELECT hostname FROM host  WHERE region IN($region)

쿼리 변수에서 결과를 __searchFilter 필터링하는 데 사용

쿼리 __searchFilter 필드에 사용하면 사용자가 드롭다운 선택 상자에 입력한 내용을 기반으로 쿼리 결과가 필터링됩니다. 사용자가 아무것도 입력하지 않은 경우 의 기본값은 __searchFilter 입니다%.

다음 예제는 쿼리 필드의 __searchFilter 일부로 사용하여 사용자가 드롭다운 선택 상자에 입력하는 hostname 동안 검색을 활성화하는 방법을 보여줍니다.

SELECT hostname FROM my_host  WHERE hostname LIKE '$__searchFilter'

쿼리에 변수 사용

템플릿 변수 값은 템플릿 변수가 multi-value a인 경우에만 인용됩니다.

변수가 다중 값 변수인 경우 여러 값을 = 비교하는 대신 IN 비교 연산자를 사용하십시오.

다음과 같은 두 가지 구문이 있습니다.

$<varname>이름이 지정된 hostname 템플릿 변수를 사용한 예:

SELECT
  atimestamp as time,
  aint as value
FROM table
WHERE $__timeFilter(atimestamp) and hostname in($hostname)
ORDER BY atimestamp ASC

[[varname]]이름이 지정된 템플릿 변수를 사용한 예hostname:

SELECT
  atimestamp as time,
  aint as value
FROM table
WHERE $__timeFilter(atimestamp) and hostname in([[hostname]])
ORDER BY atimestamp ASC

다중 값 변수에 대한 인용 끄기

Amazon Managed Grafana는 다중 값 변수에 대해 따옴표로 구분된 쉼표로 구분된 문자열을 자동으로 생성합니다. 예: server01 와 를 선택하면 다음과 server02 같은 형식이 지정됩니다. 'server01', 'server02' 인용 기능을 끄려면 변수에 대한 csv 형식 지정 옵션을 사용하십시오.

${servers:csv}

가변 형식 옵션에 대한 자세한 내용은 을 참조하십시오. 템플릿 및 변수

주석

주석을 사용하여 그래프 위에 풍부한 이벤트 정보를 오버레이할 수 있습니다. 대시보드 메뉴/주석 보기를 통해 주석 쿼리를 추가합니다. 자세한 정보는 주석을 참조하세요.

다음 예제 코드는 에포크 값이 있는 시간 열을 사용하는 쿼리를 보여줍니다.

SELECT
  epoch_time as time,
  metric1 as text,
  concat_ws(', ', metric1::text, metric2::text) as tags
FROM
  public.test_data
WHERE
  $__unixEpochFilter(epoch_time)

다음 예제 코드는 에포크 값이 있는 시간 및 타임엔드 열을 사용하는 지역 쿼리를 보여줍니다.

SELECT
  epoch_time as time,
  epoch_time_end as timeend,
  metric1 as text,
  concat_ws(', ', metric1::text, metric2::text) as tags
FROM
  public.test_data
WHERE
  $__unixEpochFilter(epoch_time)

다음 예제 코드는 네이티브 SQL 날짜/시간 데이터 유형의 시간 열을 사용하는 쿼리를 보여줍니다.

SELECT
  native_date_time as time,
  metric1 as text,
  concat_ws(', ', metric1::text, metric2::text) as tags
FROM
  public.test_data
WHERE
  $__timeFilter(native_date_time)

알림

시계열 쿼리는 경고 조건에서 작동해야 합니다. 테이블 형식의 쿼리는 경고 규칙 조건에서 아직 지원되지 않습니다.