Generate a diagnostic bundle

Generate a diagnostic bundle of log files for troubleshooting and analysis

Konvoy provides a subcommand to generate a diagnostic bundle with data collected for the last 48 hours of the life of the cluster.

To generate the diagnostic bundle

  1. Change to the directory that contains the state files for your Konvoy cluster state.

  2. Generate a compressed archive containing diagnostic information by running the following command:

    konvoy diagnose
    

    This command creates a bundle in the working directory with a file name that represents the timestamp for when the file was created.

  3. Verify the file was created using the current timestamp as the file name by running the following command:

    ls
    

    If the file was successfully created, the directory listing returns output similar to the following:

    20190705T114114.tar.gz
    

    The compressed archive contains detailed information about each node in the cluster, including information about the state of the system on each node and log files for each relevant running components.

  4. Extract the contents of the compressed archive to see information about the files it contains.

    For example:

    $ tar -xvf 20190705T114114.tar.gz
    x bundles/172.17.0.3.tar.gz
    x bundles/172.17.0.2.tar.gz
    
    $ tar -xvf bundles/172.17.0.3.tar.gz
    x iptables-save.txt
    x ctr-version.txt
    x containerd.service.log
    x containerd.service.status.txt
    x journalctl.log
    x kubelet.service.log
    x ansible_facts.json
    x timedatectl.txt
    x kubelet.service.status.txt
    x dmesg.txt