Skip to navigation

Metrics and Telemetry

View as Markdown

Metrics are numeric measurements recorded over time that are emitted from the NVIDIA Run:ai cluster and telemetry is a numeric measurement recorded in real-time when emitted from the NVIDIA Run:ai cluster.

Scopes

NVIDIA Run:ai provides control-plane API which supports and aggregates analytics at various levels.

LevelDescription
ClusterA cluster is a set of nodes pools and nodes. With Cluster metrics, metrics are aggregated at the Cluster level. In the NVIDIA Run:ai user interface, metrics are available in the Overview dashboard.
NodeData is aggregated at the node level.
Node poolData is aggregated at the node pool level.
WorkloadData is aggregated at the workload level. In some workloads, e.g. with distributed workloads, these metrics aggregate data from all worker pods.
PodThe basic unit of execution.
ProjectThe basic organizational unit. Projects are the tool to implement resource allocation policies as well as the segregation between different initiatives.
DepartmentDepartments are a grouping of projects.

Supported Metrics

Metric name in APIApplicable API endpointMetric name in UI per gridApplicable UI grid
ALLOCATED_GPU
  • Clusters
  • Node pools
  • GPU devices (allocated)
  • Allocated GPUs
  • Overview dashboard
  • Node pools
AVG_WORKLOAD_WAIT_TIME
  • Clusters
  • Node pools
CPU_LIMIT_CORESWorkloadsCPU limitWorkloads
CPU_MEMORY_LIMIT_BYTESWorkloadsCPU memory limitWorkloads
CPU_MEMORY_REQUEST_BYTESWorkloadsCPU memory requestWorkloads
CPU_MEMORY_USAGE_BYTES
  • Workloads
  • Pods
CPU memory usageWorkloads
CPU_MEMORY_UTILIZATION
  • Clusters
  • Node pools
  • Nodes
CPU memory utilization
  • Overview dashboard
  • Node pools
  • Nodes
CPU_REQUEST_CORESWorkloadsCPU requestWorkloads
CPU_USAGE_CORES
  • Nodes
  • Workloads
  • Pods
CPU usageWorkloads
CPU_UTILIZATION
  • Clusters
  • Node pools
  • Nodes
  • CPU compute utilization
  • CPU utilization
  • Overview dashboard and Node pools
  • Nodes
GPU_ALLOCATION
  • Workloads
  • Projects
  • Departments
GPU devices (allocated)Overview dashboard
GPU_MEMORY_REQUEST_BYTESWorkloadsGPU memory requestWorkloads
GPU_MEMORY_USAGE_BYTES
  • Workloads
  • Pods
  • Nodes
GPU memory usageWorkloads
GPU_MEMORY_USAGE_BYTES_PER_GPU
  • Nodes
  • Pods
GPU memory usage per GPUWorkloads per pod
GPU_MEMORY_UTILIZATION
  • Clusters
  • Node pools
GPU memory utilization
  • Overview dashboard
  • Node pools
GPU_MEMORY_UTILIZATION_PER_GPUNodesGPU memory utilization per GPUNodes
GPU_QUOTA
  • Clusters
  • Node pools
  • Projects
  • Departments
QuotaQuota management
GPU_UTILIZATION
  • Clusters
  • Node pools
  • Workloads
  • Pods
GPU compute utilization
  • Overview dashboard
  • Node pools
  • Workloads
GPU_UTILIZATION_PER_GPU
  • Nodes
  • Pods
GPU utilization per GPUNodes
TOTAL_GPU
  • Clusters
  • Node pools
  • GPU devices total
  • Total GPUs
  • Overview dashboard
  • Node pools
TOTAL_GPU_NODES
  • Clusters
  • Node pools
GPU_UTILIZATION_DISTRIBUTION
  • Clusters
  • Node pools
GPU utilization distributionNode pools
UNALLOCATED_GPU
  • Clusters
  • Node pools
  • GPU devices (unallocated)
  • Unallocated GPUs
  • Overview dashboard
  • Node pools
CPU_QUOTA_MILLICORES
  • Projects
  • Departments
CPU_MEMORY_QUOTA_MB
  • Projects
  • Departments
CPU_ALLOCATION_MILLICORES
  • Projects
  • Departments
CPU_MEMORY_ALLOCATION_MB
  • Projects
  • Departments
POD_COUNTWorkloads
RUNNING_POD_COUNTWorkloads
NVLINK_BANDWIDTH_TOTAL
  • Nodes
  • Pods
  • Nodes
  • Workloads per pod

GPU Profiling

