User Guide

  • 2022.2
  • 05/19/2022
  • Public Content

Customizing the Diagnostics Utility

The arguments below allow you to further customize your check. Multiple arguments may be added or they can be used one at a time. To use an argument, follow this syntax:
python3 diagnostics.py ARGUMENT1 ARGUMENT2
For example, to run the GPU detector check with verbosity and only output to the terminal:
python3 diagnostics.py --filter intel_gpu_detector_check -t -v
Argument
Description
Example
--filter
Filter checker results by tag or checker name tags, combine one or more checkers into groups. Each checker can be marked with one or more tags. For a full list of available checks and tags, see List of Checks by Check Name.
python3 diagnostics.py -filter oneapi_app_check
--list
Show list of available checks in the terminal window. You can also see a list of available checks and tags in List of Checks by Check Name.
python3 diagnostics.py --list
-c PATH_TO_CONFIG
Path to the JSON config file to run a group of checks or particular check from checkers.
python3 diagnostics.py -c configs/sample_config.json
-o PATH_TO_OUTPUT
Path to the folder for saving the console output file and the JSON file with the results of the performed checks.
python3 diagnostics.py -o $HOME/intel/diagnostics/logs
-t
Allow output only to the terminal window without saving additional output files.
python3 diagnostics.py -t
-s
Skip checking for update availability for existing databases.
python3 diagnostics.py -s
-u
Download new databases if they are available.
python3 diagnostics.py -u
-p
Add paths to environment variable DIAGUTIL_PATH to additionally load checks.
python3 diagnostics.py -p checkers_py/base_system_checker.py
--force
Force the program to run on any operating system.
python3 diagnostics.py --force
-v
Increase the amount of verbosity in the output. This will give more details in the output.
python3 diagnostics.py -v
--version
Show program’s version.
python3 diagnostics.py --version
-h
Show help message.
python3 diagnostics.py -h
For more information about increasing the details in the output, see Verbose Mode Options.

Product and Performance Information

1

Performance varies by use, configuration and other factors. Learn more at www.Intel.com/PerformanceIndex.