Icinga 2로 모니터링할 새로운 호스트 및 서비스 추가하기

이 튜토리얼에서는 Icinga 2로 모니터링할 새로운 호스트를 추가하는 방법과 웹 HTTP 서버와 같은 호스트의 서비스를 Icinga로 모니터링하는 방법을 보여드리겠습니다. 또한 네트워크 인프라에서 UDP 서비스를 모니터링하기 위해 자신만의 사용자 정의 Icinga 플러그인 명령을 만드는 방법도 보여드리겠습니다.

Icinga 2는 서버 및 서비스 체크와 알림을 쉽게 구현할 수 있는 플러그인 인프라를 제공합니다. 이 사실은 시스템 관리자와 프로그래머가 Icinga 2에 새로운 기능을 구축하고 호스트, 네트워크 서비스 또는 네트워크 기능의 다양한 측면을 검증하는 데 특화된 특별한 명령을 생성할 수 있게 합니다.

Icinga 2는 서비스 규칙, 알림, 의존성 및 예약된 다운타임 객체에 사용되는 객체 속성과 함께 호스트 정의를 hosts.conf 파일에 저장합니다. 이 파일은 /etc/icinga2/conf.d/ 디렉토리에 위치합니다. 이 파일에서 Icinga2 모니터링 프로세스에 의해 체크될 새로운 호스트 정의를 추가할 수 있습니다. 아래 예제에서는 기본 게이트웨이 라우터가 ICMP 체크를 통해 온라인인지 주기적으로 확인할 수 있도록 새로운 정의를 추가합니다.

nano /etc/icinga2/conf.d/hosts.conf

파일 끝으로 가서 다음 줄을 추가하여 새로운 호스트 정의를 추가합니다.

object Host "Router" {  
  address = "192.168.1.1"  
  check_command = "hostalive"  
}

예를 들어, 주요 라우터에서 인증 및 설정에 사용되는 HTTP 웹 서버의 상태도 확인하고 싶습니다. 아래 줄은 라우터의 웹 서버가 살아 있고 적절한 HTTP 코드로 응답하는지 확인합니다.

object Service "http" {  
  host_name = "Router"  
  check_command = "http"  
}

Icinga 2가 새로운 호스트 정의를 인식하고 새로운 리소스를 주기적으로 모니터링하기 시작하려면 다음 명령을 실행하여 프로세스를 재시작해야 합니다.

systemctl restart icinga2.service

새로 추가된 호스트, 이 경우 라우터의 상태를 확인하려면 Icinga 2 웹 패널에 로그인하고 개요 -> 호스트로 이동합니다. 오른쪽 창에서 아래 이미지에 설명된 대로 새로 추가된 호스트의 상태를 확인할 수 있습니다. 호스트 체크는 기본적으로 ICMP 프로토콜을 통해 수행되며 Icinga2는 웹 패널에서 호스트의 왕복 시간 평균을 표시합니다.

호스트 HTTP 서비스 체크의 상태를 표시하려면 개요 -> 서비스 그룹으로 이동하여 HTTP 체크를 클릭합니다. 오른쪽 창에서 다음 스크린샷에 설명된 대로 라우터 HTTP 서비스의 상태를 확인할 수 있습니다.

Icinga 2는 광범위한 서비스를 모니터링하는 데 사용할 수 있는 일련의 미리 정의된 명령을 제공합니다. 그러나 이러한 기본 명령은 때때로 사용자 정의 서비스를 확인하기에 충분하지 않습니다. 이 경우 한 가지 접근 방식은 Icinga 2가 서비스를 모니터링하기 위해 호출할 수 있는 사용자 정의 명령 스크립트를 만드는 것입니다. 아래 예제에서는 네트워크에서 다양한 UDP 서비스의 상태를 확인하기 위해 새로운 사용자 정의 명령 스크립트를 추가하는 방법을 보여줍니다. 사용자 정의 명령은 매개변수화되어야 하며 최소 두 개의 매개변수를 포함해야 합니다. 형식은 –H 호스트 이름 또는 IP 및 –p 포트 번호입니다. UDP 서비스 포트를 확인하기 위한 사용자 정의 명령 스크립트는 /usr/lib/nagios/plugins/ 디렉토리에 배치되어야 하며 아래 샘플에 선언된 내용으로 구성되어야 합니다.

nano /usr/lib/nagios/plugins/check_udpport

check_udpport 파일 발췌.

#!/bin/bash  
while getopts H:p: option  
do  
 case "${option}"  
in  
H) addr=${OPTARG};;  
p) port=${OPTARG};;  
esac  
done  
  
/bin/nc -vz -u "$addr" "$port" > /dev/null 2>&1  
  
stat=`echo $?`  
  
if test $stat -eq 0; then  
echo "Port $port is opened on $addr"  
exit 0  
else  
echo "Port $port is not opened on $addr"  
exit 2  
fi