NVIDIA provides extended metrics as shown here.

Note

GPU profiling metrics are disabled by default. If unavailable, your administrator must enable it under General settings → Analytics → GPU profiling metrics. Before enabling, the administrator must configure GPU profiling through the DCGM Exporter and NVIDIA Run:ai Prometheus integration. For configuration steps, see GPU profiling metrics.

Metric name in APIApplicable API endpointMetric name in UIApplicable UI table
GPU_FP16_ENGINE_ACTIVITY_PER_GPU
  • Pods
  • Nodes
GPU FP16 engine activity
  • Workloads
  • Nodes
GPU_FP32_ENGINE_ACTIVITY_PER_GPU
  • Pods
  • Nodes
GPU FP32 engine activity
  • Workloads
  • Nodes
GPU_FP64_ENGINE_ACTIVITY_PER_GPU
  • Pods
  • Nodes
GPU FP64 engine activity
  • Workloads
  • Nodes
GPU_GRAPHICS_ENGINE_ACTIVITY_PER_GPU
  • Pods
  • Nodes
Graphics engine activity
  • Workloads
  • Nodes
GPU_MEMORY_BANDWIDTH_UTILIZATION_PER_GPU
  • Pods
  • Nodes
Memory bandwidth utilization
  • Workloads
  • Nodes
GPU_NVLINK_RECEIVED_BANDWIDTH_PER_GPU
  • Pods
  • Nodes
NVLink received bandwidth
  • Workloads
  • Nodes
GPU_NVLINK_TRANSMITTED_BANDWIDTH_PER_GPU
  • Pods
  • Nodes
NVLink transmitted bandwidth
  • Workloads
  • Nodes
GPU_PCIE_RECEIVED_BANDWIDTH_PER_GPU
  • Pods
  • Nodes
PCIe received bandwidth
  • Workloads
  • Nodes
GPU_PCIE_TRANSMITTED_BANDWIDTH_PER_GPU
  • Pods
  • Nodes
PCIe transmitted bandwidth
  • Workloads
  • Nodes
GPU_SM_ACTIVITY_PER_GPU
  • Pods
  • Nodes
GPU SM activity
  • Workloads
  • Nodes
GPU_SM_OCCUPANCY_PER_GPU
  • Pods
  • Nodes
GPU SM occupancy
  • Workloads
  • Nodes
GPU_TENSOR_ACTIVITY_PER_GPU
  • Pods
  • Nodes
GPU tensor activity
  • Workloads
  • Nodes
GPU_OOMKILL_SWAP_OUT_OF_RAM_COUNT_PER_GPUNodesOOMKill swap out of RAM countNodes
GPU_OOMKILL_BURST_COUNT_PER_GPUNodesOOMKill burst countNodes
GPU_OOMKILL_IDLE_COUNT_PER_GPUNodesOOMKill idle countNodes
GPU_SWAP_MEMORY_BYTES_PER_GPUPodsGPU swap memoryWorkloads

NVIDIA NIM

NVIDIA NIM metrics provide workload-level observability, including key runtime and performance data such as request throughput, latency, and token usage for LLMs. See NIM observability metrics via API for more details.

Metric name in APIApplicable API endpointMetric name in UIApplicable UI table
NIM_NUM_REQUESTS_RUNNING
  • Pods
  • Workloads
Request concurrency by statusWorkloads
NIM_NUM_REQUESTS_WAITING
  • Pods
  • Workloads
Request concurrency by statusWorkloads
NIM_NUM_REQUEST_MAX
  • Pods
  • Workloads
Request concurrency by statusWorkloads
NIM_REQUEST_SUCCESS_TOTAL
  • Pods
  • Workloads
Request count by statusWorkloads
NIM_REQUEST_FAILURE_TOTAL
  • Pods
  • Workloads
Request count by statusWorkloads
NIM_GPU_CACHE_USAGE_PERC
  • Pods
  • Workloads
GPU KV cache utilizationWorkloads
NIM_TIME_TO_FIRST_TOKEN_SECONDS
  • Pods
  • Workloads
Time to first token (TTFT)Workloads
NIM_E2E_REQUEST_LATENCY_SECONDS
  • Pods
  • Workloads
End to end request latencyWorkloads
NIM_TIME_TO_FIRST_TOKEN_SECONDS_PERCENTILES
  • Pods
  • Workloads
Time to first token (TTFT) by percentilesWorkloads
NIM_E2E_REQUEST_LATENCY_SECONDS_PERCENTILES
  • Pods
  • Workloads
End to end request latency by percentilesWorkloads

