RHEL에 Zabbix 클라이언트 (에이전트) 설치 및 구성 가이드

1. Zabbix 에이전트 설치: RPM 패키지 다운로드 및 설치

Zabbix 서버에서 관리할 각 클라이언트 (호스트)에는 Zabbix 에이전트를 설치해야 합니다. Zabbix 에이전트는 로컬 시스템의 리소스 사용량, 애플리케이션 상태 등 다양한 메트릭 정보를 수집하여 Zabbix 서버로 전송하는 역할을 수행합니다. RHEL 버전에 따라 적절한 RPM 패키지를 다운로드하여 설치합니다.

RHEL 8 환경

rpm -ivh http://repo.zabbix.com/zabbix/5.0/rhel/8/x86_64/zabbix-agent-5.0.10-1.el8.x86_64.rpm

RHEL 7 환경

rpm -ivh http://repo.zabbix.com/zabbix/5.0/rhel/7/x86_64/zabbix-agent-5.0.10-1.el7.x86_64.rpm

위 명령어는 Zabbix 5.0 버전의 에이전트 RPM 패키지를 다운로드하여 설치합니다. Zabbix 서버 버전과 에이전트 버전을 일치시키는 것이 중요합니다. 다른 Zabbix 버전 또는 RHEL 버전에 대한 에이전트 패키지는 아래 링크에서 확인할 수 있습니다.

Zabbix 에이전트 다운로드

---

2. Zabbix 에이전트 설정: 환경 설정 파일 수정

Zabbix 에이전트가 Zabbix 서버와 통신하고 호스트 정보를 정확하게 보고하기 위해서는 설정 파일을 수정해야 합니다. Zabbix 에이전트의 주요 설정 파일은 /etc/zabbix/zabbix_agentd.conf 입니다. vi 편집기 등을 사용하여 해당 파일을 엽니다.

vi /etc/zabbix/zabbix_agentd.conf

설정 파일에서 다음 파라미터들을 찾아서 Zabbix 서버 환경에 맞게 수정합니다.

Server

Server 파라미터는 Zabbix 서버의 IP 주소를 지정합니다. 에이전트가 수동적으로 데이터를 전송할 Zabbix 서버의 IP 주소를 입력합니다.

Server=20.20.20.250

위 예시에서는 Zabbix 서버의 IP 주소가 20.20.20.250 입니다. 실제 Zabbix 서버의 IP 주소로 변경하십시오.

StartAgents

StartAgents 파라미터는 시작할 Zabbix 에이전트 프로세스의 수를 정의합니다. 대부분의 환경에서 기본값인 1로 충분합니다. 필요에 따라 값을 조정할 수 있습니다.

StartAgents=1

ServerActive

ServerActive 파라미터는 Zabbix 서버의 IP 주소 또는 호스트 이름을 지정합니다. 에이전트가 능동적으로 데이터를 요청할 Zabbix 서버의 IP 주소 또는 호스트 이름을 입력합니다. 능동적 검사를 사용하는 경우에 설정해야 합니다.

ServerActive=20.20.20.250

위 예시에서는 Zabbix 서버의 IP 주소가 20.20.20.250 입니다. 실제 Zabbix 서버의 IP 주소로 변경하십시오.

Hostname

Hostname 파라미터는 Zabbix 서버에 표시될 호스트 이름을 정의합니다. 시스템의 호스트명과 일치시키거나 Zabbix 서버에서 인식할 수 있는 고유한 이름을 지정할 수 있습니다. /etc/hosts 파일에 도메인 정보가 설정되어 있다면 도메인 이름을 사용할 수 있습니다.

# /etc/hosts 파일에 도메인 정보가 설정된 경우
Hostname=hk-k8s-master1

/etc/hosts 파일에 도메인 정보가 없다면 IP 주소를 사용할 수도 있습니다.

# 도메인 정보가 없는 경우
Hostname=100.100.100.11

설정 파일 수정 후 저장하고 편집기를 종료합니다.

Zabbix 에이전트 설정 파일 설명

---

3. Zabbix 에이전트 활성화 및 시작: systemctl을 이용한 서비스 관리

Zabbix 에이전트 패키지 설치가 완료되면 systemctl 명령어를 사용하여 Zabbix 에이전트 서비스를 활성화하고 시작합니다. 활성화하면 시스템 부팅 시 자동으로 Zabbix 에이전트가 시작됩니다.

systemctl enable zabbix-agent --now

systemctl enable zabbix-agent 명령어는 Zabbix 에이전트 서비스를 활성화하고, --now 옵션은 서비스를 즉시 시작합니다.

Zabbix 에이전트 서비스의 상태를 확인하려면 다음 명령어를 실행하십시오.

systemctl status zabbix-agent

출력 결과에 active (running) 이라고 표시되면 Zabbix 에이전트가 정상적으로 실행 중인 것입니다.

---

4. 방화벽 규칙 구성: Zabbix 에이전트 통신 포트 개방

Zabbix 서버가 Zabbix 에이전트로부터 데이터를 수신하기 위해서는 방화벽에서 Zabbix 에이전트의 통신 포트 (기본적으로 10050)를 열어주어야 합니다. Zabbix 에이전트가 능동적 검사를 수행하도록 설정된 경우 Zabbix 서버의 10051 포트도 열어야 할 수 있습니다. 또한 웹 인터페이스 접근을 위해 80 포트도 필요할 수 있습니다.

firewall-cmd를 사용하는 경우 (일반적인 RHEL 환경)

sudo firewall-cmd --permanent --add-port=10050/tcp
sudo firewall-cmd --permanent --add-port=10051/tcp
sudo firewall-cmd --permanent --add-port=80/tcp
sudo firewall-cmd --reload

위 명령어들은 방화벽에 필요한 포트들을 영구적으로 추가하고, --reload 옵션은 변경된 설정을 즉시 적용합니다.

iptables를 사용하는 경우 (구형 RHEL 환경 또는 특정 구성)

sudo iptables -I INPUT -p tcp --dport 10050 -j ACCEPT
# 필요한 경우 10051 포트 및 80 포트도 추가
# sudo iptables -I INPUT -p tcp --dport 10051 -j ACCEPT
# sudo iptables -I INPUT -p tcp --dport 80 -j ACCEPT
sudo service iptables save
sudo service iptables restart

iptables를 사용하는 경우 위 명령어를 통해 필요한 포트를 열고 설정을 저장한 후 서비스를 재시작해야 합니다.

방화벽 설정 후 Zabbix 서버에서 해당 호스트를 추가하고 모니터링 설정을 진행하면 Zabbix 서버에서 클라이언트의 데이터를 수집할 수 있습니다.

마무리

이 가이드에서는 RHEL 환경에 Zabbix 클라이언트 (에이전트)를 설치하고 구성하는 과정을 상세하게 설명했습니다. RPM 패키지 설치부터 설정 파일 수정, 서비스 활성화, 그리고 방화벽 규칙 설정까지 모든 단계를 엔지니어 여러분들이 쉽게 따라 할 수 있도록 안내했습니다. Zabbix 에이전트를 성공적으로 설치 및 구성하여 Zabbix 서버를 통해 효율적인 시스템 모니터링 환경을 구축하시기 바랍니다.