DB서비스모니터링

개요

DB서비스모니터링은 DB 서버의 서비스 상태를 주기적으로 모니터링하는 기능을 제공한다. 모니터링 대상 DB 서버는 DataSource가 전자정부 표준프레임워크(eGovFrame)에 Bean으로 등록되어 있어야 한다.

주요 개념

모니터링 스케줄링

주기적으로 DB 서버의 상태를 체크하여 연결 상태를 확인하고 그 결과를 로그에 기록하는 기능이다. Quartz 스케줄러를 활용하여 모니터링 시작 지연 시간과 실행 주기를 설정할 수 있다.

DB 연결 검사 (Checker)

각 DB에 대해 DataSource를 Lookup하여 데이터베이스 연결을 시도하고, 설정된 SQL 문을 실행하여 해당 DB가 활성화된 상태인지 검증한다.

관련 문서

• 네트워크서비스모니터링 — 네트워크서비스모니터링은 네트워크서비스 상태를 주기적으로 모니터링하는 기능을 제공한다.
• HTTP서비스모니터링 — HTTP서비스모니터링은 웹 서비스(웹서버 및 WAS)가 정상적인지 주기적인 점검을 수행하고, 문제 발생 시 해당 정보를 관리자에게 통보하는 기능을 제공한다.
• 송수신모니터링 — 송수신모니터링은 연계기관과의 송수신 상태를 주기적으로 모니터링하는 기능을 제공한다.
• 서버자원모니터링 — 서버자원모니터링은 시스템의 서버 자원(CPU, Memory 등) 상태를 모니터링하고 그 결과를 로그로 등록하여 관리하는 공통컴포넌트이다.
• 파일시스템모니터링 — 파일시스템모니터링은 파일시스템 상태를 주기적으로 모니터링하는 기능을 제공한다.
• 프로세스모니터링 — 프로세스모니터링은 특정 프로세스가 기동 중인지 주기적으로 점검을 수행하고, 문제 발생 시 해당 정보를 관리자에게 통보하는 기능을 제공한다.

설명

DB서비스모니터링은 등록된 DB의 연결 정보 및 설정에 따라 서비스 작동 여부를 확인하고, 관련 이력을 로그로 기록·조회하는 기능을 포함한다.

주요 기능

1. DB서비스모니터링 목록 조회: 등록된 모니터링 정보를 최근 등록 순서대로 조회하며 페이징과 검색 기능을 제공한다.
2. DB서비스모니터링 등록: 데이터소스명, 체크 SQL, 관리자 정보 등을 입력하여 모니터링 대상을 등록한다.
3. DB서비스모니터링 수정: 기 등록된 DB서비스모니터링 정보의 항목들을 수정한다.
4. DB서비스모니터링 삭제: 기 등록된 DB서비스모니터링 정보를 삭제한다.
5. DB서비스모니터링 상세 조회: 등록된 DB서비스모니터링 정보의 상세 내역을 조회한다.
6. DB서비스모니터링 로그 목록 조회: 스케줄러에 의해 주기적으로 실행된 모니터링 로그 정보를 최근 등록 순서대로 조회한다.
7. DB서비스모니터링 로그 상세 조회: 등록된 DB서비스모니터링 로그 정보를 상세 조회한다.

관련 소스

클래스 다이어그램

관련 테이블

ID Generation DDL 및 DML

ID Generation Service를 활용하기 위해서 Sequence 저장 테이블인 COMTECOPSEQ에 DB_MNTRNG_LOG_ID 항목을 추가해야 한다.

CREATE TABLE COMTECOPSEQ (
    table_name VARCHAR(16) NOT NULL,
    next_id DECIMAL(30) NOT NULL,
    PRIMARY KEY (table_name)
);

INSERT INTO COMTECOPSEQ VALUES ('DB_MNTRNG_LOG_ID', 0);

ID Generation 환경설정 (context-idgn-DbMntrngLog.xml)

<bean name="egovDbMntrngLogIdGnrService" class="egovframework.rte.fdl.idgnr.impl.EgovTableIdGnrServiceImpl" destroy-method="destroy">
    <property name="dataSource" ref="egov.dataSource" />
    <property name="strategy"   ref="dbMntrngLogIdStrategy" />
    <property name="blockSize"  value="10" />
    <property name="table"      value="COMTECOPSEQ" />
    <property name="tableName"  value="DB_MNTRNG_LOG_ID" />
