SNMP 트랩

개요

SNMP 트랩을 수신하는 것은 SNMP 지원 장치를 쿼리하는 것과 반대되는 방식입니다.

이 경우 정보는 SNMP 지원 장치에서 snmptrapd로 전송되며, Zabbix server 또는 Zabbix proxy가 파일에서 이를 수집("trap")합니다.

일반적으로 트랩은 어떤 상태 변화가 발생했을 때 전송되며, 에이전트는 서버의 162번 포트로 연결합니다(쿼리에 사용되는 에이전트 측 161번 포트와는 반대). 트랩을 사용하면 쿼리 간격 사이에 발생하여 쿼리 데이터에서는 놓칠 수 있는 짧은 문제를 감지할 수 있습니다.

Zabbix에서 SNMP 트랩을 수신하는 기능은 snmptrapd와, 트랩을 Zabbix에 전달하는 메커니즘 중 하나(Bash 또는 Perl 스크립트, 또는 SNMPTT)와 함께 동작하도록 설계되었습니다.

트랩 수신 작업 흐름:

1. snmptrapd가 트랩을 수신합니다.
2. snmptrapd는 트랩을 수신 스크립트(Bash, Perl) 또는 SNMPTT로 전달합니다.
3. 수신기는 트랩을 파싱하고 포맷을 지정한 뒤 파일에 씁니다.
4. Zabbix SNMP 트래퍼가 트랩 파일을 읽고 파싱합니다.
5. 각 트랩에 대해 Zabbix는 수신한 트랩 주소와 일치하는 호스트 인터페이스를 가진 모든 SNMP 트래퍼 아이템을 찾습니다. 일치 확인 시 호스트 인터페이스에서 선택된 IP 또는 DNS만 사용된다는 점에 유의하세요.
6. 찾은 각 아이템에 대해, 트랩은 snmptrap[regexp]의 정규식과 비교됩니다. 트랩은 일치하는 모든 아이템의 값으로 설정됩니다. 일치하는 아이템이 없고 snmptrap.fallback 아이템이 있는 경우, 트랩은 해당 아이템의 값으로 설정됩니다.
7. 트랩이 어떤 아이템의 값으로도 설정되지 않은 경우, Zabbix는 기본적으로 일치하지 않은 트랩을 로그에 기록합니다. (이 동작은 Administration > General > Other의 Log unmatched SNMP traps에서 설정합니다.)

HA 장애 조치 관련 참고 사항

고가용성(HA) 노드 전환 중, Zabbix는 마지막 ISO 8601 타임스탬프 내 마지막 레코드 이후부터 처리를 계속합니다. 동일한 레코드를 찾지 못하면 타임스탬프만으로 마지막 위치를 식별합니다.

SNMP 트랩 구성

이 아이템 유형은 다음과 같은 프런트엔드 구성이 필요합니다:

1단계: 호스트용 SNMP 인터페이스 생성

1. Data collection > Hosts에서 호스트를 생성하거나 기존 호스트를 편집합니다.
2. Interfaces 필드에서 SNMP 인터페이스 유형을 선택합니다.
3. IP 주소/DNS 이름과 포트 번호를 입력합니다.
4. 드롭다운에서 SNMP version을 선택합니다: (SNMPv1, SNMPv2 또는 SNMPv3) 그리고 선택한 SNMP 버전에 따라 인터페이스 인증 정보를 추가합니다.

수신된 각 트랩의 주소는 해당 호스트를 찾기 위해 모든 SNMP 인터페이스의 IP 및 DNS 주소와 비교됩니다.

2단계: 아이템 구성

1. 해당 호스트에 대해 아이템을 생성하거나 기존 아이템을 편집합니다.

2. Key 필드에서 다음 SNMP 트랩 키 중 하나를 사용합니다:

   • snmptrap[regexp] - regexp 매개변수에 지정된 정규식과 일치하는 모든 SNMP 트랩을 잡아냅니다. regexp가 지정되지 않으면 모든 트랩을 잡아냅니다.
     매개변수에는 사용자 매크로와 전역 정규식을 사용할 수 있습니다.
     반환 값: SNMP 트랩.
     이 아이템은 SNMP 인터페이스에서만 설정할 수 있습니다.
   • snmptrap.fallback - 해당 인터페이스의 어떤 snmptrap[] 아이템에도 잡히지 않은 모든 SNMP 트랩을 잡아냅니다.
     반환 값: SNMP 트랩.
     이 아이템은 SNMP 인터페이스에서만 설정할 수 있습니다.

