외부 점검

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

개요

외부 점검은 Zabbix 서버가 셸 스크립트 또는 바이너리를 실행하여 수행하는 점검입니다. 다만 호스트를 Zabbix 프록시가 모니터링하는 경우, 외부 점검은 프록시가 실행합니다.

외부 점검은 모니터링 대상 호스트에서 에이전트가 실행 중일 필요가 없습니다.

아이템 키 구문은 다음과 같습니다:

script[<parameter1>,<parameter2>,...]

각 항목의 의미는 다음과 같습니다:

인수 정의
script 셸 스크립트 또는 바이너리의 이름.
parameter(s) 선택적 명령줄 매개변수.

스크립트에 매개변수를 전달하지 않으려면 다음과 같이 사용할 수 있습니다:

script[] or
script

Zabbix 서버 또는 프록시는 외부 스크립트용으로 지정된 디렉터리를 검색하여 명령을 실행합니다(Zabbix 서버/프록시 설정 파일의 ExternalScripts 매개변수 참조). 명령은 Zabbix 서버/프록시와 동일한 사용자 권한으로 실행되므로, 필요한 경우 접근 권한이나 환경 변수는 래퍼 스크립트에서 처리해야 합니다. 또한 해당 사용자가 명령을 실행할 수 있도록 명령의 권한이 설정되어 있어야 합니다. 지정된 디렉터리에 있는 명령만 실행할 수 있습니다.

외부 점검을 과도하게 사용하지 마십시오. 각 스크립트마다 Zabbix 서버/프록시가 fork 프로세스를 시작해야 하며, 많은 스크립트를 실행하면 Zabbix 성능이 크게 저하될 수 있습니다.

사용 예시

첫 번째 매개변수 '-h'로 check_oracle.sh 스크립트를 실행합니다. 두 번째 매개변수는 호스트 속성에서 선택한 설정에 따라 IP 주소 또는 DNS 이름으로 대체됩니다.

check_oracle.sh["-h","{HOST.CONN}"]

호스트가 IP 주소를 사용하도록 설정되어 있다고 가정하면, Zabbix 서버/프록시는 다음을 실행합니다:

check_oracle.sh '-h' '192.168.1.4'

외부 점검 결과

외부 점검의 반환 값은 해당 점검이 생성한 표준 출력과 표준 오류를 합친 것입니다.

텍스트(문자, 로그 또는 텍스트 정보 유형)를 반환하는 아이템은 표준 오류가 출력되더라도 지원되지 않음 상태가 되지 않습니다.

반환 값은 16MB로 제한되며(잘려 나가는 후행 공백 포함), 데이터베이스 제한도 함께 적용됩니다.

요청한 스크립트를 찾을 수 없거나 Zabbix 서버/프록시에 실행 권한이 없으면, 해당 아이템은 지원되지 않음 상태가 되고 관련 오류 메시지가 표시됩니다.

타임아웃이 발생하면 아이템은 지원되지 않음 상태가 되고 관련 오류 메시지가 표시되며, 스크립트를 위해 fork된 프로세스는 종료됩니다.