이 스크립트가 어떻게 작동하는지 이해해 보겠습니다. 보시다시피 플러그인은 간단한 Bash 스크립트에 불과합니다. 우리는 while 제어 표현식을 사용하여 H 및 p 문자로 정의된 두 개의 매개변수를 반복합니다. 두 개의 H 및 p 셸 변수 문자는 매개변수화되어 case 문을 사용하여 명령줄 인수로 구문 분석됩니다. case 문은 매개변수가 존재하는지 테스트하고 addr 및 port 변수로 선언합니다. 다음으로, $ addr 및 $ port 변수는 netcat 명령의 명령 옵션으로 추가되며, 이는 다시 $addr 변수로 정의된 IP 주소의 호스트에 대해 정의된 $port 변수의 포트 번호가 열려 있는지 확인합니다. netcat 명령의 출력 및 최종 오류는 이 플러그인에 관심이 없으므로 Linux 블랙홀 /dev/null 파일로 버려집니다. 우리가 필요로 하는 것은 netcat 명령의 종료 코드입니다. netcat이 호스트의 포트를 확인한 후, 프로브된 UDP 포트가 열려 있는 경우 항상 0 종료 코드를 반환합니다. 나머지 명령은 매우 간단합니다. if-else 케이스 조건문은 다음과 같이 출력합니다: 지정된 IP 주소에서 UDP 포트가 열려 있으면 해당 호스트 IP 주소에 대해 ‘포트가 열려 있습니다’라는 문자열을 인쇄하고 종료 코드 0을 추가합니다. 0 종료 코드는 항상 Linux에서 프로세스가 반환하는 성공 또는 오류 없음 코드입니다. UDP 포트가 열려 있지 않으면 (netcat의 종료 코드가 0이 아닌 경우), 호스트에 대해 ‘포트가 열려 있지 않습니다’라는 문자열을 인쇄하고 종료 코드 2를 추가합니다. 이 스크립트에서 각 echo 인쇄 문자열 뒤에 추가된 종료 코드는 Icinga2 체크에 대해 큰 의미가 있습니다. 아래에 설명된 대로입니다.

Icinga 2에서 서비스 상태 또는 호스트 상태에 대한 명령 플러그인 반환 코드:

0 = 서비스에 대한 OK 및 호스트에 대한 UP

1 = 서비스에 대한 WARNING 및 호스트에 대한 UP 또는 DOWN/UNREACHABLE (호스트가 플래핑하거나 상태가 자주 변경됨)

2 = 서비스에 대한 CRITICAL 및 호스트에 대한 DOWN/UNREACHABLE

3 = UNKNOWN DOWN/UNREACHABLE

기본적으로 Icinga 2는 이 스크립트를 호스트 및 포트 매개변수와 함께 실행하고 두 가지 상태를 반환합니다: UDP 포트에 접근할 수 없으며 호스트의 UDP 서비스가 Critical하다는 경고를 하거나 UDP 포트에 접근할 수 있으며 UDP 서비스가 양호한 상태로 실행되고 있다는 정보를 제공합니다.

스크립트 파일을 편집한 후, 저장하고 닫고, 다음 명령으로 실행 권한을 추가하여 파일이 실행 가능하도록 합니다.

chmod +x /usr/lib/nagios/plugins/check_udpport

그런 다음 스크립트가 예상대로 작동하는지 테스트하려면, 네트워크의 호스트에서 UDP 열린 포트와 UDP 닫힌 포트에 대해 아래 구문을 실행합니다.

여기서 TFTP 서버는 192.168.1.2 호스트에 대해 체크됩니다.

/usr/lib/nagios/plugins/check_udpport –H 192.168.1.2 –p 69 

확실히 닫힌 UDP 포트에 대한 체크를 시뮬레이션합니다.

/usr/lib/nagios/plugins/check_udpport –H 192.168.1.2 –p 68

이 새로운 사용자 정의 플러그인이 Icinga 2에서 널리 사용되도록 하려면, Icinga 2 명령 구성 파일에 새로운 명령 정의를 추가해야 합니다. 아래 예제와 같이.

nano /etc/icinga2/conf.d/commands.conf

이 파일의 맨 아래로 가서 다음과 같이 명령 정의를 추가합니다.

object CheckCommand "myudp" {  
  command = [ PluginDir + "/check_udpport" ]  
    
    arguments = {  
    "-H" = "$addr$"  
    "-p" = "$port$"  
}  
  vars.addr = "$address$"  
}

Icinga 2 구성에서 ckeck_udpport 명령을 호출하는 데 사용할 명령의 이름은 “ myudp ”입니다. 서비스 호스트 정의에 대해 명령을 호출할 때 주소를 지정할 필요는 없습니다. 이는 Icinga 2 매크로 $address$ 변수로 하드코딩되어 있습니다.

명령이 예상대로 작동하는지 확인하려면, 특정 UDP 서비스가 해당 호스트에서 열려 있는지 확인하기 위해 호스트에 대한 새로운 서비스 정의를 추가합니다. 예를 들어, 192.168.1.2 호스트에 대해 DHCP 포트가 열려 있는지 확인하려면, 아래 정의를 Icinga2 hosts.conf 파일에 추가합니다.

object Service "dhcp" {  
  host_name = "Pi.hole"  
  check_command = "myudp"  
vars.port = "67"  
}

그 후, 변경 사항을 반영하기 위해 Icinga 2를 재시작하고 Icinga 2 웹 패널로 이동하여 개요 -> 호스트로 가서 특정 호스트를 클릭하고 UDP 서비스 상태를 확인합니다. 아래 스크린샷과 같이.

그게 전부입니다! 호스트를 성공적으로 추가하였으며, 해당 서비스는 Icinga 2 네트워크 모니터링 애플리케이션에 의해 주기적으로 체크될 것입니다. Icinga 2 모니터링 엔진 및 사용자 정의 명령 스크립트에 대한 기타 사용자 정의 구성에 대해서는 다음 주소의 문서 페이지를 방문하십시오: https://www.icinga.com/docs/icinga2/latest/doc/03-monitoring-basics/#check-commands