04. Zabbix Agent등록하기

Zabbix Web UI에서 Agent 등록

• 본 문서는 Zabbix Web UI에서 Linux 또는 Windows 대상 Agent 호스트를 등록하는 절차를 설명한다.
• Zabbix Agent 등록은 기본적으로 Host 생성, Agent interface 추가, Template 연결, 데이터 수집 확인 순서로 진행한다.
• Passive check는 Server/Proxy가 Agent의 10050/tcp로 조회하고, Active check는 Agent가 Server/Proxy의 10051/tcp로 먼저 연결하는 방식이다.

사전 준비

• 대상 서버에는 Zabbix Agent 또는 Agent 2가 설치되어 있어야 한다.
• Agent 설정 파일의 Hostname 값과 Web UI의 Host name이 반드시 일치해야 한다.
• 네트워크 통신 포트는 다음과 같다.
  • Passive check: 10050/tcp.
  • Active check: 10051/tcp.
• 필요 시 방화벽과 SELinux 정책도 함께 확인한다.

Host Group 생성

• 먼저 모니터링 대상 서버를 넣을 Host group을 생성한다.
• Host group을 미리 만들어 두면 대규모 환경에서 템플릿과 권한 관리가 쉬워진다.

메뉴 경로

• Data collection 또는 Configuration 메뉴에서 Host groups로 이동한다.
• Create host group을 클릭한다.

입력 항목

• Group name: 예) Linux servers, Windows servers, DB servers
• 저장 후 Host 생성 단계로 이동한다.

Host 생성

• Host 생성은 Agent 등록의 핵심 단계이다.
• Host name, Visible name, Groups, Interfaces, Templates를 순서대로 설정한다.

메뉴 경로

• Data collection 또는 Configuration 메뉴에서 Hosts로 이동한다.
• Create host를 클릭한다.

기본 입력 항목

• Host name: Agent의 Hostname과 정확히 동일하게 입력한다.
• Visible name: 화면에 보일 별칭, 선택 입력.
• Groups: 앞에서 생성한 Host group 선택.
• Interfaces: Agent interface 추가.
• Templates: 운영체제에 맞는 템플릿 연결.

Agent Interface 등록

• Host 생성 화면에서 Interfaces 영역의 Add를 클릭하고 Agent를 선택한다.
• 대상 서버의 IP 주소를 입력하고 포트는 기본값 10050을 사용한다.
• DNS 기반으로 운영할 경우 Connect to 옵션을 IP 또는 DNS 정책에 맞게 선택한다.

입력 예시

• Type: Agent
• IP address:
• Port: 10050

Template 연결

• Host에는 운영체제에 맞는 템플릿을 연결해야 실제 항목 수집이 시작된다.
• Linux 서버는 Linux by Zabbix agent 또는 Linux by Zabbix agent active 계열 템플릿을 사용한다.
• Windows 서버는 Windows by Zabbix agent 계열 템플릿을 연결한다.

연결 방법

• Host 생성 화면의 Templates 탭으로 이동한다.
• Select를 눌러 템플릿을 검색한 뒤 추가한다.
• 저장 후 호스트 목록으로 돌아간다.

Passive / Active 선택

• Passive 방식은 Server/Proxy가 직접 Agent를 조회하는 방식이며, 단순하고 직관적이다.
• Active 방식은 Agent가 Server/Proxy로 먼저 접속하여 체크 목록을 받아오고, 결과를 전송하는 방식이다.
• 대규모 환경이나 NAT 환경에서는 Active 방식이 더 유리한 경우가 많다.

등록 확인

• Host 목록에서 해당 호스트의 상태를 확인한다.
• Passive 항목은 ZBX 표시가 정상인지 확인하고, Active는 Latest data로 실제 수집 여부를 확인한다.
• 수집이 보이지 않으면 Hostname 불일치, 포트 차단, 템플릿 미연결을 우선 점검한다.

자주 사용하는 점검 항목

• Host name과 Agent 설정의 Hostname이 동일한지 확인한다.
• 대상 서버의 10050/tcp 인바운드가 열려 있는지 확인한다.
• Active check를 쓰는 경우 Agent가 Server/Proxy의 10051/tcp로 나갈 수 있는지 확인한다.
• 템플릿이 올바르게 연결되었는지 확인한다.
• 수집 대상 서버의 시간이 크게 어긋나지 않았는지 확인한다.

운영 팁

• Host group과 Template 이름을 표준화하면 대규모 운영이 편해진다.
• 신규 서버는 수동 등록보다 배포 자동화 또는 Autoregistration과 함께 쓰면 관리가 쉬워진다.
• Linux와 Windows를 구분한 템플릿 체계를 먼저 정리하면 추후 장애 분석이 쉬워진다.
• 대량 서버 환경에서는 Active 우선, Passive 보조 방식이 일반적으로 운영 효율이 좋다.