7 Get

개요

Zabbix get은 명령줄 유틸리티로, Zabbix 에이전트와 통신하고 에이전트로부터 필요한 정보를 조회하는 데 사용할 수 있습니다.

이 유틸리티는 일반적으로 Zabbix 에이전트의 문제 해결에 사용됩니다.

Zabbix get처럼 동작하는 내장 기능을 가진 Zabbix용 Python 라이브러리도 참조하세요.

Zabbix get 실행

UNIX에서 Zabbix get을 실행하여 에이전트로부터 프로세서 로드 값을 가져오는 예시:

cd bin
./zabbix_get -s 127.0.0.1 -p 10050 -k system.cpu.load[all,avg1]

웹사이트에서 문자열을 캡처하기 위해 Zabbix get을 실행하는 다른 예시:

cd bin
./zabbix_get -s 192.168.1.1 -p 10050 -k "web.page.regexp[www.example.com,,,\"USA: ([a-zA-Z0-9.-]+)\",,\1]"

여기서 아이템 키에 공백이 포함되어 있으므로 따옴표를 사용하여 셸에 아이템 키를 표시합니다. 따옴표는 아이템 키의 일부가 아니며, 셸에 의해 제거되어 Zabbix 에이전트로 전달되지 않습니다.

아이템 키가 지원되지 않는 경우 Zabbix get은 종료 코드 1을 반환합니다.

Zabbix get은 다음 명령줄 매개변수를 허용합니다:

-s --host <호스트명 또는 IP>            호스트명 또는 호스트의 IP 주소 지정
-p --port <포트번호>                   호스트에서 실행 중인 에이전트의 포트 번호 지정 (기본값: 10050)
-I --source-address <IP 주소>         소스 IP 주소 지정
-t --timeout <초>                    타임아웃 지정. 유효 범위: 1-600초 (기본값: 30초)
-k --key <아이템 키>                  값을 조회할 아이템의 키 지정
-P --protocol <값>                   에이전트와 통신하는 데 사용할 프로토콜. 값:
                                            auto - JSON 프로토콜로 연결, 실패 시 plaintext 프로토콜로 재시도 (기본값)
                                            json - JSON 프로토콜로 연결
                                            plaintext - 아이템 키만 전송하는 plaintext 프로토콜로 연결 (6.4.x 및 이전 릴리스)
-h --help                            이 도움말 메시지 표시
-V --version                         버전 번호 표시

--tls-connect <값>                  에이전트에 연결하는 방법. 값:
                                            unencrypted - 암호화 없이 연결 (기본값)
                                            psk - TLS와 사전 공유 키를 사용하여 연결
                                            cert - TLS와 인증서를 사용하여 연결
--tls-ca-file <CA 파일>              피어 인증서 검증을 위한 최상위 CA 인증서가 포함된 파일의 전체 경로명
--tls-crl-file <CRL 파일>            취소된 인증서가 포함된 파일의 전체 경로명
--tls-agent-cert-issuer <인증서 발급자>   허용된 에이전트 인증서 발급자
--tls-agent-cert-subject <인증서 주체> 허용된 에이전트 인증서 주체
--tls-cert-file <인증서 파일>        인증서 또는 인증서 체인이 포함된 파일의 전체 경로명
--tls-key-file <키 파일>            개인 키가 포함된 파일의 전체 경로명
--tls-psk-identity <PSK-identity>   사전 공유 키를 식별하는 데 사용되는 고유한 대소문자 구분 문자열
--tls-psk-file <PSK-파일>           사전 공유 키가 포함된 파일의 전체 경로명
--tls-cipher13 <cipher-string>      TLS 1.3용 OpenSSL 1.1.1 이상의 암호 문자열. 기본 암호화 제품군 선택 기준을 재정의합니다. OpenSSL 버전이 1.1.1보다 낮으면 이 옵션을 사용할 수 없습니다
--tls-cipher <cipher-string>        GnuTLS 우선순위 문자열(TLS 1.2 이상) 또는 OpenSSL 암호 문자열(TLS 1.2만). 기본 암호화 제품군 선택 기준을 재정의합니다

자세한 정보는 Zabbix get manpage도 참조하세요.

Windows에서 Zabbix get은 유사하게 실행할 수 있습니다:

zabbix_get.exe [옵션]