3. 타임스탬프가 파싱되도록 Type of information을 Log로 설정합니다. Numeric과 같은 다른 형식도 허용되지만 사용자 지정 트랩 핸들러가 필요할 수 있습니다.

SNMP 트랩 모니터링 설정

Zabbix server/proxy 구성

트랩을 읽으려면 Zabbix server 또는 proxy가 SNMP 트래퍼 프로세스를 시작하고, SNMPTT나 Bash/Perl 트랩 수신기가 작성 중인 트랩 파일을 가리키도록 구성되어야 합니다. 이를 위해 구성 파일(zabbix\_server.conf 또는 zabbix\_proxy.conf)을 편집합니다:

StartSNMPTrapper=1
SNMPTrapperFile=[TRAP FILE]

Bash 트랩 수신기 구성

요구 사항: snmptrapd만 있으면 됩니다.

Bash 트랩 수신기 스크립트를 사용하여 트래퍼 파일을 통해 snmptrapd에서 Zabbix server로 트랩을 전달할 수 있습니다. 이를 구성하려면 snmptrapd 구성 파일(snmptrapd.conf)에 traphandle 옵션을 추가하세요. 예시를 참고하세요.

Perl 트랩 수신기 구성

요구 사항: Perl, --enable-embedded-perl로 컴파일된 Net-SNMP(Net-SNMP 5.4부터 기본으로 적용됨)

Perl 트랩 수신기(misc/snmptrap/zabbix\_trap_receiver.pl을 찾으세요)를 사용하면 snmptrapd에서 Zabbix server로 트랩을 직접 전달할 수 있습니다. 구성 방법:

• snmptrapd 구성 파일(snmptrapd.conf)에 Perl 스크립트를 추가합니다. 예:

perl do "[FULL PATH TO PERL RECEIVER SCRIPT]";

• 수신기를 구성합니다. 예:

$SNMPTrapperFile = '[TRAP FILE]';
$DateTimeFormat = '[DATE TIME FORMAT]';

Regexp modifiers "/l" and "/a" are mutually exclusive at (eval 2) line 1, at end of line
Regexp modifier "/l" may not appear twice at (eval 2) line 1, at end of line

SNMPTT 구성

먼저 snmptrapd가 SNMPTT를 사용하도록 구성되어야 합니다.

SNMPTT가 트랩을 수신하도록 구성되면, snmptt.ini를 구성합니다:

1. NET-SNMP 패키지의 Perl 모듈 사용을 활성화합니다:

net_snmp_perl_enable = 1

2. Zabbix가 읽을 트랩 파일에 트랩을 기록하도록 합니다:

log_enable = 1
log_file = [TRAP FILE]

3. 날짜-시간 형식을 설정합니다:

date_time_format = %Y-%m-%dT%H:%M:%S%z

이제 Zabbix가 트랩을 인식할 수 있도록 트랩 형식을 지정합니다(snmptt.conf 편집):

1. 각 FORMAT 문은 ZBXTRAP [address]로 시작해야 하며, 여기서 [address]는 Zabbix의 SNMP 인터페이스 IP 및 DNS 주소와 비교됩니다. 예:

EVENT coldStart .1.3.6.1.6.3.1.1.5.1 "Status Events" Normal
FORMAT ZBXTRAP $aA Device reinitialized (coldStart)

2. SNMP 트랩 형식에 대한 자세한 내용은 아래를 참고하세요.

EVENT general .* "General event" Normal

SNMP 트랩 형식

사용자 지정 Perl 트랩 수신기와 SNMPTT 트랩 구성은 모두 다음과 같은 방식으로 트랩 형식을 지정해야 합니다:

[timestamp] [the trap, part 1] ZBXTRAP [address] [the trap, part 2]

여기서

• [timestamp] - %Y-%m-%dT%H:%M:%S%z 형식의 타임스탬프입니다.
• ZBXTRAP - 이 줄에서 새 트랩이 시작됨을 나타내는 헤더입니다.
• [address] - 이 트랩에 대한 호스트를 찾는 데 사용되는 IP 주소입니다.

