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 <host name or IP>             호스트 이름 또는 IP 주소 지정
-p --port <port number>                 호스트에서 실행 중인 에이전트의 포트 번호 지정 (기본값: 10050)
-I --source-address <IP address>        소스 IP 주소 지정
-t --timeout <seconds>                  타임아웃 지정. 유효 범위: 1-600초 (기본값: 30초)
-k --key <item key>                     값을 가져올 아이템의 키 지정
-P --protocol <value>                   에이전트와 통신하는 데 사용되는 프로토콜. 값:
                                            auto - JSON 프로토콜을 사용하여 연결, 실패 시 플레인텍스트 프로토콜로 재시도 (기본값)
                                            json - JSON 프로토콜을 사용하여 연결
                                            plaintext - 아이템 키만 전송하는 플레인텍스트 프로토콜을 사용하여 연결 (6.4.x 및 이전 릴리스)
-h --help                               이 도움말 메시지 표시
-V --version                            버전 번호 표시

--tls-connect <value>                   에이전트에 연결하는 방법. 값:
                                            unencrypted - 암호화 없이 연결 (기본값)
                                            psk - TLS 및 사전 공유 키를 사용하여 연결
                                            cert - TLS 및 인증서를 사용하여 연결
--tls-ca-file <CA file>                 피어 인증서 검증을 위한 최상위 CA 인증서가 포함된 파일의 전체 경로
--tls-crl-file <CRL file>               취소된 인증서가 포함된 파일의 전체 경로
--tls-agent-cert-issuer <cert issuer>   허용된 에이전트 인증서 발급자
--tls-agent-cert-subject <cert subject> 허용된 에이전트 인증서 주체
--tls-cert-file <cert file>             인증서 또는 인증서 체인이 포함된 파일의 전체 경로
--tls-key-file <key file>               개인 키가 포함된 파일의 전체 경로
--tls-psk-identity <PSK-identity>       사전 공유 키를 식별하는 데 사용되는 고유한 대소문자 구분 문자열
--tls-psk-file <PSK-file>               사전 공유 키가 포함된 파일의 전체 경로
--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 [options]