본문으로 건너뛰기

CUBRID 모니터링

exemONE CUBRID 데이터베이스 모니터링 상세 가이드

1. 지원 버전​

CUBRID 버전지원 여부비고
CUBRID 9.2.1 이상✅ 지원기본 모니터링
CUBRID 10.2.8 이상✅ 지원Session SQL Text 수집 지원

  • CUBRID 9.2.1 이상부터 기본 모니터링이 가능합니다.
  • Session SQL Text 수집은 CUBRID 10.2.8 이상에서만 지원됩니다.

2. 필수 권한​

CUBRID 모니터링은 CMS(CUBRID Manager Server) 계정에 모니터링 권한이 부여되어야 합니다.

  • RESTful API 호출 방식으로 브로커 및 DB 데이터를 수집합니다.
  • CMS 계정 정보와 DB 계정 정보가 각각 필요합니다.

3. 모니터링 등록 방법​

DB 인스턴스 등록 시 CMS 정보와 DB 정보 두 가지가 필요합니다.

Step 1) Instance Group 생성​

Setting > Database > Instance Group에서 CUBRID로 그룹을 생성합니다.

Step 2) CMS 정보 입력​

노란색 영역에 CMS 정보(모니터링 권한이 부여된 사용자 계정 정보)를 입력합니다.

Step 3) DB 정보 입력​

빨간색 영역에 DB 정보(DB 사용자 계정 정보)를 입력합니다.

4. Slow Query 수집 설정​

4-1. 지원 버전​

exemONE 아래 버전 이상이 필요합니다:

모듈버전
exemone-db-agentv3.0.506.15.1
exemone-ingesterv3.0.506.15.1
exemone-corev3.0.506.15.3

4-2. 사전 조건​

  • CUBRID에 Slow Query 설정이 되어 있어야 합니다. (CUBRID 자체에서 Slow Query 로깅이 활성화되어 있어야 함)

4-3. exemONE 설정 단계​

Step 1) CUBRID 모니터링 등록​

  • CUBRID 인스턴스를 등록합니다.
  • OS Resource는 db-agent로 설정 후 등록합니다.

Step 2) Log Path 추가​

Setting > Log > Path에서 패스를 추가합니다.

Step 3) 로그 설정​

아래와 같이 설정합니다:

  • 로그 유형: CUBRID
  • 로그 형식: Broker - Slow SQL
  • 파일 패스: Slow Query가 기록되는 파일 경로

하단의 컨피그와 필터 키 설정 값은 영향 없습니다.

Step 4) 로깅 활성화​

Setting > Log > 로깅 추가에서 대상 인스턴스와 Step 3에서 생성한 Path를 설정한 후 Logging Enable을 설정합니다.

Step 5) Access Log 확인​

Access Log에서 'Success'를 확인합니다.

Step 6) cubrid_slow 테이블 수집 확인​

cubrid_slow 테이블에서 데이터 수집을 확인합니다. 현재 개발된 범위에서 수집되는 항목은 다음과 같습니다:

*** SERVER EXECUTION STATISTICS *** 
Num_data_page_fetches
Num_data_page_io_reads
Num_query_inserts
Num_query_updates
Num_query_deletes
Num_query_selects

5. 모니터링 확인​

Instance Detail Slide​

(1) Information​

항목내용
AgentInstance Name, Status, Instance Group Name, DB Engine, DB Version
Broker MapCUBRID 데이터베이스 기준으로 관계가 있는 브로커 리스트 표시. 클릭 시 브로커 디테일 슬라이드 노출

(2) Metric​

지표설명
Active TranlistActive 상태의 트랜잭션 수
Lock Wait TranlistLock 대기 상태인 트랜잭션 수
Num Data Page Fetches가져오기(fetch)한 페이지 개수
Num Data Page I/O Reads디스크에서 읽은 페이지 수
Time HA Replication Delay복제 지연 시간(초)
Data Page Buffer Hit Ratio (%)데이터 페이지 버퍼의 히트율
XASL Plan Hit Rate (%)Plan Cache Hit율
Filter Predicate Hit Rate (%)Filter Predicate Hit율

(3) Active Session​

실행 중인 Active Session 목록을 실시간으로 확인합니다. Multi Kill 기능을 통해 세션 종료가 가능합니다.

(4) Lock Info​

Lock 대기 중인 세션 목록을 확인하고 Multi Kill로 세션 종료가 가능합니다.

(5) Alert​

알람 규칙 목록과 최근 발생 Alert 상태를 List View 또는 Bar View 형태로 확인합니다.

(6) Host Process List​

DB 서버의 프로세스 목록(PID, PPID, Process Name, CPU %, Memory 등)을 실시간 모니터링합니다.

참고 문서: