CUBRID 모니터링
exemONE CUBRID 데이터베이스 모니터링 상세 가이드
1. 지원 버전
참고 문서: Cubrid 모니터링 지원 버전, DB Agent 지원 환경
| 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 모니터링 등록
CUBRID 모니터링은 CMS(CUBRID Manager Server) 계정에 모니터링 권한이 부여되어야 합니다.
- RESTful API 호출 방식으로 브로커 및 DB 데이터를 수집합니다.
- CMS 계정 정보와 DB 계정 정보가 각각 필요합니다.
3. 모니터링 등록 방법
참고 문서: Cubrid 모니터링 등록
DB 인스턴스 등록 시 CMS 정보와 DB 정보 두 가지가 필요합니다.
Step 1) Instance Group 생성
Setting > Database > Instance Group에서 CUBRID로 그룹을 생성합니다.
Step 2) CMS 정보 입력
노란색 영역에 CMS 정보(모니터링 권한이 부여된 사용자 계정 정보)를 입력합니다.
Step 3) DB 정보 입력
빨간색 영역에 DB 정보(DB 사용자 계정 정보)를 입력합니다.
4. Slow Query 수집 설정
참고 문서: Cubrid Slow 수집 설정 방법
4-1. 지원 버전
exemONE 아래 버전 이상이 필요합니다:
| 모듈 | 버전 |
|---|---|
| exemone-db-agent | v3.0.506.15.1 |
| exemone-ingester | v3.0.506.15.1 |
| exemone-core | v3.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)
CUBRID 인스턴스 선택 시 아래 탭별 모니터링이 가능합니다:
(1) Information
| 항목 | 내용 |
|---|---|
| Agent | Instance Name, Status, Instance Group Name, DB Engine, DB Version |
| Broker Map | CUBRID 데이터베이스 기준으로 관계가 있는 브로커 리스트 표시. 클릭 시 브로커 디테일 슬라이드 노출 |
(2) Metric
| 지표 | 설명 |
|---|---|
| Active Tranlist | Active 상태의 트랜잭션 수 |
| Lock Wait Tranlist | Lock 대기 상태인 트랜잭션 수 |
| 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 등)을 실시간 모니터링합니다.
6. 추가 주의사항
- Session SQL Text 수집은 CUBRID 10.2.8 이상에서만 지원되므로, 이하 버전에서는 SQL Text 정보를 확인할 수 없습니다.
- Slow Query 수집을 위해서는 CUBRID 자체에서 먼저 Slow Query 로깅 설정이 활성화되어 있어야 하며, exemONE에서는 해당 로그 파일을 읽어서 수집하는 방식입니다.
- Slow Query 수집 시 로그 유형은 반드시
CUBRID, 로그 형식은Broker - Slow SQL로 설정해야 합니다. - CUBRID 모니터링은 다른 RDBMS와 달리 CMS(CUBRID Manager Server) RESTful API 호출 방식으로 데이터를 수집하므로, CMS가 정상적으로 구동되어 있어야 합니다.
- Slow Query 수집 기능은 exemONE db-agent v3.0.506.15.1, ingester v3.0.506.15.1, core v3.0.506.15.3 이상 버전에서 지원됩니다. 이전 버전에서는 사용할 수 없습니다.
- Cloud 환경에서의 CUBRID 모니터링은 Cloud 모니터링 지원 표에 포함되어 있지 않으므로, On-Premise 환경에서의 사용을 기본으로 합니다.