문서

7 External check

개요

외부 확인은 Zabbix 서버에서 셸 스크립트 실행 또는 바이너리를 통해 실행되는 확인입니다. 그러나 호스트가 Zabbix 프록시에 의해 모니터링될 때는 외부 확인이 프록시에 의해 실행됩니다.

외부 확인은 모니터링되는 호스트에서 실행되는 에이전트가 필요하지 않습니다.

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

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

여기서:

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

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

script[] or
script

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

외부 확인을 과도하게 사용하지 마세요. 각 스크립트는 Zabbix 서버/프록시에서 포크 프로세스를 시작해야 하며, 많은 스크립트를 실행하면 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 서버/프록시에 실행 권한이 없는 경우, 아이템이 지원되지 않음 상태가 되고 해당 오류 메시지가 표시됩니다.

타임아웃이 발생한 경우, 아이템이 지원되지 않음 상태가 되고 해당 오류 메시지가 표시되며, 스크립트용으로 포크된 프로세스가 종료됩니다.