Is this page helpful?

Log and Runtime Files#

NVIDIA AI Workbench creates log and runtime files that you can use to debug issues, and to understand the state of your applications. There are log files for the AI Workbench Desktop Application, Service, CLI, and for applications that you use with AI Workbench. Some log file content appears in the desktop application, so that you can monitor your projects and apps while they are running.

Use this documentation to perform the following tasks:

Access Log Files From the Desktop Application#

To access server and app log files from the AI Workbench Desktop Application (Desktop App), do the following:

  1. In the status bar, click Output to open the output pane.

  2. In the drop-down, select Service or the name of an app, such as JupyterLab to view the log file in the output pane.

Manually Access Log Files#

For local locations, all log files are on the local computer. For remote locations, the server and app log files are on the remote computer, and the desktop application and CLI log files are on your local machine. SSH into the remote computer to view the server and app log files.

To access log files manually, find them in the following locations.

Important

When you install AI Workbench on Windows, a folder named Linux\NVIDIA-Workbench (\wsl.localhost\NVIDIA-Workbench) is added to your File Explorer.

Log File Type

Location

Desktop application log files

C:\Users\<USERNAME>\AppData\Local\NVIDIA Corporation\AI Workbench\logs\main.log

Server log files

Linux\NVIDIA-Workbench\home\workbench\.nvwb\logs\workbench.log

CLI log files

Linux\NVIDIA-Workbench\home\workbench\.nvwb\logs\nvwb.log

Application log files

Linux\NVIDIA-Workbench\home\workbench\.nvwb\project-runtime-info\<PROJECT-NAME-AND-HASH>\<APP-NAME>-start.log

Log File Type

Location

Desktop application log files

/home/<USERNAME>/.config/NVIDIA/AI Workbench/logs/main.log

Server log files

/home/<USERNAME>/.nvwb/logs/workbench.log

CLI log files

/home/<USERNAME>/.nvwb/logs/nvwb.log

Application log files

/home/<USERNAME>/.nvwb/project-runtime-info/<PROJECT-NAME-AND-HASH>/<APP-NAME>-start.log

Log File Type

Location

Desktop application log files

/Users/<USERNAME>/Library/Application Support/NVIDIA/AI Workbench/logs/main.log

Server log files

/Users/<USERNAME>/.nvwb/logs/workbench.log

CLI log files

/Users/<USERNAME>/.nvwb/logs/nvwb.log

Application log files

/Users/<username>/.nvwb/project-runtime-info/<PROJECT-NAME-AND-HASH>/<APP-NAME>-start.log

Create a Support Bundle for Troubleshooting#

In some cases, you might need to create a support bundle. A support bundle is a .zip file that contains log files, configuration information, and system state for your AI Workbench installation. For more information, see support create-bundle. We attempt to automatically exclude sensitive or identifiable information. However, always review the contents of a support bundle before you share it with anyone.

You always create a support bundle for your local location. If the currently active location is a remote location, or if you specify a remote location when you create the support bundle, a support bundle is created for the remote location first, and included in the support bundle for your local location.

Use the following procedure to create a support bundle.

  1. Access the AI Workbench CLI. For instructions, see Basic Quickstart (CLI).

  2. Run the support create-bundle command.

    nvwb support create-bundle

    • or -

    nvwb support create-bundle --context <location name>

    When the command completes, the message Support bundle created appears with the location of the file.

  3. Find the support bundle file in the following location.

    Important

    When you install AI Workbench on Windows, a folder named Linux\NVIDIA-Workbench (\wsl.localhost\NVIDIA-Workbench) is added to your File Explorer.

    Location: Linux\NVIDIA-Workbench\home\workbench\.nvwb\ai-workbench-support-bundle-<USERNAME>-<TIMESTAMP>.zip

    Location: ~/.nvwb/ai-workbench-support-bundle-<USERNAME>-<TIMESTAMP>.zip

    — or —

    Location: ~/.nvwb/remote-ai-workbench-support-bundle-<USERNAME>-<TIMESTAMP>.zip

    Location: ~/.nvwb/ai-workbench-support-bundle-<USERNAME>-<TIMESTAMP>.zip

AI Workbench Project Runtime Files#

AI Workbench creates files to track progress while building, configuring, and running each project. These files are essential for managing a project’s runtime operations.

Important

You should never commit these files to your Git repository.

The project runtime files are created in the following location based on your operating system.

Location: Linux\NVIDIA-Workbench\home\workbench\.nvwb\project-runtime-info\<PROJECT-NAME-AND-HASH>

Important

When you install AI Workbench on Windows, a folder named Linux\NVIDIA-Workbench (\wsl.localhost\NVIDIA-Workbench) is added to your File Explorer.

Location: /home/<USERNAME>/.nvwb/project-runtime-info/<PROJECT-NAME-AND-HASH>

Location: /Users/<USERNAME>/.nvwb/project-runtime-info/<PROJECT-NAME-AND-HASH>

The possible files and directories stored in this directory are the following:

File/Directory

Description

Containerfile

Generated on demand during the project build (can also be called a Dockerfile).

build-output.success

Build logs from the last successful build.

build-output.error

Build logs from the last failed build.

build-output.building

Build logs from the currently in-progress build.

cache/

Directory that acts as the build context for the container build.

edit.cache

The cache value of the last edit of the container image made by the library.

fetch-output.success

Fetch logs from the last successful fetch.

fetch-output.error

Fetch logs from the last failed fetch.

fetch-output.fetching

Fetch logs from the currently in-progress fetch.

mount/

Directory that stores mount definitions for the project’s configured mounts, as well as mount directories and unmount scripts for each mount. For more information, see Runtime Configuration (Environment Variables and Mounts).

rebuild.cache

The cache value of the last build of the container image.

runtime-flags.json

Flags used by AI Workbench.

secrets.env

The project’s secret environment variables and their values. For more information, see Environment Variables.

There are also one or more application files, depending on the applications in the project:

  • <APP_NAME>-start.log — Applicationstart logs for debugging issues. For example, jupyterlab-start.log.