Using the Log Files - Amazon DCV
Changing Log File Verbosity

Using the Log Files

The Amazon DCV log files can be used to identify and troubleshoot problems with your Amazon DCV server. The Amazon DCV log files can be found in the following location on your Amazon DCV server:

  • Windows server

    C:\ProgramData\NICE\dcv\log\
    Note

    The ProgramData folder might be hidden by default. If you do not see the ProgramData folder, set your file browser to show hidden items. Alternatively, enter %programdata% in the address bar and press Enter.

  • Linux server

    /var/log/dcv/

Multiple files with a similar name may be present. The numeric suffix identifies the age of a file. The numbers get higher as the file gets older.

As you troubleshoot connection issues, the server.log file is the most relevant. When submitting a support request, attaching the whole folder is preferred, but older files can be excluded to limit the attachment size.

The Amazon DCV server enables you to configure the verbosity level of the log files. The following verbosity levels are available:

  • error — Provides the least detail. Includes errors only.

  • warn — Includes errors and warnings.

  • info — The default verbosity level. Includes errors, warnings, and information messages.

  • debug — Provides the most detail. Provides detailed information that is useful for debugging issues.

Changing Log File Verbosity

Changing verbosity enables you to adjust the level of detail in your logs, helping you diagnose and resolve issues more effectively. Increasing log verbosity captures more granular information about system. Decreasing log verbosity optimizes storage and enhances performance.

For Windows

For Amazon DCV versions after the 2023.0 release, it is preferred to configure the log file verbosity via the command line. For older versions, you must configure the level parameter using the Windows Registry Editor.

Release 2023.0 and newer

  1. Open a Command Prompt and Run as administrator.

  2. Go to the installation directory:

    C:\Program Files\NICE\DCV\Server\bin

  3. Enter the following command to set the level:

    dcv set-config --section log --key level "'LEVEL'"

  4. Enter the following command to enable debugging:

    dcv set-config --section log --key level "'debug'"
Note

Make sure you are using both double and single quotation marks.

Release 2022.2 and older

  1. Open the Windows Registry Editor.

  2. Navigate to the HKEY_USERS/S-1-5-18/Software/GSettings/com/nicesoftware/dcv/log/ key.

  3. Open the level parameter by double-clicking. For Value data, type either error, warn, info, or debug, depending on the required verbosity level.

  4. Choose OK and close the Windows Registry Editor.

For Linux

For Amazon DCV versions after the 2023.0 release, it is preferred to configure the log file verbosity via the command line. For older versions, you must configure the level parameter in the dcv.conf file.

Release 2023.0 and newer

  1. Open a terminal.

  2. Enter the following command to set the level:

    sudo dcv set-config --section log --key level "'LEVEL'"

  3. Enter the following command to enable debugging:

    sudo dcv set-config --section log --key level "'debug'"
Note

Make sure you are using both double and single quotation marks.

Release 2022.2 and older

  1. Navigate to /etc/dcv/ and open the dcv.conf with your preferred text editor.

  2. Locate the level parameter in the [log] section, and replace the existing verbosity level with either error, warn, info, or debug.

    
[log]
level="verbosity_level"

  3. Save and close the file.