cuSPARSELt Logging Features¶

Logging mechanism in cuSPARSELt can be enabled by setting the following environment variables before running the target application:

CUSPARSELT_LOG_LEVEL=<level>

while level is one of the following levels:

  • 0: Off - logging is disabled (default)
  • 1: Error - only errors will be logged
  • 2: Trace - API calls that launch CUDA kernels will log their parameters and important information
  • 3: Hints - hints that can potentially improve the application’s performance
  • 4: Info - provides general information about the library execution, may contain details about heuristic status
  • 5: API Trace - API calls will log their parameter and important information
CUSPARSELT_LOG_MASK=<mask>

while mask is a combination of the following masks:

  • 0: Off
  • 1: Error
  • 2: Trace
  • 4: Hints
  • 8: Info
  • 16: API Trace
CUSPARSELT_LOG_FILE=<file_name>

while file_name is a path to a logging file. File name may contain %i, that will be replaced with the process id. E.g <file_name>_%i.log.

If CUSPARSELT_LOG_FILE is not defined, the log messages are printed to stdout.