Get Started
- Open a terminal and navigate to the directory where oneAPI products are installed.If you installed to the default directory, the utility will be located at/opt/intel/oneapi/.
- Change to the diagnostics directory:
cd diagnostics/latest/
- Run the Diagnostics Utility for Intel® oneAPI Toolkits using this syntax:
python3 diagnostics.py --filter all
- the active console
- a JSON file
python3 diagnostics.py --filter all -v
List of Checks by Check Name
Note: the checks below are all supported on Linux.
Check Name | Groups where check is included | Description |
---|---|---|
hangcheck_check | | This check verifies that the GPU hangcheck option is disabled to
allow long-running jobs. |
user_group_check | | This check verifies that the current user is in the same group
as the GPU(s). |
driver_compatibility_check | | This check verifies compatibility of oneAPI products versions and
GPU drivers versions. |
oneapi_gpu_check | | This check runs GPU workloads and verifies readiness to run
applications on GPU(s). |
gpu_metrics_check | | This check verifies that GPU metrics are good. |
gpu_backend_check | | This check shows information from OpenCL™ and Intel® oneAPI Level
Zero drivers. |
oneapi_app_check | | This check shows version information of installed oneAPI products. |
intel_gpu_detector_check | | This check shows which Intel GPU(s) is on the system based on lspci
information and internal table. |
oneapi_env_check | | This check shows the version information of the oneAPI products
installed in the environment. |
gcc_version_check | | This check shows information about GCC compiler version. |
base_system_check | | This check shows information about hostname, CPU, BIOS and
operating system. |
kernel_options_check | | This check shows kernel options. |
user_resources_limits_check | | This check shows limits of each resource. |
sys_check | | Some oneAPI components may have checks specific to that component.
These checks will be available after setting environment variables using
the setvars script. Run the script and then run the Diagnostics
Utility with the sys_check name to see checks that are specific
to installed components. |
List of Checks by Group Name
Group of Checks | Checks included |
---|---|
compile | |
default | |
host | |
runtime | |
sysinfo | |
target | |
gpu | |
profiling | |