Ubuntu에서 Zabbix Agent 호스트명·서버·암호화 설정하기

Ubuntu 서버에서 Zabbix 6 Agent를 준비하는 방법입니다. 원본은 Ubuntu 20.04의 설치 기록이며, 다른 릴리스에는 해당 Ubuntu 버전용 저장소와 패키지를 사용합니다. 기존 agent 설정과 PSK는 먼저 보호된 위치에 백업합니다.

저장소와 패키지 확인

공식 다운로드 선택에서 Ubuntu 릴리스·아키텍처·Zabbix 계열을 맞춥니다. 원노트의 특정 .deb 하나를 모든 Ubuntu에 설치하지 않습니다. 저장소가 준비되면 설치 후보를 확인합니다.

apt-cache policy zabbix-agent
sudo apt update
sudo apt install zabbix-agent

agent 설정

/etc/zabbix/zabbix_agentd.conf의 기존 값을 수정합니다. 같은 키를 파일 끝에 여러 번 추가하지 않습니다. 웹에 등록할 호스트명과 Hostname이 일치해야 active check가 연결됩니다.

Hostname=lieper-ubuntu01
Server=192.0.2.10
ServerActive=192.0.2.10:10051
ListenPort=10050

PSK 등록

sudo sh -c 'umask 077; openssl rand -hex 32 > /etc/zabbix/zabbix.psk'
sudo chown zabbix:zabbix /etc/zabbix/zabbix.psk
sudo chmod 600 /etc/zabbix/zabbix.psk

TLSConnect=psk
TLSAccept=psk
TLSPSKIdentity=lieper-ubuntu01-psk
TLSPSKFile=/etc/zabbix/zabbix.psk

웹 호스트에도 같은 암호화 설정과 비밀 키를 입력합니다. 키가 다르면 프로세스가 정상이어도 TLS 연결이 실패할 수 있습니다. 파일을 일반 사용자에게 읽히거나 실행 가능하게 만들지 않습니다.

동작 확인

sudo systemctl enable --now zabbix-agent
sudo systemctl restart zabbix-agent
sudo journalctl -u zabbix-agent -n 50 --no-pager

배포판 방화벽과 중간 방화벽에서 사용한 active·passive 통신 경로를 확인합니다. Zabbix 웹의 최신 데이터에서 수치와 갱신 시간이 바뀌는지 확인합니다. 기존 패키지를 제거해야 한다면 무조건 purge하기보다 보관할 설정과 업그레이드 절차를 먼저 결정합니다.