단순 점검

Zabbix v7.4번역일: 2026-09-09원본 보기

개요

단순 점검은 일반적으로 서비스를 원격에서 에이전트 없이 점검하는 데 사용됩니다.

단순 점검에는 Zabbix agent가 필요하지 않다는 점에 유의하세요. Zabbix server/proxy가 단순 점검 처리(외부 연결 수립 등)를 담당합니다.

단순 점검 사용 예:

net.tcp.service[ftp,,155]
net.tcp.service[http]
net.tcp.service.perf[http,,8080]
net.udp.service.perf[ntp]

단순 점검 항목 설정의 User name과 Password 필드(255자 제한)는 VMware 모니터링 항목에서 사용되며, 그 외에는 무시됩니다.

지원되는 점검

항목 키는 선택적 매개변수와 추가 정보를 제외한 형태로 나열되어 있습니다. 자세한 내용을 보려면 항목 키를 클릭하세요.

VMware 모니터링 항목 키도 참고하세요.

항목 키	설명
icmpping	ICMP ping을 통한 호스트 접근성.
icmppingloss	손실된 패킷의 비율.
icmppingretry	재시도를 포함한 ICMP ping을 통한 호스트 접근성.
icmppingsec	ICMP ping 응답 시간.
net.tcp.service	서비스가 실행 중이며 TCP 연결을 수락하는지 점검합니다.
net.tcp.service.perf	TCP 서비스의 성능을 점검합니다.
net.udp.service	서비스가 실행 중이며 UDP 요청에 응답하는지 점검합니다.
net.udp.service.perf	UDP 서비스의 성능을 점검합니다.

항목 키 세부 정보

꺾쇠괄호가 없는 매개변수는 필수입니다. 꺾쇠괄호 < >로 표시된 매개변수는 선택 사항입니다.

icmpping[<target>,<packets>,<interval>,<size>,<timeout>,<options>]

ICMP ping을 통한 호스트 접근성.
반환값: 0 - ICMP ping 실패; 1 - ICMP ping 성공.

매개변수:

target - 호스트 IP 또는 DNS 이름;
packets - 패킷 개수;
interval - 연속된 패킷 사이의 시간(밀리초);
size - 패킷 크기(바이트);
timeout - 제한 시간(밀리초);
options - 리다이렉트 허용 여부에 사용: 비워두면(기본값) 리다이렉트된 응답을 대상 호스트 다운으로 간주하고, allow_redirect로 설정하면 리다이렉트된 응답을 대상 호스트 업으로 간주합니다.

기본값 표도 참고하세요.

참고:

packets 매개변수로 정의된 패킷 중 하나라도 반환되면 항목은 1을 반환합니다. 모든 패킷이 반환되지 않으면 항목은 0을 반환합니다.

예시:

icmpping[,4] #If at least one of the four packets is returned, the item returns 1.

icmppingloss[<target>,<packets>,<interval>,<size>,<timeout>,<options>]

손실된 패킷의 비율.
반환값: Float.

매개변수:

target - 호스트 IP 또는 DNS 이름;
packets - 패킷 개수;
interval - 연속된 패킷 사이의 시간(밀리초);
size - 패킷 크기(바이트);
timeout - 제한 시간(밀리초);
options - 리다이렉트 허용 여부에 사용: 비워두면(기본값) 리다이렉트된 응답을 대상 호스트 다운으로 간주하고, allow_redirect로 설정하면 리다이렉트된 응답을 대상 호스트 업으로 간주합니다.

기본값 표도 참고하세요.

icmppingretry[<target>,<retries>,<backoff>,<size>,<timeout>,<options>]

재시도를 포함한 ICMP ping을 통한 호스트 접근성. 첫 번째 패킷이 성공하면 중단하고, 실패하면 retries 매개변수에 정의된 최대 시도 횟수에 도달할 때까지 재시도합니다. 이 항목은 네트워크로 전송되는 패킷 수를 줄이는 데 유용합니다.
반환값: 0 - ICMP ping 실패; 1 - ICMP ping 성공.

매개변수:

target - 호스트 IP 또는 DNS 이름;
retries - 대상 호스트에 ping을 시도하는 횟수로, 첫 시도는 포함하지 않음(0 이상; 기본값 1);
backoff - 연속 요청마다 대기 시간에 곱해지는 값(1.0-5.0 범위; 기본값 1.0);
size - 패킷 크기(바이트);
timeout - 제한 시간(밀리초);
options - 리다이렉트 허용 여부에 사용: 비워두면(기본값) 리다이렉트된 응답을 대상 호스트 다운으로 간주하고, allow_redirect로 설정하면 리다이렉트된 응답을 대상 호스트 업으로 간주합니다.

기본값 표도 참고하세요.

