# Nvidia-smi-exporter

Nvidia-smi-exporter is a self-hosted infrastructure app. Prometheus exporter that scrapes NVIDIA GPU metrics via nvidia-smi for self-hosted monitoring, supporting all GPU architectures (Turing through Blackwell) and all driver versions. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/2323/nvidia-smi-exporter

## Description

Prometheus exporter that scrapes NVIDIA GPU metrics via nvidia-smi for self-hosted monitoring, supporting all GPU architectures (Turing through Blackwell) and all driver versions. Specifically fixes the invalid metric output the original exporter produces on NVIDIA driver 595+.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

41/100 (Fair), based on 3 of 4 factors.
- Maintained: 63 (last commit 142 days ago)
- Popular: 12 (3 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)

## Links

- Docker Hub: https://hub.docker.com/r/ccmpbll/nvidia-smi-exporter/
- Unraid: https://ca.unraid.net/apps/nvidia-smi-exporter-1winegw1e671y4?q=nvidia-smi-exporter

## Common questions

### What Docker prerequisite must be in place before running the exporter in a container?

The host must have the NVIDIA Container Toolkit installed so Docker can use the NVIDIA runtime. The exporter is run with the NVIDIA runtime, and the image includes nvidia-smi from the CUDA base image.

### How can I limit the exporter to only some GPUs?

Set NVIDIA_VISIBLE_DEVICES to all for every GPU, one or more indexes like 0 or 0,1, a GPU UUID with GPU-, or none to disable GPU access.

### Which port and environment variable control the HTTP metrics endpoint?

The exporter listens on the EXPORTER_PORT environment variable, which defaults to :9202. Expose 9202/tcp for Docker, and scrape the /metrics path for Prometheus metrics.

### Why does this exporter exist for driver 595+?

Driver 595+ changed some nvidia-smi -q -x fields from N/A to a deprecation string, which made the original exporter emit an empty Prometheus value and fail the whole scrape silently. This version filters every value to a valid numeric string or 0 and refuses to emit empty metric lines.

---
Source: Our Local Host (https://ourlocalhost.com/app/2323/nvidia-smi-exporter), the self-hosted and open-source app directory.
