1. Release Notes#
The CUPTI Python Release Notes include new features, important bug fixes, known issues, supported platforms, and supported GPUs.
1.1. Updates in CUPTI Python Releases#
1.1.1. Updates in CUPTI Python 13.2.0#
Refer CUPTI C 13.2.0 release notes.
New Features
The
cupti.cupti.CallbackDomain.NVTXcallback domain is now supported.The
cupti.cupti.CallbackData.function_paramsfield ofcupti.cupti.CallbackDatais now supported.New Activity kinds and classes:
cupti.cupti.ActivityKind.GRAPH_HOST_NODEwithcupti.cupti.ActivityGraphHostNodecupti.cupti.ActivityKind.COMPUTE_ENGINE_CTX_SWITCHwithcupti.cupti.ActivityComputeEngineCtxSwitchcupti.cupti.ActivityKind.GREEN_CONTEXTwithcupti.cupti.ActivityGreenContextcupti.cupti.ActivityKind.HOST_LAUNCHwithcupti.cupti.ActivityHostLaunch
New activity classes:
cupti.cupti.ActivityKernel11,cupti.cupti.ActivityContext4,cupti.cupti.ActivityMarkerData2,cupti.cupti.ActivityDevice6Support for Python 3.14 has been added.
Deprecated and dropped features
Dropped activity classes:
cupti.cupti.ActivityKernel10,cupti.cupti.ActivityContext3,cupti.cupti.ActivityMarkerData,cupti.cupti.ActivityDevice5Support for Python 3.9 has been dropped.
1.1.2. Updates in CUPTI Python 13.0.1#
Refer CUPTI C 13.0.1 release notes.
New Features
Relaxed nvidia-cuda-cupti dependency:
cupti-pythonnow supportsnvidia-cuda-cuptiversions>=13.0.0and<14.Relaxed cuda-bindings dependency:
cupti-pythonnow supportscuda-bindingsversions>=13.0.0and<14.
1.1.3. Updates in CUPTI Python 13.0.0#
Refer CUPTI C 13.0.0 release notes.
New Features
New Activity Kind
cupti.cupti.ActivityKind.ROTATIONand its corresponding activity classcupti.cupti.ActivityConfidentialComputeRotationhas been added.Support for Activity Kind
cupti.cupti.ActivityKind.RUNTIMEand Callback Domaincupti.cupti.CallbackDomain.RUNTIME_APIhave been added.New activity classes
cupti.cupti.ActivityKernel10andcupti.cupti.ActivityMemoryPool3have been introduced.Support for APIs
cupti.cupti.subscribe_v2(),cupti.cupti.activity_enable_cuda_event_device_timestamps()andcupti.cupti.activity_enable_all_sync_records()has been added.Added
cupti.pyistub file to improve IDE support, including type hints and auto-completion.Support for Python 3.13 has been added.
Support for Linux (aarch64 sbsa) architecture has been added.
Deprecated and dropped features
Support for activity classes
cupti.cupti.ActivityKernel9andcupti.cupti.ActivityMemoryPool2has been removed.
1.1.4. Updates in CUPTI Python 12.8.0#
Refer CUPTI C 12.8.0 release notes.
New Features
New Activity Kind
cupti.cupti.ActivityKind.MEM_DECOMPRESSand its corresponding activity classcupti.cupti.ActivityMemDecompresshas been added.New Activity Kind
cupti.cupti.ActivityKind.DEVICE_GRAPH_TRACEand its corresponding activity classcupti.cupti.ActivityDeviceGraphTracehas been added.New activity classes
cupti.cupti.ActivityMemcpy6,cupti.cupti.ActivityUnifiedMemoryCounter3,cupti.cupti.ActivityCudaEvent2andcupti.cupti.ActivitySynchronization2have been introduced.Support for API
cupti.cupti.activity_enable_hw_trace()has been added.
Deprecated and dropped features
Support for activity classes
cupti.cupti.ActivityMemcpy5,cupti.cupti.ActivityUnifiedMemoryCounter2,cupti.cupti.ActivityCudaEventandcupti.cupti.ActivitySynchronizationhas been removed.
1.1.5. Updates in CUPTI Python 12.6.0#
This was the first CUPTI Python release. Refer CUPTI C 12.6.0 release notes.
1.2. Limitations#
1.2.1. Known Issues#
Libraries like NCCL that emit NVTX annotations with extended payloads can now be decoded using CUPTI; however, this capability is not yet supported in CUPTI Python.
1.2.2. Known Limitations#
CUPTI Python cannot collect tracing data when the Python interpreter is tearing down or is not in a proper state. The callbacks registered by functions
cupti.cupti.activity_register_callbacks(),cupti.cupti.activity_register_timestamp_callback(),cupti.cupti.subscribe(), andcupti.cupti.subscribe_v2()will not be dispatched in such cases. For example, CUDA API calls that occur in a class’s__del__method will not be traced.
1.3. Support#
Information on supported python versions, platforms, and GPUs.
1.3.1. Python Support#
Python 3.10 - 3.14
1.3.2. Platform Support#
Linux (x86_64)
Linux (aarch64 sbsa)
1.3.3. GPU Support#
Turing and later GPU architectures, i.e. devices with compute capability 7.5 and higher.