Table of Contents

GQI logging

Logging for GQI is available from DataMiner 10.4.0/10.4.4 onwards.

Errors and warnings are logged to log files in the folder C:\Skyline DataMiner\Logging\GQI.

If this folder does not exist, it will be created automatically with the first log.

From DataMiner 10.4.6/10.5.0 onwards, information about SLNet requests is also logged to the log files in the C:\Skyline DataMiner\Logging\GQI folder, if the minimum log level is set to Debug or lower.

From DataMiner 10.4.0 [CU3]/10.4.5 onwards, metrics such as the duration of individual GQI requests are also logged, in the folder C:\Skyline DataMiner\Logging\GQI\Metrics.

Note

The logs are buffered and written asynchronously, so it may take a few seconds for them to appear in the file.

Minimum log level

GQI uses Serilog to write the log files. This logging framework defines six log levels:

  1. Verbose
  2. Debug
  3. Information
  4. Warning
  5. Error
  6. Fatal

The minimum log level determines from which log level onwards logs are included in the log file. By default, the minimum log level is Information, so only logs of level Information, Warning, Error, and Fatal are included.

You can change the minimum log level to include less or more information in the log file. For example, to investigate potential issues, it can be useful to lower the minimum log level to Debug.

From DataMiner 10.4.6/10.5.0 onwards, when you change the minimum log level to Debug or lower, information about requests sent to SLNet is also logged.

To change the minimum log level, change the configuration in the appSettings section in C:\Skyline DataMiner\Files\SLHelper.exe.config. For example:

<appSettings>
    ...
    <add key="serilog:minimum-level" value="Information" />
    ...
</appSettings>
Important

Prior to DataMiner 10.4.6/10.5.0, a change to the minimum log level requires an SLHelper restart. From DataMiner 10.4.6/10.5.0 onwards, it is no longer necessary to restart SLHelper. The change takes effect immediately upon saving the SLHelper.exe.config file.

For some requests, from DataMiner 10.4.0 [CU3]/10.4.5 onwards, the query name is included in the logging. However, if you set the minimum log level to Debug, the full query is logged instead.

Note

Any changes to the configuration file are reset after a full DataMiner upgrade or downgrade.

Propose changes