icmppingsec[<target>,<packets>,<interval>,<size>,<timeout>,<mode>,<options>]

ICMP ping 응답 시간(초).
반환값: Float.

매개변수:

target - 호스트 IP 또는 DNS 이름;
packets - 패킷 개수;
interval - 연속된 패킷 사이의 시간(밀리초);
size - 패킷 크기(바이트);
timeout - 제한 시간(밀리초);
mode - 가능한 값: min, max, 또는 avg(기본값);
options - 리다이렉트 허용 여부에 사용: 비워두면(기본값) 리다이렉트된 응답을 대상 호스트 다운으로 간주하고, allow_redirect로 설정하면 리다이렉트된 응답을 대상 호스트 업으로 간주합니다.

참고:

손실되거나 타임아웃된 패킷은 계산에 사용되지 않습니다;
호스트를 사용할 수 없는 경우(타임아웃 도달) 항목은 0을 반환합니다;
반환값이 0.0001초 미만이면 값은 0.0001초로 설정됩니다;
기본값 표도 참고하세요.

net.tcp.service[service,<ip>,<port>]

서비스가 실행 중이며 TCP 연결을 수락하는지 점검합니다.
반환값: 0 - 서비스 다운; 1 - 서비스 실행 중.

매개변수:

service - 가능한 값: ssh, ldap, smtp, ftp, http, pop, nntp, imap, tcp, https, telnet(세부 정보 참고);
ip - IP 주소 또는 DNS 이름(기본값은 호스트 IP/DNS 사용);
port - 포트 번호(기본값은 표준 서비스 포트 번호 사용).

참고:

tcp 서비스를 사용할 때는 포트 지정이 필수임에 유의하세요;
이러한 점검은 시스템 데몬 로그 파일에 추가 메시지를 남길 수 있습니다(SMTP 및 SSH 세션이 보통 로그로 남음);
암호화된 프로토콜(예: 포트 993의 IMAP 또는 포트 995의 POP) 점검은 현재 지원되지 않습니다. 이러한 경우 대안으로 net.tcp.service[tcp,<ip>,port]를 사용하세요.

예시:

net.tcp.service[ftp,,45] #This item can be used to test the availability of FTP server on TCP port 45.

SELinux가 enforced 모드로 실행 중인 경우, 커스텀 TCP/UDP 단순 점검이 정책에 의해 차단될 수 있습니다. 새로운 아웃바운드 연결을 확인하고 허용하려면 grep denied /var/log/audit/audit.log로 audit denial을 검토하세요.

net.tcp.service.perf[service,<ip>,<port>]

TCP 서비스의 성능을 점검합니다.
반환값: Float: 0.000000 - 서비스 다운; seconds - 서비스 연결에 소요된 시간(초).

매개변수:

service - 가능한 값: ssh, ldap, smtp, ftp, http, pop, nntp, imap, tcp, https, telnet(세부 정보 참고);
ip - IP 주소 또는 DNS 이름(기본값은 호스트 IP/DNS 사용);
port - 포트 번호(기본값은 표준 서비스 포트 번호 사용).

참고:

tcp 서비스를 사용할 때는 포트 지정이 필수임에 유의하세요;
암호화된 프로토콜(예: 포트 993의 IMAP 또는 포트 995의 POP) 점검은 현재 지원되지 않습니다. 이러한 경우 대안으로 net.tcp.service[tcp,<ip>,port]를 사용하세요.

예시:

net.tcp.service.perf[ssh] #This item can be used to test the speed of initial response from SSH server.

net.udp.service[service,<ip>,<port>]

서비스가 실행 중이며 UDP 요청에 응답하는지 점검합니다.
반환값: 0 - 서비스 다운; 1 - 서비스 실행 중.

매개변수:

service - 가능한 값: ntp(세부 정보 참고);
ip - IP 주소 또는 DNS 이름(기본값은 호스트 IP/DNS 사용);
port - 포트 번호(기본값은 표준 서비스 포트 번호 사용).

예시:

net.udp.service[ntp,,45] #This item can be used to test the availability of NTP service on UDP port 45.

net.udp.service.perf[service,<ip>,<port>]

UDP 서비스의 성능을 점검합니다.
반환값: Float: 0.000000 - 서비스 다운; seconds - 서비스 응답 대기에 소요된 시간(초).

매개변수:

service - 가능한 값: ntp(세부 정보 참고);
ip - IP 주소 또는 DNS 이름(기본값은 호스트 IP/DNS 사용);
port - 포트 번호(기본값은 표준 서비스 포트 번호 사용).

예시:

net.udp.service.perf[ntp] #This item can be used to test the response time from NTP service.

LDAP 단순 점검(예: net.tcp.service[ldap])에서 SourceIP를 지원하려면 OpenLDAP 버전 2.6.1 이상이 필요합니다.

