Zabbix에서 NVIDIA GPU를 제대로 모니터링하려면
zabbix-agent2-plugin-nvidia-gpu 플러그인이 필요하다.

# apt install zabbix-agent2-plugin-nvidia-gpu 로 패키지 설치할 수도 있고.
소스 빌드로 설치하는 방법이 있는데. 여기서는 소스 빌드 설치하는 법을 가이드
하도록 하겠다.
아래와 같은 이유로 소스 빌드 방법 가이드를 제시하는 부분이니 참고 바란다.
패키지로 문제 없이 설치한 분들은 굳이 이 글을 따라 할 필요는 없다.

소스 빌드 이유 :
1. 패키지 설치에 문제가 있는 분들을 위한 가이드.
2. 패키지 설치는 Zabbix repo가 지정한 특정 OS·glibc·NVML 버전에 맞춰 고정 컴파일된 바이너리를 사용하기 때문에,
OS 버전이나 드라이버 조합이 달라지면 호환성 문제가 쉽게 발생한다.
반면 소스 빌드는 해당 노드의 실제 NVML·glibc 환경을 기준으로 직접 컴파일되므로
OS 차이와 드라이버 차이에 영향을 덜 받고 조금 더 안정적으로 동작한다.

Tip : 특정 드라이버/커널 조합(Ubuntu 22.04 + Driver 55x/57x + CUDA 12.x 등)에서는
Zabbix Agent2가 NVIDIA 플러그인 로딩 즉시 종료되는 버그가 존재한다

아래는 실제로 보고된 공식 이슈 중 하나다.
(ZBX-25821 — agent2가 플러그인 로딩 중 crash)

https://support.zabbix.com/browse/ZBX-25821

Tip : OS 종류에 따라 명령어 및 경로가 약간 다를 수 있으니 필요에 따라 조정하면 된다.

(1편) NVIDIA GPU 플러그인 소스 설치

설치 환경

• Ubuntu 22.04
• Zabbix 7.4
• GPU: NVIDIA GeForce RTX 4080 SUPER
• NVIDIA Driver 사전 설치
• Zabbix Agent2 사전 설치

1. Go 1.23 설치 (없거나 1.23 미만이면 필수)

# cd /usr/local/src
# wget https://go.dev/dl/go1.23.2.linux-amd64.tar.gz
# rm -rf /usr/local/go
# tar -C /usr/local -xzf go1.23.2.linux-amd64.tar.gz

# echo 'export PATH=$PATH:/usr/local/go/bin' >> ~/.bashrc
# source ~/.bashrc

# go version   # → 1.23.x 나와야 정상

2. 빌드 도구 설치

# apt update
# apt install -y build-essential

3. NVIDIA GPU 플러그인 소스 다운로드

# cd /usr/local/src

# wget https://cdn.zabbix.com/zabbix-agent2-plugins/sources/nvidia-gpu/zabbix-agent2-plugin-nvidia-gpu-7.4.4.tar.gz
# tar xvf zabbix-agent2-plugin-nvidia-gpu-7.4.4.tar.gz
# cd zabbix-agent2-plugin-nvidia-gpu-7.4.4

4. 플러그인 빌드

# CGO_ENABLED=1 go build -o zabbix-agent2-plugin-nvidia-gpu

5. 플러그인 설치

# mkdir -p /usr/libexec/zabbix
# install -m 0755 zabbix-agent2-plugin-nvidia-gpu /usr/libexec/zabbix/zabbix-agent2-plugin-nvidia-gpu

6. 플러그인 설정 파일 설치

# install -m 0644 nvidia.conf /etc/zabbix/zabbix_agent2.d/plugins.d/nvidia.conf

⚠ 주의
서버 환경마다 플러그인 경로가 다를 수 있으므로
/etc/zabbix/zabbix_agent2.d/plugins.d 경로는 반드시 본인 환경에 맞춰
확인해야 한다.

7. 설정 파일 수정

# vi /etc/zabbix/zabbix_agent2.d/plugins.d/nvidia.conf

아래 두 줄이 반드시 있어야 한다:

Plugins.NVIDIA.System.Path=/usr/libexec/zabbix/zabbix-agent2-plugin-nvidia-gpu

Plugins.NVIDIA.Timeout=10

왜 필요한가?

• Path= : agent2가 GPU 플러그인 바이너리가 어디 있는지 알기 위해
• Timeout= : NVML 요청이 오래 걸릴 때 agent2가 timeout으로 죽지 않게 하기 위해

즉, “agent2가 플러그인을 정상적으로 로드하고 실행하려면 반드시 필요한 옵션”이다.

8. zabbix_agent2.conf 에서 아래 설정 확인:

Include=/etc/zabbix/zabbix_agent2.d/*.conf

Include=/etc/zabbix/zabbix_agent2.d/plugins.d/*.conf

9. zabbix agent 재시작 :

# systemctl restart zabbix-agent2
# systemctl status zabbix-agent2

아래와 같이 나오면 플러그인 설치 성공이다.

마무리.

zabbix 웹에서 Nvidia by Zabbix agent 2 템플릿을 적용한 host를 생성한 이후
Grafana 대시보드를 작성하면 끝이다.

플러그인이 정상적으로 기동하고 Zabbix 측에서 GPU 메트릭이 수집되는 것이 확인되면
이후의 Grafana 대시보드 구성은 기존 Zabbix–Grafana 연동 방식과 동일하다.
이 글에서는 GPU 플러그인 설치 과정에만 집중하며,
시각화 구성은 이전 시리즈에서 충분히 다뤘으므로 생략한다.

Grafana GPU 대시보드 적용 예시

🛠 마지막 수정일: 2025.11.20