ZBXTRAP과 [address]는 처리 과정에서 메시지에서 잘려나간다는 점에 유의하세요. 트랩이 다른 방식으로 형식화되면 Zabbix가 트랩을 예상과 다르게 파싱할 수 있습니다.

트랩 예시:

2024-01-11T15:28:47+0200 .1.3.6.1.6.3.1.1.5.3 Normal "Status Events" localhost - ZBXTRAP 192.168.1.1 Link down on interface 2. Admin state: 1. Operational state: 2

이는 IP=192.168.1.1인 SNMP 인터페이스에 대해 다음과 같은 트랩을 생성합니다:

2024-01-11T15:28:47+0200 .1.3.6.1.6.3.1.1.5.3 Normal "Status Events"
localhost - Link down on interface 2. Admin state: 1. Operational state: 2

시스템 요구 사항

대용량 파일 지원

Zabbix는 SNMP 트래퍼 파일에 대해 대용량 파일 지원 기능을 제공합니다. Zabbix가 읽을 수 있는 최대 파일 크기는 2^63(8 EiB)입니다. 파일 시스템이 파일 크기에 더 낮은 제한을 둘 수 있다는 점에 유의하세요.

로그 로테이션

Zabbix는 로그 로테이션 시스템을 제공하지 않으므로 사용자가 직접 처리해야 합니다. 로그 로테이션은 트랩이 유실되지 않도록 기존 파일 이름을 먼저 변경하고 나중에 삭제해야 합니다:

1. Zabbix는 마지막으로 알려진 위치에서 트랩 파일을 열고 3단계로 이동합니다.
2. Zabbix는 현재 열려 있는 파일의 아이노드 번호를 정의된 트랩 파일의 아이노드 번호와 비교하여 로테이션 여부를 확인합니다. 열려 있는 파일이 없으면 Zabbix는 마지막 위치를 재설정하고 1단계로 이동합니다.
3. Zabbix는 현재 열려 있는 파일에서 데이터를 읽고 새 위치를 설정합니다.
4. 새 데이터가 파싱됩니다. 이것이 로테이션된 파일이었다면 파일을 닫고 2단계로 돌아갑니다.
5. 새 데이터가 없었다면 Zabbix는 1초 동안 대기한 후 2단계로 돌아갑니다.

파일 시스템

트랩 파일 구현 방식 때문에, Zabbix는 파일을 구분하기 위해 파일 시스템이 아이노드를 지원해야 합니다(이 정보는 stat() 호출로 얻습니다).

다양한 SNMP 프로토콜 버전을 사용하는 설정 예시

이 예시는 snmptrapd와 Bash 수신기 스크립트를 사용하여 Zabbix server로 트랩을 전달합니다.

설정:

1. Zabbix가 SNMP 트래퍼를 시작하고 트랩 파일을 설정하도록 구성합니다. zabbix_server.conf에 다음을 추가합니다:

StartSNMPTrapper=1
SNMPTrapperFile=/var/lib/zabbix/snmptraps/snmptraps.log

2. Bash 스크립트를 /usr/sbin/zabbix_trap_handler.sh에 다운로드합니다:

curl -o /usr/sbin/zabbix_trap_handler.sh https://raw.githubusercontent.com/zabbix/zabbix-docker/7.4/templates/scripts/snmptraps/zabbix_trap_handler.sh

필요한 경우 스크립트에서 ZABBIX_TRAPS_FILE 변수를 조정하세요. 기본값을 사용하려면 먼저 상위 디렉터리를 생성하세요:

mkdir -p /var/lib/zabbix/snmptraps

3. snmtrapd.conf에 다음을 추가합니다(동작하는 예시 참고)

traphandle default /bin/bash /usr/sbin/zabbix_trap_handler.sh

4. SNMP 아이템 TEST를 생성합니다(초기 구성 요구 사항을 염두에 두세요):

   Type: SNMP trap
   Type of information: Log
   Host interface: SNMP 127.0.0.1
   Key: snmptrap["linkUp"]
   Log time format: yyyyMMdd.hhmmss

ISO 8601 날짜 및 시간 형식이 사용된다는 점에 유의하세요.

5. 다음으로 선택한 SNMP 프로토콜 버전에 맞게 snmptrapd를 구성하고 snmptrap 유틸리티를 사용하여 테스트 트랩을 전송합니다.

SNMPv1, SNMPv2