타임아웃 처리

Zabbix는 항목 설정 폼에서 정의된 Timeout초를 초과하는 단순 점검을 처리하지 않습니다. VMware 항목의 경우, Zabbix는 Zabbix server 또는 proxy 설정 파일에서 정의된 Timeout초를 초과하는 단순 점검을 처리하지 않습니다. icmpping* 항목의 경우, 타임아웃과 재시도 값은 항목 키에 직접 지정되며 전역 Timeout 매개변수의 영향을 받지 않습니다. 항목 키에서 이 값들을 적절히 설정하도록 하세요. icmpping* 항목에는 하드코딩된 최대 타임아웃 600초가 적용됨에 유의하세요(Zabbix 7.4.6부터).

ICMP ping

Zabbix는 ICMP ping 처리(icmpping, icmppingloss, icmppingretry, icmppingsec)에 외부 유틸리티 fping을 사용합니다.

설치

fping은 Zabbix에 포함되어 있지 않으며 별도로 설치해야 합니다:

다양한 Unix 기반 플랫폼에는 fping 패키지가 기본 저장소에 있지만 사전 설치되어 있지는 않습니다. 이 경우 패키지 관리자를 사용하여 fping을 설치할 수 있습니다.
Zabbix는 RHEL 및 그 파생 배포판을 위한 fping 패키지를 제공합니다. 이 패키지들은 공식 지원 없이 제공됨에 유의하세요.
fping은 소스에서 컴파일할 수도 있습니다.

설정

Zabbix server/proxy 설정 파일의 FpingLocation 매개변수(IPv6 주소를 사용하는 경우 Fping6Location 매개변수)에서 fping 위치를 지정하세요.

fping은 Zabbix server/proxy가 실행되는 사용자로 실행 가능해야 하며, 이 사용자는 충분한 권한을 가져야 합니다.

fping 3.10 미만 버전으로 단순 점검을 처리할 때 발생하는 문제는 알려진 문제도 참고하세요.

기본값

ICMP 점검 매개변수의 기본값, 제한값 및 설명:

매개변수	단위	설명	Fping 플래그	기본값 설정 주체	<	Zabbix 허용 제한값	<
				fping	Zabbix	min	max
packets	개수	대상에 전송되는 요청 패킷의 수	-C		3	1	10000
interval	밀리초	개별 대상으로의 연속된 패킷 사이에 대기하는 시간	-p	1000		20	무제한
size	바이트	패킷 크기(바이트) x86에서 56바이트, x86_64에서 68바이트	-b	56 또는 68		24	65507
timeout	밀리초	fping v3.x - 마지막 패킷 전송 후 대기하는 타임아웃, -C 플래그의 영향을 받음 fping v4.x - 각 패킷에 대한 개별 타임아웃	-t	fping v3.x - 500 fping v4.x 이상 - -p 플래그로부터 상속되지만 2000을 초과하지 않음		50	무제한
retries	개수	대상에 ping을 시도하는 횟수로, 첫 시도는 포함하지 않음	-r	3	1	0	무제한
backoff factor	개수	연속 요청마다 대기 시간에 곱해지는 값	-B	1.5	1.0	1.0	5.0

기본값은 플랫폼과 버전에 따라 약간 다를 수 있습니다.

또한 Zabbix는 fping 옵션 -i interval ms(위 표에 언급된 항목 매개변수 interval과 혼동하지 마세요, 이는 fping 옵션 -p에 해당합니다)와 -S source IP address(구버전 fping에서는 -I)를 사용합니다. 이 옵션들은 서로 다른 옵션 조합으로 점검을 실행하여 자동으로 감지됩니다. Zabbix는 3가지 값(0, 1, 10)을 시도하여 -i에 사용할 수 있는 최소값(밀리초)을 감지하려고 시도합니다. 가장 먼저 성공하는 값이 이후 ICMP 점검에 사용됩니다. 이 과정은 각 ICMP pinger 프로세스에서 개별적으로 수행됩니다.

자동 감지된 fping 옵션은 매시간 무효화되며 다음 ICMP 점검 시도 시 다시 감지됩니다. 이 과정의 세부 정보를 server 또는 proxy 로그 파일에서 확인하려면 DebugLevel>=4로 설정하세요.

Zabbix는 icmpping* 키로 점검할 IP 주소를 임시 파일에 기록한 후 fping에 전달합니다. 항목들이 서로 다른 키 매개변수를 가진 경우, 동일한 키 매개변수를 가진 항목들만 하나의 파일에 함께 기록됩니다. 하나의 파일에 기록된 모든 IP 주소는 fping에 의해 병렬로 점검되므로, Zabbix ICMP pinger 프로세스는 파일 내 IP 주소 수와 관계없이 고정된 시간을 소비합니다.