You can install it with apt install zabbix-agent2-plugin-nvidia-gpu.

There is also a method to install it by building from source.
This guide will cover how to install it from source.
Refer to this part if you fall under the following cases.
If the package installation works without issues, you don’t need to follow this guide.

Reason for building from source:

1. A guide for those who have problems installing the package.
2. Package installation uses a pre-compiled binary built for specific OS, glibc, and NVML versions designated by the Zabbix repo,
   so compatibility issues can easily occur when the OS version or driver combination differs.
   In contrast, source build compiles directly based on the node’s actual NVML and glibc environment,
   making it less affected by OS and driver differences and allowing more stable operation.

Tip: In certain driver/kernel combinations (Ubuntu 22.04 + Driver 55x/57x + CUDA 12.x, etc.),
Zabbix Agent2 has a bug where it terminates immediately when loading the NVIDIA plugin.

Below is one of the officially reported issues.
(ZBX-25821 — agent2 crashes during plugin loading)

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

Tip: Depending on the OS type, commands and paths may vary slightly, so adjust as needed.

(Part 1) Installing the NVIDIA GPU Plugin from Source

Installation environment

Ubuntu 22.04
Zabbix 7.4
GPU: NVIDIA GeForce RTX 4080 SUPER
NVIDIA Driver pre-installed
Zabbix Agent2 pre-installed

1. Install Go 1.23 (required if missing or lower than 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   # → Should output 1.23.x

2. Install build tools

# apt update
# apt install -y build-essential

3. Download NVIDIA GPU plugin source

# 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. Build the plugin

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

5. Install the plugin

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

6. Install the plugin config file

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

⚠ Warning
The plugin path may differ depending on the server environment.
Therefore, always verify that /etc/zabbix/zabbix_agent2.d/plugins.d matches your environment.

7. Modify the config file

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

The following two lines must exist:

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

Plugins.NVIDIA.Timeout=10

Why is this needed?

Path= : For agent2 to know where the GPU plugin binary is located.

Timeout= : To prevent agent2 from dying due to timeout when NVML requests take long.

In short, these are options “required for agent2 to properly load and execute the plugin.”

8. In zabbix_agent2.conf, verify the following settings:

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

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

9. Restart zabbix agent:

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

If it appears like below, the plugin installation is successful.

Finish.

After creating a host in Zabbix and applying the “Nvidia by Zabbix agent 2” template,
you can then build a Grafana dashboard.

If the plugin runs normally and Zabbix successfully collects GPU metrics,
the subsequent Grafana dashboard configuration follows the same Zabbix–Grafana integration method as before.
This article focuses only on the GPU plugin installation process, and
visualization is omitted since it was thoroughly covered in previous series.

Grafana GPU Dashboard Example

🛠 마지막 수정일: 2025.11.20