모니터링 플러그인 (정의해서) 추가하기

이 제품의 "설정" 메인메뉴의 "대시보드" 서브메뉴에서는 모니터링 플러그인과 관련하여 다음 작업들을 할 수 있습니다.

이 절에서는 위 작업을 하는 방법을 소개합니다.

이 제품에서 기본으로 제공하는 플러그인 목록 확인하기

이 제품은 서버와 스토리지, 네트워크에 대한 리소스 사용량(CPU, 메모리, 디스크 사용량)을 비롯해 복제 상태, 네트워크 회선 사용량, 특정 애플리케이션에 대한 상세한 모니터링도 가능해 시스템에 대한 전반적인 상태를 한 화면으로 볼 수 있습니다. 모니터링 결과가 수치로 나타날 경우에는 차트로 확인할 수 있고 텍스트의 경우에는 "이벤트 보기" 탭에서 발생 이벤트를 확인할 수 있습니다.

이 제품은 다양한 모니터링 플러그인들을 제공하고 있으며, 사용자가 원하는 플러그인을 직접 등록해서 모니터링하는 것도 가능합니다. MDRM에서 제공하는 플러그인은 다음과 같습니다.

<표 25> 이 제품이 지원하는 모니터링 플러그인 목록

MDRM는 모니터링에 필요한 보편적인 모니터링 플러그인들을 다양하게 사전정의하여 제공합니다(관련 화면에 모니터링 플러그인 목록으로 나타납니다). 이렇게 기본으로 제공하는 플러그인들 외에 사용자가 정의한 모니터링 플러그인이 필요하다면, 사용자가 직접 정의한 플러그인들을 등록하십시오.

모니터링 플러그인을 관리하려면, 다음 그림과 같이 "설정" 메인메뉴를 클릭한 후 "모니터링 플러그인" 서브메뉴를 클릭하십시오.

<그림 214> 모니터링 플러그인 관리 화면

모니터링 플러그인 추가 화면

모니터링 플러그인을 추가하려면, 다음 그림과 같이 "설정" 메인메뉴를 클릭한 다음 "모니터링 플러그인 서브메뉴"를 클릭한 후, 모니터링 플러그인 관리 화면이 나타나면 [플러그인 추가] 버튼을 클릭하십시오.

<그림 215> 모니터링 플러그인 추가 화면

그러면 플러그인을 추가할 수 있는 화면이 나타납니다. 다음 그림과 내용을 참고하여 사용자에게 맞게 구성한 후 [확인] 버튼을 클릭하십시오.

<그림 216> 모니터링 플러그인 추가

• 플러그인 명: 해당 플러그인의 이름을 입력하는 항목
• 서비스 구분: 해당 플러그인이 속한 서비스 구분을 선택하는 항목
• 플러그인 동작 위치: 관제서버에서 실행할지 클라이언트(클러스터 노드)에서 실행할지 선택하는 항목
• 플러그인 적용 대상: 트리거 설정을 양측 노드 모두에 적용할지 온라인 상태의 그룹에만 적용할지 선택하는 항목
• 지원OS종류: 해당 플러그인이 동작하는 운영체제를 선택하는 항목
• 입력 정보: 해당 플러그인의 모니터링하려면 부가적인 정보가 필요할 경우 사용하는 항목
• 모니터링 결과 단위: 모니터링 결과의 단위를 선택하는 항목
• 결과값 필터: 결과값에 대해 추가적인 필터를 적용할 경우에 사용하는 항목
  
  • 편집 가능 옵션 선택: 해당 플러그인의 설치할 때 결과값 필터의 내용 수정 가능
• 설명: 해당 플러그인에 대해 필요한 설명을 입력할 수 있는 항목

사용자 정의 모니터링 플러그인 작성하기

사용자 정의 모니터링 플러그인의 작성은 다음과 같이 두 부분으로 나뉩니다.

1. 스크립트 작성
2. 플러그인 등록 절차

각 항목에 대한 세부적인 설명은 다음 절에서부터 순서대로 제공합니다.

스크립트 작성하기

사용자 정의 모니터링 플러그인을 작성하여 등록하려면, 다음 순서대로 작업하십시오.

1. 먼저, 다음 표를 참고하여 사용자 정의 플러그인을 위한 스크립트 작성하십시오. 사용자 정의 모니터링 플러그인을 관제서버 차트에 등록하고 알림을 받도록 설정하려면, 반환 코드와 출력 메시지 포맷에 유의하여 작성하십시오. 

