[Plugin] Nvidia-SMI Exporter

Summary

A Prometheus exporter for NVIDIA GPU metrics via nvidia-smi. Compatible with all GPU architectures (Turing, Ampere, Ada Lovelace, Blackwell) and all driver versions, including driver 595+ which deprecated several fields across all architectures. This is also available as a docker container if that's more your speed.

Why does it exist?

The original exporter (and its forks) fail on driver 595+. Starting with driver 595, NVIDIA changed several nvidia-smi -q -x fields from N/A to the string "Requested functionality has been deprecated" — on all GPU architectures, not just Blackwell. The original filterNumber() function strips non-numeric characters from this string, producing an empty string, which is then emitted as a Prometheus metric value — invalid text exposition format that causes the entire scrape to fail silently, dropping all metrics for that interval.

This rewrite fixes that at the structural level: every value passes through a safe filter that always returns a valid numeric string or "0", and writeMetric refuses to emit any line with an empty value.

Prerequisites

Install the Nvidia-Driver plugin from Community Applications first. This plugin installs nvidia-smi at /usr/bin/nvidia-smi on the Unraid host.

The plugin will abort installation with a clear error message if /usr/bin/nvidia-smi is not found.

Install via Community Applications

Search for "Nvidia-SMI Exporter" in the Community Applications store, or add the plugin URL directly in the Unraid Plugins tab:

https://github.com/ccmpbll/nvidia-smi-exporter/raw/main/unraid/nvidia-smi-exporter.plg

Configuration

After installation, navigate to Settings → Nvidia-SMI Exporter to:

• Start / stop / restart the exporter

• Configure the listen port (default: 9202)

• View current GPU information

Grafana Dashboard

A pre-built Grafana dashboard is available here: https://github.com/ccmpbll/nvidia-smi-exporter/blob/main/grafana/dashboard.json

GitHub Repo

More information about this project and the metrics collected can be found here: https://github.com/ccmpbll/nvidia-smi-exporter

Credits

This project is derived from three MIT-licensed upstream projects:

• kristophjunge/docker-prometheus-nvidiasmi — original exporter

• e7d/docker-prometheus-nvidiasmi — fork adding gpu_power_readings support

• ich777/unraid-prometheus_nvidia_smi_exporter — Unraid plugin packaging

Feedback

Please feel free to give constructive feedback. I'm very open to suggestions or recommendations.

Edited May 20May 20 by ccmpbll
Formatting