vLLM

vLLM metrics provide workload-level observability for large language model (LLM) inference workloads served with the vLLM inference engine, including request concurrency, token throughput, latency, and GPU KV-cache utilization. NVIDIA Run:ai detects a vLLM workload automatically from the container image name, or you can set it explicitly with the run.ai/vllm-workload label.

Metric name in APIApplicable API endpointMetric name in UI per gridApplicable UI grid
VLLM_NUM_REQUESTS_RUNNING
  • Pods
  • Workloads
Request concurrency by statusWorkloads
VLLM_NUM_REQUESTS_WAITING
  • Pods
  • Workloads
Request concurrency by statusWorkloads
VLLM_REQUEST_SUCCESS
  • Pods
  • Workloads
Request count by statusWorkloads
VLLM_REQUEST_SUCCESS_RATE
  • Pods
  • Workloads
Request success rateWorkloads
VLLM_KV_CACHE_USAGE_PERC
  • Pods
  • Workloads
GPU KV cache utilizationWorkloads
VLLM_PROMPT_TOKENS_PER_SECOND
  • Pods
  • Workloads
Token throughputWorkloads
VLLM_GENERATION_TOKENS_PER_SECOND
  • Pods
  • Workloads
Token throughputWorkloads
VLLM_TIME_TO_FIRST_TOKEN_SECONDS
  • Pods
  • Workloads
Time to first token (TTFT)Workloads
VLLM_TIME_TO_FIRST_TOKEN_SECONDS_PERCENTILES
  • Pods
  • Workloads
Time to first token (TTFT) by percentilesWorkloads
VLLM_E2E_REQUEST_LATENCY_SECONDS
  • Pods
  • Workloads
End to end request latencyWorkloads
VLLM_E2E_REQUEST_LATENCY_SECONDS_PERCENTILES
  • Pods
  • Workloads
End to end request latency by percentilesWorkloads
VLLM_REQUEST_QUEUE_TIME_SECONDS_PERCENTILES
  • Pods
  • Workloads
Queue time percentilesWorkloads
VLLM_REQUEST_PREFILL_TIME_SECONDS_PERCENTILES
  • Pods
  • Workloads
Latency phase breakdownWorkloads
VLLM_REQUEST_DECODE_TIME_SECONDS_PERCENTILES
  • Pods
  • Workloads
Latency phase breakdownWorkloads
VLLM_INTER_TOKEN_LATENCY_SECONDS_PERCENTILES
  • Pods
  • Workloads
Latency phase breakdownWorkloads

Supported Telemetry

MetricApplicable API endpointMetric name in UIApplicable UI table
WORKLOADS_COUNTWorkloads
ALLOCATED_GPUSNodesAllocated GPUsNodes
GPU_allocation
  • Workloads
  • Projects
  • Departments
READY_GPU_NODESNodesReady / Total GPU nodesOverview dashboard
READY_GPUSNodesReady / Total GPU devicesOverview dashboard
TOTAL_GPU_NODESNodesReady / Total GPU nodesOverview dashboard
TOTAL_GPUSNodesReady / Total GPU devicesOverview dashboard
IDLE_ALLOCATED_GPUSNodesIdle allocated GPU devicesOverview dashboard
FREE_GPUSNodesFree GPU devicesNodes
TOTAL_CPU_CORESNodesCPU (Cores)Nodes
USED_CPU_CORESNodes
ALLOCATED_CPU_CORES
  • Nodes
  • Projects
  • Departments

Allocated CPU cores

Nodes
TOTAL_GPU_MEMORY_BYTESNodesGPU memoryNodes
USED_GPU_MEMORY_BYTESNodesUsed GPU memoryNodes
TOTAL_CPU_MEMORY_BYTESNodesCPU memoryNodes
USED_CPU_MEMORY_BYTESNodesUsed CPU memoryNodes
ALLOCATED_CPU_MEMORY_BYTES
  • Nodes
  • Projects
  • Departments
Allocated CPU memory
  • Nodes
  • Projects
  • Departments
GPU_QUOTA
  • Projects
  • Departments
GPU quota
  • Projects
  • Departments
CPU_QUOTA
  • Projects
  • Departments
MEMORY_QUOTA
  • Projects
  • Departments
GPU_ALLOCATION_NON_PREEMPTIBLE
  • Projects
  • Departments
CPU_ALLOCATION_NON_PREEMPTIBLE
  • Projects
  • Departments
MEMORY_ALLOCATION_NON_PREEMPTIBLE
  • Projects
  • Departments