</bean>
<bean name="dbMntrngLogIdStrategy" class="egovframework.rte.fdl.idgnr.impl.strategy.EgovIdGnrStrategyImpl">
    <property name="prefix"     value="" />
    <property name="cipers"     value="20" />
    <property name="fillChar"   value="0" />
</bean>

스케줄러 등록 (context-scheduling.xml)

DB서비스모니터링 스케줄러를 등록하기 위해서 context-scheduling.xml 파일에 다음과 같이 빈 및 트리거를 정의한다.

<!-- DB서비스모니터링 Job -->
<bean id="dbMntrng" class="org.springframework.scheduling.quartz.MethodInvokingJobDetailFactoryBean">
    <property name="targetObject" ref="egovDbMntrngScheduling" />
    <property name="targetMethod" value="monitorDb" />
    <property name="concurrent" value="false" />
</bean>

<!-- DB서비스모니터링 트리거 -->
<bean id="dbMntrngTrigger" class="org.springframework.scheduling.quartz.SimpleTriggerFactoryBean">
    <property name="jobDetail" ref="dbMntrng" />
    <property name="startDelay" value="60000" />
    <property name="repeatInterval" value="600000" />
</bean>

• startDelay는 서버 시작 후 몇 밀리초(ms) 뒤에 시작할지를 설정한다. (60000ms = 1분)
• repeatInterval은 몇 밀리초(ms)에 한 번씩 실행될지를 설정한다. (600000ms = 10분)

<!-- 모니터링 스케줄러 -->
<bean id="mntrngScheduler" class="org.springframework.scheduling.quartz.SchedulerFactoryBean">
    <property name="triggers">
        <list>
            <ref bean="dbMntrngTrigger" />
        </list>
    </property>
</bean>

관련 화면 및 기능 설명

DB서비스모니터링 목록 조회

DB서비스모니터링 목록은 페이지당 10건씩 조회되며 페이징은 10페이지씩 이루어진다. 검색 조건은 DB명(연계명), 관리자명에 대해 제공된다.

• 조회: 등록된 DB서비스모니터링 목록을 조회한다.
• 등록: 신규 모니터링 설정을 위해 우측 상단의 등록 버튼을 눌러 DB서비스모니터링 등록 화면으로 이동한다.

DB서비스모니터링 등록

모니터링 대상 DB의 속성정보를 입력한 뒤 등록한다. 데이터소스명 항목에는 context-datasource.xml에 정의된 Spring Bean DataSource ID(예: egov.dataSource)를 정확하게 기입해야 한다.

• 저장: 입력한 DB서비스모니터링 정보를 등록한다.
• 목록: DB서비스모니터링 목록 조회 화면으로 이동한다.

DB서비스모니터링 수정

기 등록된 DB서비스모니터링의 속성 정보를 수정한다.

• 저장: 수정된 내용을 데이터베이스에 저장한다.
• 목록: DB서비스모니터링 목록 조회 화면으로 이동한다.

DB서비스모니터링 상세 조회

등록된 DB서비스모니터링의 속성정보를 확인한다.

• 수정: DB서비스모니터링 수정 화면으로 이동한다.
• 삭제: 기 등록된 DB서비스모니터링 정보를 삭제한다.
• 목록: DB서비스모니터링 목록 조회 화면으로 이동한다.

DB서비스모니터링 로그 목록 조회

스케줄러에 의해 주기적으로 실행된 모니터링 로그 목록을 조회한다. 검색 조건은 DB명(연계명), 관리자명, 모니터링시각 범위에 대해 제공된다.

• 조회: 검색 조건에 해당하는 DB서비스모니터링 로그 목록을 조회한다.

DB서비스모니터링 로그 상세 조회

특정 모니터링 이력의 로그 상세 정보를 조회한다. 대상 DB의 데이터소스명, 연결 상태 결과 및 에러 발생 시의 상세 에러 메시지가 표시된다.

• 목록: DB서비스모니터링 로그 목록 조회 화면으로 이동한다.

참고자료

• 전자정부 표준프레임워크 DokuWiki - DB서비스모니터링