SNMPv1 및 SNMPv2 프로토콜은 "커뮤니티 문자열" 인증에 의존합니다. 아래 예시에서는 "secret"을 커뮤니티 문자열로 사용합니다. SNMP 트랩 발신자에서도 동일한 값으로 설정해야 합니다.

프로덕션 환경에서 여전히 널리 사용되고 있지만, SNMPv2는 암호화나 실제 발신자 인증 기능을 제공하지 않는다는 점에 유의하세요. 데이터는 평문으로 전송되므로 이러한 프로토콜 버전은 사설 네트워크와 같은 보안된 환경에서만 사용해야 하며 공개 네트워크나 제3자 네트워크에서는 절대 사용해서는 안 됩니다.

SNMP 버전 1은 64비트 카운터를 지원하지 않아 레거시 프로토콜로 간주되므로 요즘은 실제로 거의 사용되지 않습니다.

SNMPv1 또는 SNMPv2 트랩 수신을 활성화하려면 snmptrapd.conf에 다음 줄을 추가해야 합니다. secret을 SNMP 트랩 발신자에 구성된 SNMP 커뮤니티 문자열로 바꾸세요:

authCommunity log,execute,net secret

다음으로 snmptrap을 사용하여 테스트 트랩을 전송할 수 있습니다. 이 예시에서는 일반적인 "link up" OID를 사용합니다:

snmptrap -v 2c -c secret localhost '' linkUp.0

SNMPv3

SNMPv3는 SNMPv1/v2의 보안 문제를 해결하며 인증과 암호화를 제공합니다. 인증 방식으로 MD5 또는 여러 SHA 방식을, 암호화 방식으로 DES/여러 AES 방식을 사용할 수 있습니다.

snmptrapd.conf에 다음 줄을 추가하여 snmptrapd가 SNMPv3 트랩을 받아들이도록 구성합니다:

# 인증과 프라이버시를 사용하는 SNMPv3 USM 사용자를 생성합니다
createUser -e <engineID> <securityName> SHA <authKey> AES <privKey>
# 해당 사용자가 트랩을 로그에 기록하고 트랩 핸들러 스크립트를 실행하도록 허용합니다
authUser log,execute <securityName>

예를 들면:

createUser -e 0x8000000001020304 traptest SHA myAuthPassword AES myPrivPassword
authUser log,execute traptest

SNMPv3 트랩 구성을 테스트하려면 다음 명령을 사용하여 테스트 트랩을 전송하세요:

snmptrap -v 3 -n "" -a SHA -A myAuthPassword -x AES -X myPrivPassword -l authPriv -u traptest -e 0x8000000001020304 localhost 0 linkUp.0

확인

두 예시 모두에서 /var/lib/zabbix/snmptraps/snmptraps.log에 다음과 유사한 줄이 표시됩니다:

2024-01-30T10:04:23+0200 ZBXTRAP 127.0.0.1
UDP: [127.0.0.1]:56585->[127.0.0.1]:162
DISMAN-EVENT-MIB::sysUpTimeInstance = 2538834
SNMPv2-MIB::snmpTrapOID.0 = IF-MIB::linkUp.0

Zabbix의 아이템 값은 다음과 같습니다:

2024-01-30 10:04:23 2024-01-30 10:04:21

2024-01-30T10:04:21+0200 UDP: [127.0.0.1]:56585->[127.0.0.1]:162
DISMAN-EVENT-MIB::sysUpTimeInstance = 2538834
SNMPv2-MIB::snmpTrapOID.0 = IF-MIB::linkUp.0

Perl 예시:

2024-01-30T11:42:54+0200 ZBXTRAP 127.0.0.1
PDU INFO:
  receivedfrom                   UDP: [127.0.0.1]:58649->[127.0.0.1]:162
  notificationtype               TRAP
  version                        1
  community                      public
  errorstatus                    0
  transactionid                  1
  requestid                      2101882550
  messageid                      0
  errorindex                     0
VARBINDS:
  DISMAN-EVENT-MIB::sysUpTimeInstance type=67 value=Timeticks: (457671) 1:16:16.71
  SNMPv2-MIB::snmpTrapOID.0      type=6  value=OID: IF-MIB::linkUp.0

참고 자료

• Zabbix 블로그의 SNMP 트랩 관련 글
• snmptrapd 구성 (공식 net-snmp 문서)
• SNMPv3 알림을 수신하도록 snmptrapd 구성 (공식 net-snmp 문서)