Skip to main content

Python module

max.profiler.gpu

GPU diagnostics API.

This module allows accessing information about GPU(s) on the system. Information can be accessed synchronously or collected in the background for later retrieval.

Monitoring

GPUDiagContextContext manager providing unified access to GPU diagnostic information across NVIDIA and AMD hardware.
BackgroundRecorderAsynchronous GPU metrics collection and data export capabilities.

Stats

GPUStatsGPU state snapshot: memory, utilization, and clock metrics.
MemoryStatsDetailed GPU memory usage statistics including total, free, used, and reserved memory.
UtilizationStatsGPU compute and memory activity utilization percentages.
ClockStatsCurrent and maximum GPU clock rates plus throttle reasons.
ThrottleReasonalias of Literal['gpu_idle', 'applications_clocks_setting', 'sw_power_cap', 'hw_slowdown', 'sync_boost', 'sw_thermal_slowdown', 'hw_thermal_slowdown', 'hw_power_brake_slowdown', 'display_clock_setting']
HARDWARE_THROTTLE_REASONSBuild an immutable unordered collection of unique elements.