Generate NVIDIA bug report for Blackwell GPUs

This document explains how to create an NVIDIA bug report for your machine typesthat useNVIDIA Blackwell GPUs.If you want to identify which of your machine types are using the NVIDIA Blackwell GPU, seeGPU models.

If your machine type uses the NVIDIA Blackwell GPU architecture, the generatedNVIDIA bug report doesn't include critical low-level hardware data when you runthenvidia-bug-report.shscript. This data contains information such as the physical layer status of NVLinkconnections, internal GPU register values, and raw diagnostic segments from thefirmware. This information is essential for diagnosing issues, especially thoserelated to NVLink, which could lead toGPU Xid errorsor unresolved performance degradation.

Generate an NVIDIA bug report

To generate a bug report, complete the following steps:

  1. Connect to your GPU instance. Choose one of the following options:

  2. Download and install the MFT package by selecting one of the following options:

Container-Optimized OS

If your instance uses a Container-Optimized OS (COS) as the guest operating system, use the open sourceCOS NVIDIA Bug Report Collector tool to generate the bug report with MFT. This tool automatically injects supported MST kernel modules that match the COS kernel, installs the userspace tool, generates the bug report, and optionally uploads the result to a Cloud Storage bucket.

Other OS

For other Linux OSes, complete the following steps:

  1. Download and install NVIDIA Firmware Tools (MFT) software version 4.32.0 or higher from theNVIDIA website.
  2. Install the tool. For more information, seeCompilation and installation in the NVIDIA Firmware Tools (MFT) Documentation. After you install MFT, thenvidia-bug-report.sh script automatically uses the MFT tools to generate the report. You don't need to interact with MFT tools directly.
  3. Run thenvidia-bug-report.sh script to generate a bug report. This process takes about two minutes.
  4. Extract the report.
  5. Verify that the report includes MFT data by running the following command on your extracted bug report file:
    grep -m 1 -A 30 "Starting GPU MST dump.."PATH_TO_UNZIPPED_BUG_REPORT

    The output is similar to the following example:

    Starting GPU MST dump..... (additional MFT data) ...

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-12-15 UTC.