exemONE PostgreSQL 모니터링 기능 상세 설명

1. 지원 버전​

2. 필수 권한​

기본 모니터링 권한​

-- PostgreSQL 10 버전 이상 (superuser 권한 부여가 어려운 경우)
GRANT pg_monitor TO exemone;

-- PostgreSQL 10 버전 미만
ALTER USER exemone WITH SUPERUSER;

SQL 데이터 수집 권한​

database2, search_path 옵션에 입력된 DB 및 스키마에 대해 아래 권한 필요

-- SQL 데이터 수집 (database2, search_path 옵션에 입력된 db, schema)
GRANT USAGE ON SCHEMA {schema 명} TO exemone;
GRANT CONNECT ON DATABASE {database 명} TO exemone;

Plan 조회 권한​

GRANT USAGE ON SCHEMA {schema 명} TO exemone;
GRANT SELECT ON {schema 명}.{table 명} TO exemone;

Session Kill 권한​

-- 일반 PostgreSQL
GRANT pg_signal_backend TO exemone;

-- AWS RDS 환경
ALTER USER exemone WITH SUPERUSER;
GRANT rds_superuser TO exemone;

3. 사전 설정 사항​

3-1. 파라미터 설정 (DB 재기동 필요)​

postgresql.conf에 아래 파라미터를 설정합니다.

-- 사용자 정의 함수(PL/pgSQL)에 대한 성능 정보 수집 활성화 (기본값: none)
track_functions = 'pl'

-- SQL 실행 정보를 수집하기 위한 확장 모듈 로드 (기본값: null)
shared_preload_libraries = 'pg_stat_statements'

주의: 위 설정 변경 후 반드시 PostgreSQL 재기동이 필요합니다.

3-2. SQL 실행 정보 수집 설정​

모니터링 대상 DB에 접속하여 아래 설정을 수행합니다.

-- 모니터링 대상 database로 접속
-- 해당 database명은 엑셈원 Setting > Database > Custom Configuration > database2 옵션에 입력 필요
-- public이 아닌 schema를 사용하는 경우, search_path 옵션에도 입력 필요
\c [모니터링 대상 dbname]

-- pg_stat_statements 확장 기능 생성
CREATE EXTENSION pg_stat_statements;

-- (선택) SQL text 길이 제한 옵션 - PostgreSQL 재기동 필요
-- 기본값: 1024 / 권장값: 1048576
-- 단, pg_stat_statements.max(기본: 1000) × track_activity_query_size 바이트만큼 공유 메모리 사용 증가 → 변경 시 주의
track_activity_query_size = 1048576

3-3. exemONE 모니터링 옵션 설정​

경로: Setting > Database > Custom Configuration

4. Single View (PostgreSQL)​

Single View는 실시간으로 특정 하나의 데이터베이스에 대해 다양한 관점에서 성능 상태를 확인할 수 있는 화면입니다.

주요 기능 개요​

• CPU 및 Connection 정보 확인
• Slow Query 분석
• 데이터베이스 성능 지표의 Trend 확인
• 최근 10분 동안 급증한 SQL, Event 지표 확인
• Table/Index Scan 비율 확인
• 사용자 Alert, Vacuum, Replication, Checkpoint 등 주요 관리 포인트 확인
• Temp, Tablespace Size, 변경된 Parameter, 통계정보 등 추가 관리 포인트 확인

화면 구성​

4-1) Grouping Summary​

데이터베이스 지표, Event통계, SQL 실행 정보, Object scan type별 집계 등 다양한 관점의 집계된 데이터를 통해 장애 원인을 추적합니다.

Statistics & Event​

Overview나 Trend 항목에서 비정상적인 상황을 인지했을 때, 최근 급증한 데이터베이스 지표를 확인하여 원인을 추적할 수 있습니다.

• Statistics: PostgreSQL에서 제공하는 성능 관련 지표
• Event: PostgreSQL에서 제공하는 대기 관련 지표

Top Diff Statistics(Sum) for 10 min 최근 10분 데이터를 비교하여 변화량을 기준으로 비율이 가장 높은 지표 Top 5를 보여줍니다. 지표명/변동 비율/변동값 순으로 정보를 확인할 수 있습니다.

5. Multi View (PostgreSQL)​

Multi View는 다수의 PostgreSQL 서버를 모니터링할 수 있는 화면입니다. 하나의 데이터베이스가 선택되면 Overview, DB Session Type, Rank 등 선택된 데이터베이스의 데이터만으로 변경되어 단일 데이터베이스에 대한 집중적인 모니터링이 가능합니다. 상단 브레드크럼을 이용하여 폴더 변경이 가능합니다.

Multi View는 Instance 관점에서의 모니터링 화면으로, 각 Instance 레벨의 지표 및 각 Instance의 내부 Database 지표의 합산값을 모니터링할 수 있습니다.

5-1) Overview​

폴더에 속한 인스턴스의 CPU, Memory, 주요 성능 지표를 함께 확인할 수 있습니다. 목록에서 인스턴스 클릭 시 선택한 인스턴스가 하이라이트 되며, 다른 지표들도 선택한 인스턴스의 데이터를 하이라이트로 볼 수 있습니다.

