Bug Reports

Use the Bug Report command-line tool to capture and archive cluster information

Use the vz bug-report tool to selectively capture cluster information and create an archive (*.tar.gz) file to help diagnose problems. The archive file helps development and support teams analyze issues and provide recommendations.

CLI setup

To set up the vz command-line tool, follow the steps here.

Use the vz bug-report tool

To create a bug report in a TAR file named my-bug-report.tar.gz:

$ vz bug-report --report-file my-bug-report.tar.gz

We suggest that you review the contents of the bug report before sharing it with support and development teams.

Usage information

Use the following syntax to run vz commands from your terminal window.

$ vz bug-report [flags]

Available options

Command Definition
-h, --help Help for vz bug-report command.
-i, --include-namespaces strings A comma-separated list of additional namespaces for collecting cluster information. This flag can be specified multiple times, such as --include-namespaces ns1 --include-namespaces ns...
-r, --report-file string The report file created by the vz bug-report command, as a *.tar.gz file. Defaults to bug-report.tar.gz in the current directory.
-v, --verbose Enable verbose output.

Available flags

These flags apply to all the commands.

Flag Definition
--context string The name of the kubeconfig file context to use.
--kubeconfig string Path to the kubeconfig file to use.

Examples

  • Create a bug report file, bugreport.tar.gz, by collecting data from the cluster:

    $ vz bug-report --report-file bugreport.tar.gz
    

    When --report-file is not provided, the command creates bug-report.tar.gz in the current directory.

  • Create a bug report file, bugreport.tar.gz, including the additional namespace ns1 from the cluster:

    $ vz bug-report --report-file bugreport.tgz --include-namespaces ns1
    
  • The flag --include-namespaces accepts comma-separated values and can be specified multiple times. For example, the following commands create a bug report by including additional namespaces ns1, ns2, and ns3:

    $ vz bug-report --report-file bugreport.tgz --include-namespaces ns1,ns2,ns3
    $ vz bug-report --report-file bugreport.tgz --include-namespaces ns1,ns2 --include-namespaces ns3
    

    The values specified for the flag --include-namespaces are case-sensitive.