PostgreSQL 데이터 소스

PostgreSQL 데이터 소스 (PostgreSQL data source)

PostgreSQL 호환 데이터베이스의 데이터를 쿼리·시각화할 수 있어요. 시각 쿼리 빌더 또는 원시 SQL로 대시보드를 만들고, 테이블을 실시간으로 탐색하며, 애노테이션을 오버레이하고, 같은 연결에서 알림을 만들 수 있어요. 셀프 매니지드 PostgreSQL과 Amazon RDS, Amazon Aurora, Azure Database for PostgreSQL, Google Cloud SQL 같은 관리형 서비스에서 작동해요. Grafana에 기본 포함되어 사전 설치돼요.

출처: 문서

본문

지원 데이터베이스

PostgreSQL 9.0 이상
Amazon RDS for PostgreSQL
Amazon Aurora PostgreSQL
Azure Database for PostgreSQL
Google Cloud SQL for PostgreSQL

핵심 기능

시계열 쿼리: 내장 시간 그룹화 매크로로 메트릭 시각화.
표 쿼리: 유효한 모든 SQL 쿼리를 표 형식으로 표시.
EXPLAIN 쿼리: 쿼리 편집기에서 직접 쿼리 실행 계획 검사.
템플릿 변수: 내장 변수 쿼리 편집기로 동적 대시보드 생성.
애노테이션: PostgreSQL 이벤트를 대시보드 패널에 오버레이.
알림: PostgreSQL 쿼리 결과 기반 알림 생성(시계열 형식만).
매크로: 시간 필터링·그룹화용 내장 매크로로 쿼리 단순화.

지원 PostgreSQL 데이터 타입

PostgreSQL 플러그인은 PGX 드라이버를 사용해 연결해요. 지원되는 타입:

숫자형: int2, int4, int8, float4, float8, numeric
문자열형: text, varchar, char, bpchar
날짜/시간형: timestamp, timestamptz, date, time, timetz, interval
불리언: bool
JSON형: json, jsonb
열거형: 커스텀 enum 타입은 문자열 값으로 반환.
기타: 명시적으로 매핑되지 않은 타입(배열, 복합, 커스텀 도메인 등)은 문자열 값으로 반환.

시작하기

PostgreSQL 데이터 소스 구성 — 인증 설정과 PostgreSQL 연결.
PostgreSQL 쿼리 편집기 — 시계열, 표, EXPLAIN 형식으로 쿼리 생성·편집.
템플릿 변수 — PostgreSQL 변수로 동적 대시보드 생성.
애노테이션 — 대시보드 그래프에 PostgreSQL 이벤트 오버레이.
알림 — PostgreSQL 쿼리 결과 기반 알림 생성.
문제 해결 — 흔한 구성·쿼리 오류 해결.

추가 기능

그래프에 PostgreSQL 이벤트를 오버레이하는 애노테이션 추가.
시계열 쿼리 기반 알림 규칙 설정.
대시보드 없이 Explore로 PostgreSQL 데이터 조사.
쿼리 결과를 처리하는 변환 추가.

플러그인 업데이트

Grafana v13.2부터 PostgreSQL 데이터 소스는 독립 플러그인으로 사전 설치돼 Grafana 릴리스와 무관하게 더 자주 업데이트할 수 있어요. 자동 업데이트 거부는 preinstall_auto_update를 false로, 수동 업데이트는 Administration > Plugins에서. Grafana 12.3.x~13.1.x에서 독립 플러그인을 쓰려면:

[plugin.grafana-postgresql-datasource]
as_external = true

[plugins]
; Install the latest version on startup:
preinstall_sync = grafana-postgresql-datasource
; Or install a specific version:
; preinstall_sync = grafana-postgresql-datasource@<version>

PostgreSQL 데이터 소스