5-2) DB Session Type​

Active Session, Long Session, Lock Session을 색상으로 구분하여 실시간으로 각 Session 상태의 Count를 확인할 수 있습니다.

5-3) Rank​

주요 성능 6가지를 선별하여 직관적인 모니터링이 가능합니다. 타이틀 클릭 시 인스턴스 별 순위, 등록된 인스턴스들의 성능 데이터를 비교하여 인스턴스 별 비율과 10분 추이를 확인할 수 있습니다.

Vacuum Usage(%)​

Vacuum age 사용률을 보여줍니다. 인스턴스 클릭 시 Dead Tuple 수가 높은 Object를 확인할 수 있는 'Top 10 Object List' 팝업창으로 연계됩니다.

"Top 10 Object List" 우측 상단 Order by 리스트에서 항목 별 (Scan Count, Scan Ratio, Age, Dead Tuple Ratio, Analyze Time) 내림차순으로 정렬할 수 있습니다.

Top 10 Object List Grid

6. Instance Detail Slide (PostgreSQL)​

Instance Detail Slide는 PostgreSQL 인스턴스의 상세 정보를 탭 형식으로 확인하는 화면입니다.

1) Information 탭​

Instance Detail Slide(PostgreSQL)의 Information을 확인하는 화면입니다.

2) Metric 탭​

Instance Detail Slide(PostgreSQL)의 Metric을 확인하는 화면입니다.

3) Active Session 탭​

Instance Detail Slide(PostgreSQL)의 Active Session을 확인하는 화면입니다.

Grid 항목

4) SQL List 탭​

Instance Detail Slide(PostgreSQL)의 SQL List를 확인하는 화면입니다.

Grid 항목

5) Lock Info 탭​

Instance Detail Slide(PostgreSQL)의 Lock Info를 확인하는 화면입니다.

Grid 항목

6) Alert 탭​

Instance Detail Slide(PostgreSQL)의 Alert 로그를 확인하는 화면입니다.

Grid 항목

7) Parameter 탭​

Instance Detail Slide(PostgreSQL)의 Parameter를 확인하는 화면입니다.

Grid 항목

7. Session Detail Slide (연계 화면)​

Instance Detail Slide > Active Session 탭 > PID 클릭 시 나타나는 세션 상세 화면입니다.

Title 영역 상세

8. Session Detail Slide (연계 화면)​

1) Title​

순번	항목	설명
1	Back	클릭 시 디테일 슬라이드가 닫히고 이전 화면을 보여줍니다.
2	SQL ID	조회한 SQL ID, Query ID를 표시합니다.
3	Slide History	디테일 슬라이드 이동 이력을 관리합니다.
4	Close	클릭 시 디테일 슬라이드가 닫힙니다.

2) SQL Information​

3) Full Text 탭​

목적: 선택한 SQL의 전체 텍스트를 확인하고 복사하는 기능

순번	항목	설명
1	Formatting	버튼 클릭 시 하단 텍스트 서식이 정렬됩니다.
2	Copy	아이콘 클릭 시 SQL 전체 텍스트를 복사합니다.

4) Trend 탭​

목적: 선택한 SQL ID의 시간대별 성능 추이를 차트로 분석

5) History 탭​

목적: 선택한 SQL의 시간대별 집계 이력을 분석하여 성능 변화 추적

● History Grid

6) Plan 탭​

목적: SQL 실행 계획(Query Plan)을 확인하여 쿼리 최적화 분석

순번	항목	설명
1	Default Plan	변수 있는 SQL일 경우 '1'로 치환하여 Plan을 조회합니다.
2	Help	[Default Plan] 버튼 우측에 Help 아이콘 을 보여줍니다. 마우스 오버 시 도움말 툴팁이 나타납니다.
3	Copy Icon	클릭 시 텍스트가 복사됩니다.
4	Option	클릭 시 Grid의 옵션을 보여줍니다.
5	Plan	SQL 목록에서 선택한 SQL의 Plan을 보여줍니다.

● Plan Grid

7) Sampling SQL Text 탭​

목적: 실제 수집된 SQL 샘플 텍스트 확인

순번	항목	설명
1	Formatting	버튼 클릭 시 하단 텍스트 서식이 정렬됩니다. Sampling SQL Text 없을 경우 비활성화됩니다.
2	Copy	아이콘 클릭 시 SQL 전체 텍스트를 복사합니다. Sampling SQL Text 없을 경우 비활성화됩니다.
3	Text	Sampling SQL Text가 출력됩니다. Sampling SQL Text가 없을 경우 안내 메시지가 출력됩니다.

9. Parameter Detail Slide (연계 화면)​

Instance Detail Slide > Parameter 탭 > Parameter Name 클릭 시 나타나는 파라미터 상세 화면입니다.

Parameter List Grid

참고 문서

• Single View - PostgreSQL
• Multi View - PostgreSQL
• Instance Detail Slide - PostgreSQL
• Session Detail Slide - PostgreSQL
• Parameter Detail Slide - PostgreSQL
• PostgreSQL 지원 버전
• PostgreSQL 필수 권한
• PostgreSQL 사전 설정
• PostgreSQL 모니터링 옵션