Back to the list of connectors

Nvidia-Smi

Description

Gives hardware information on most Nvidia GPUs. (Clocking)

Connector ID: NvidiaSmi

Target

Typical platform: Any system with Nvidia GPUs

Operating systems: Microsoft Windows, Linux

Prerequisites

Leverages: NVIDIA drivers with NVIDIA-SMI support.

Technology and protocols: System Commands

Examples

CLI

hws HOSTNAME -t win -f NvidiaSmi --wmi -u USER

hws-config.yaml

hosts:
- host:
    hostname: <HOSTNAME> # Change with actual host name
    type: win
  selectedConnectors: [ NvidiaSmi ] # Optional, to load only this connector
  wmi:
    username: <USERNAME> # Change with actual credentials
    password: <PASSWORD> # Encrypted using hws-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 (Labels)
Enclosure
  • hw.status{hw.type="enclosure",state="present"}
    Fan
    • hw.fan.speed_ratio
    • hw.fan.speed_ratio.limit{limit_type="critical"}
    • hw.fan.speed_ratio.limit{limit_type="degraded"}
    • hw.status{hw.type="fan",state="present"}
    • 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
    • hw.gpu.utilization{task="decoder"}
    • hw.status{hw.type="gpu",state="present"}
    • info
    • driver_version
    • firmware_version
    • model
    • serial_number
    • vendor
    Temperature Sensor
    • hw.status{hw.type="temperature",state="present"}
    • hw.temperature
    • hw.temperature.limit{limit_type="high.critical"}
    • hw.temperature.limit{limit_type="high.degraded"}
    • sensor_location
    Voltage Sensor
    • hw.status{hw.type="voltage",state="present"}
    • hw.voltage
    • sensor_location
    No results.