반환 코드는 Nagios 서버에서 모니터링 상태를 표현하기 위한 용도이며 필요에 따라 0, 2 코드만 반환할 수 있습니다. 출력 메시지에는 ChartValue=<값> 형태의 키워드를 포함시키고, ChartValue 값은 관제서버에서 수집되어 모니터링 차트로 표현하기 위해 양수값을 입력합니다. 차트의 형태는 관제서버에서 등록된 플러그인의 모니터링 결과 단위(모니터링 플러그인 참고)에 따라 결정됩니다.

2. 관제서버에 터미널로 접속해서 스크립트를 작성하십시오.
권장하는 저장 경로는 “/usr/local/nagios/libexec/custom_script/”로, 예를 들면 “/usr/local/nagios/libexec/custom_script/sample.sh” 식으로 작성하시면 됩니다.

#!/bin/bash
PATH=$PATH:/usr/bin; export PATH
CLASSPATH=$CLASSPATH:/script; export CLASSPATH
 
AA=`date`
 
YEAR=`echo $AA|awk '{print $9}'`
if [ $YEAR -eq "2015" ]; then
  echo "OK - This year is 2015. ChartValue=0"
  exit 0
else
  echo "CRITICAL - This year is needed to change. ChartValue=1"
  exit 2
fi

플러그인 등록 절차

관제서버의 콘솔로 접속하여 플러그인을 추가한 후, 모니터링 컴포넌트의 설정 파일을 변경하십시오. 아래 주요 입력 항목을 참고하십시오.

<표 24> 플러그인을 등록할 때 입력하는 주요 항목들

플러그인을 추가하려면, 다음 그림과 내용을 참고하여 작업하십시오.
   

1. 추가한 모니터링 플러그인의 고유 이름을 조회하십시오.

2. 터미널에 root 계정으로 터미널로 접속한 후 다음과 같이 관제서버 DB에 접속하십시오.

   # su - mccs
   # psql -d mccs

3. 그런 다음 <plug_uniq_name>을 조회하는 쿼리를 실행하고 DB 연결을 종료하십시오.

   select plug_uniq_name, plug_title from mtr_plugins where del_tm is null order by mtr_plug_id desc limit 5;
   \q

   다음과 같이, 아래 예시에서 "WAS행 감지"의 플러그인 고유 이름은 “M0056” 입니다.
   
   확인한 후 root 계정으로 돌아갑니다.

4. 다음과 같이 모니터링 명령어를 정의하십시오.

   # cd /etc/nagios4/conf.d
   # vi mccs_commands.cfg

5. mccs_commands.cfg 파일을 열어 제일 하단에 새로운 명령어를 추가합니다.

   mccs_commands.cfg
   define command {
   command_name <plug_uniq_name>
   command_line <script_file_path> $HOSTADDRESS$
   }

   • <plug_uniq_name>: 위에서 조회한 플러그인 고유 이름(예: M0056)
   • <script_file_path>: 스크립트 실행 경로
   • $HOSTADDRESS$: 노드의 시스템 IP 주소로, 스크립트 실행시 매개변수로 전달할 수 있는 상수
   입력 예시는 다음과 같습니다.
   
   
   

   매개변수 전달 방법

   스크립트를 실행할 때 매개변수를 전달하려면 플러그인 추가 화면에서 [정보추가] 버튼을 클릭하십시오.

   

   mccs_command.cfg 파일을 열어 다음과 같은 형태로 전달할 수 있습니다.

   define command {
     command_name M0056
     command_line $USER1$/custom_script/sample.sh  $HOSTADDRESS$ -port $ARG1$
   }

6. 변경사항을 적용하기 위해 모니터링 컴포넌트의 설정 파일을 다시 읽습니다.

   # service nagios reload

7. 제품의 "시스템" 메인메뉴를 클릭하고 좌측 트리메뉴에서 플러그인을 설치할 클러스터의 이름을 한 후, "모니터링" 서브메뉴를 클릭하여 "플러그인 관리" 탭을 선택하십시오. 그러면 나타난 화면의 설치 가능한 플러그인 화면에서 추가한 플러그인을 선택한 후에 [설치] 버튼을 클릭하십시오.
   다음 그림에서, 사용자가 설치한 “WAS행 감지” 플러그인이 목록에 나타난 것을 확인하실 수 있습니다.
   
8. 플러그인이 정상적으로 동작하는지 여부를 확인하십시오. 모니터링 컴포넌트 웹 화면에서 플러그인의 동작 상태와 에러메시지 등을 통해 볼 수 있습니다.
   • 접속 주소: http://<관제서버주소>:8082/nagios/jsonquery.html
   • 계정 / 암호: mccs / password
   플러그인 상태를 확인한 화면 예시는 다음과 같습니다.
   
   첫번째 “echo : plugin_output”에 출력되고 그 외에는 “long_plugin_output”으로 출력됩니다. 관제서버는 “plugin_output”의 값만 필터링하고 있습니다.