Troubleshooting and Diagnostics#

See the latest features and updates for this version of NVIDIA Nsight Integration.

Troubleshooting#

Common issues with NVIDIA Nsight Integration and their solutions are detailed below.

Nsight Menu Is Missing or Not in the Expected Location in Visual Studio 2019 or later#

Problem: The Nsight menu is not on the Visual Studio main menu#

Solution

In Visual Studio 2019 and later, extensions appear by default under the Extensions menu.

Problem: The Nsight menu is not in the expected location after excluding from Extension Solution#

Solution

If you are using Visual Studio 2019 Update 4 or later, you specify if you want the Nsight menu to appear under the Visual Studio main menu or the Extensions menu using the Exclusions customization. If the menu is not appearing where you expect, it is probably because there are two extensions at work here: NVIDIA Nsight Visual Studio Edition and NVIDIA Nsight Integration.

Here’s how they work together:

  • Both extensions provide an Nsight menu

  • Nsight tools are actually added to both Nsight menus.

  • If only NVIDIA Nsight Integration is installed, the Nsight menu is visible through this extension.

  • If the NVIDIA Nsight Integration Extension is installed, the Nsight menu is always visible through this extension.

    • If only NVIDIA Nsight Integration is also installed, the Nsight menu is hidden in this extension.

When working with the Visual Studio main menu > Tools > Customize, note that:

  • If only NVIDIA Nsight Integration is installed,

    • The Nsight Developer Tools Integration checkbox controls where the Nsight menu is parented.

  • If the NVIDIA Nsight Integration Extension is installed,

    • The Nsight Visual Studio Edition checkbox controls where the Nsight menu is parented.

Problem: The Nsight menu is not in the expected location after installing NVIDIA Nsight VSE#

This issue occurs when:

  • You’ve installed NVIDIA Nsight Integration;

  • Excluded it from the Extensions menu, so that it is parented by the Visual Studio main menu;

  • Then, installed NVIDIA Nsight Visual Studio Edition and note that the Nsight menu has unexpectedly moved to the Extensions menu.

Solution

The installation of the two extensions has caused this change in behavior, because they share the Nsight menu. Specifically:

  • NVIDIA Nsight Visual Studio Edition causes the NVIDIA Nsight IntegrationNsight menu to be hidden.

  • Newly installed extensions default to ‘checked’ and will be parented in the Extensions menu.

    So, the visible NVIDIA Nsight Visual Studio Edition Nsight menu is shown in the Extensions menu.

To change this behavior, you simply need to uncheck the Nsight Visual Studio Edition in the Exclusions customization.

Extension Installation Failures#

Problem: The extension has a lower version than required by Visual Studio#

The extension fails to install with the following message:

The extension has a lower version than required by Visual Studio. Please install the extension from Visual Studio Installer instead.

Solutions

Ensure your temporary directory is not caching an older version.

  1. Uninstall NVIDIA Nsight Integration from all versions of Visual Studio as described in Uninstall the Nsight Integration Extension.

  2. Shut down all instances of Visual Studio.

  3. Delete the following:

    C:\Users\[yourUser]\AppData\Local\Temp\*.vsix

  4. Restart Visual Studio and try again.

Ensure your download is not caching an older version.

  1. Go directly to the Visual Studio MarketPlace and download the latest version as described in Appendix A

  2. Unzip the Nvda.Vsip.Launcher archive.

  3. Open manifest.json and confirm the version is what you expect.

Problem: The extension is already installed#

When you try to install NVIDIA Nsight Integration, you get a message saying that it is already installed.

Solution

Search for and remove existing versions

  1. Uninstall NVIDIA Nsight Integration from all versions of Visual Studio as described in Uninstall the Nsight Integration Extension.

  2. Shut down all instances of Visual Studio.

  3. Go to the Visual Studio installation folder; for example:

    C:\Program Files\Microsoft Visual Studio\2022

    C:\Program Files (x86)\Microsoft Visual Studio\2019

    C:\Program Files (x86)\Microsoft Visual Studio\2017

    C:\Program Files (x86)\Microsoft Visual Studio 14.0 [for Visual Studio 2015]

  4. Recursively search for Nvda.Vsip.Launcher.dll, and delete any folder it appears in.

    dir /s  Nvda.Vsip.Launcher.dll

  5. For the desired version of Visual Studio, retry the installation from the Extension Manager, or run from the command prompt:

    devenv.com /setup /nosetupvstemplates

    For example:

    C:\Program Files (x86)\Microsoft Visual Studio\2019\Professional\Common7\IDE\devenv.com

    or

    C:\Program Files\Microsoft Visual Studio\2022\Professional\Common7\IDE\devenv.com

  6. Restart Visual Studio and try again.