16. Grafan연동방법

Zabbix와 Grafana 연동

• 본 문서는 Zabbix에서 수집한 데이터를 Grafana로 시각화하는 방법을 설명한다.
• Zabbix는 데이터 수집과 알람에 강점이 있고, Grafana는 다양한 패널과 대시보드로 시각화에 강점이 있다.
• 두 시스템을 연동하면 Zabbix의 모니터링 데이터를 Grafana에서 더 유연하게 시각화할 수 있다.

연동 개요

• Zabbix Server는 메트릭을 수집하고 저장한다.
• Grafana는 Zabbix plugin을 통해 Zabbix API에 접근해 데이터를 조회한다.
• 일반적으로 연동 흐름은 다음과 같다.
  • Zabbix Server 설치 및 동작 확인
  • Grafana 설치
  • Zabbix plugin 설치
  • Grafana에서 Zabbix data source 등록
  • Dashboard import 또는 신규 패널 생성

사전 준비

• Zabbix Server와 Web UI가 정상 동작해야 한다.
• Grafana가 설치되어 있어야 한다.
• Grafana에서 Zabbix API에 접근 가능해야 한다.
• Zabbix API를 사용할 계정이 필요하며, 보통 읽기 전용 권한을 가진 계정을 별도로 만드는 것이 좋다.

Grafana 설치

• Grafana는 공식 패키지를 이용해 설치할 수 있다.
• 설치 후 서비스 활성화가 필요하다.

systemctl enable --now grafana-server

• 기본 접속 포트는 3000/tcp이다.

Zabbix plugin 설치

• Grafana에서 Zabbix를 사용하려면 alexanderzobnin-zabbix-app 플러그인을 설치한다.
• 설치 예시는 다음과 같다.

grafana-cli plugins install alexanderzobnin-zabbix-app
systemctl restart grafana-server

• 플러그인 설치 후 Grafana에서 Zabbix 플러그인이 활성화되어 있는지 확인한다.

Zabbix API 준비

• Grafana는 Zabbix API를 통해 데이터를 조회하므로 API 접근이 가능해야 한다.
• Zabbix Web UI에서 API 연동용 계정을 따로 생성하는 것이 좋다.
• 일반적으로 Admin 계정보다 별도의 읽기 전용 계정을 사용하는 편이 운영상 안전하다.

API URL 예시

http://<ZABBIX_SERVER_IP>/zabbix/api_jsonrpc.php

• 환경에 따라 https 또는 별도 경로를 사용할 수 있다.

Grafana Data Source 등록

• Grafana Web UI에서 Connections -> Data sources -> Add data source로 이동한다.
• Zabbix를 검색하고 선택한다.
• Zabbix server URL, username, password를 입력한다.
• Save & Test를 눌러 정상 연결을 확인한다.

입력 예시

Name: Zabbix
URL: http://<ZABBIX_SERVER_IP>/zabbix/api_jsonrpc.php
Username: zabbix_api_user
Password: StrongPassword

• 같은 서버에 설치된 경우 localhost를 사용할 수도 있지만, 운영에서는 실제 Zabbix 서버 주소를 명시하는 편이 안전하다.

Dashboard 구성

• Grafana에서 Dashboards -> New dashboard로 이동해 새 패널을 추가할 수 있다.
• 패널의 Data source를 Zabbix로 선택하면 Zabbix 메트릭을 사용할 수 있다.
• 필요한 경우 Grafana dashboard template을 import해서 빠르게 시작할 수 있다.
• Import 시에는 사용할 Data source를 Zabbix로 매핑해야 한다.

주요 사용 방식

• 서버 CPU, Memory, Disk 같은 기본 인프라 지표를 시각화할 수 있다.
• Apache, Nginx, Tomcat, Redis, MySQL 같은 서비스 지표를 패널로 구성할 수 있다.
• Zabbix에서 이미 구성한 Trigger와 Action은 유지하면서, Grafana에서는 시각화 중심으로 운영할 수 있다.

통신 포트 및 방향

• Grafana -> Zabbix Server API: 80/tcp 또는 443/tcp.
• 사용자가 브라우저로 Grafana 접속: 3000/tcp.
• Zabbix Server -> Agent/Proxy 통신은 기존 Zabbix 모니터링 구성과 동일하다.

방화벽 및 접근 제어

• Grafana 서버는 Zabbix API endpoint에 접근 가능해야 한다.
• Zabbix API 계정은 최소 권한으로 운영하는 것이 좋다.
• 외부 노출 환경에서는 Grafana와 Zabbix 모두 HTTPS를 사용하는 것이 바람직하다.
• 플러그인 설치 후 Grafana 서비스를 재시작하지 않으면 플러그인이 반영되지 않을 수 있다.

점검 항목

• Grafana 서비스가 정상 실행 중인지 확인한다.
• Zabbix plugin이 설치 및 활성화되었는지 확인한다.
• Zabbix API URL이 정확한지 확인한다.
• Zabbix 계정이 API 접근 권한을 가지고 있는지 확인한다.
• Save & Test에서 오류가 나면 URL, 계정, 비밀번호, HTTP/HTTPS 경로를 우선 점검한다.

운영 시 참고 사항

• Zabbix는 알림과 수집에 강하고, Grafana는 시각화와 대시보드 구성에 강하다.
• 운영에서는 Zabbix를 데이터 수집 및 알람의 기준 시스템으로 두고, Grafana를 관제 화면으로 사용하는 구성이 일반적이다.
• Dashboard는 직접 만들 수도 있고, Grafana community dashboard를 import할 수도 있다.
• API 전용 계정을 분리해 두면 보안과 운영 편의성이 좋아진다.