---
date_published: 2026-08-13
date_modified: 2026-08-13
canonical_url: https://metricshub.org/community-connectors/connectors/nvidiasmi.html
---

 [Supported Platforms](../supported-platforms.html)   [Connectors Directory](../connectors-directory.html)

# Nvidia-Smi

## Description

This connector provides hardware information about most Nvidia GPUs. (Clocking).

[community](tags/community.html) [hardware](tags/hardware.html) [linux](tags/linux.html) [nvidia](tags/nvidia.html) [windows](tags/windows.html)

[Source](https://github.com/metricshub/community-connectors/tree/main/src/main/connector/hardware/NvidiaSmi/NvidiaSmi.yaml)

## Target

Typical platforms: **[Linux](platforms/linux.html), [Microsoft Windows](platforms/microsoft-windows.html), [Nvidia](platforms/nvidia.html)**

Operating systems: **Microsoft Windows, Linux**

## Prerequisites

Leverages: **NVIDIA drivers with NVIDIA-SMI support.**

Technology and protocols: **Commands**

## Examples

### CLI

```batch
metricshub HOSTNAME -t win -c +NvidiaSmi --wmi -u USER
```

### metricshub.yaml

```yaml
resourceGroups:
  <RESOURCE_GROUP>:
    resources:
      <HOSTNAME-ID>:
        attributes:
          host.name: <HOSTNAME> # Change with actual host name
          host.type: win
        connectors: [ +NvidiaSmi ] # Optional, to load only this connector
        protocols:
          wmi:
            username: <USERNAME> # Change with actual credentials
            password: <PASSWORD> # Encrypted using metricshub-encrypt
```

## Connector Activation Criteria

The **Nvidia-Smi** connector will be automatically activated, and its status will be reported as OK if all the below criteria are met:

- The command below succeeds on the monitored host 
  
    - Command: `nvidia-smi`
    - Output contains: `Driver Version` (regex)

## Metrics

| Type | Collected Metrics | Specific Attributes |
| --- | --- | --- |
| **enclosure** | - `hw.status{hw.type="enclosure", state="present"}` |  |
| **fan** | - `hw.fan.speed_ratio` - `hw.fan.speed_ratio.limit{limit_type="low.critical"}` - `hw.fan.speed_ratio.limit{limit_type="low.degraded"}` - `hw.status{hw.type="fan", state="present"}` | - `hw.parent.type` - `id` - `name` - `sensor_location` |
| **gpu** | - `hw.energy{hw.type="gpu"}` - `hw.gpu.io{direction="receive"}` - `hw.gpu.io{direction="transmit"}` - `hw.gpu.memory.limit` - `hw.gpu.memory.utilization` - `hw.gpu.utilization{task="decoder"}` - `hw.gpu.utilization{task="encoder"}` - `hw.gpu.utilization{task="general"}` - `hw.power{hw.type="gpu"}` - `hw.status{hw.type="gpu", state="present"}` | - `driver_version` - `firmware_version` - `hw.parent.type` - `id` - `info` - `model` - `name` - `serial_number` - `vendor` |
| **temperature** | - `hw.status{hw.type="temperature", state="present"}` - `hw.temperature` - `hw.temperature.limit{limit_type="high.critical"}` - `hw.temperature.limit{limit_type="high.degraded"}` | - `hw.parent.type` - `id` - `name` - `sensor_location` |
| **voltage** | - `hw.status{hw.type="voltage", state="present"}` - `hw.voltage` | - `hw.parent.type` - `id` - `name` - `sensor_location` |