Downloading Logs from VMs

Note: As of v1.8, Enterprise PKS has been renamed to VMware Tanzu Kubernetes Grid Integrated Edition. Some screenshots in this documentation do not yet reflect the change.

Page last updated:

This topic explains how to download logs from BOSH-deployed VMs in your VMware Tanzu Kubernetes Grid Integrated Edition environment using the BOSH Command Line Interface (CLI).

Overview

In Tanzu Kubernetes Grid Integrated Edition, you can download logs from any BOSH-deployed VM, such as the TKGI API VM or Kubernetes cluster VMs.

You might need to download these logs when troubleshooting or auditing your TKGI environment.

Download Logs

To download logs from a BOSH-deployed VM:

  1. Gather credential and IP address information for your BOSH Director, SSH into the Ops Manager VM, and use the BOSH CLI to log in to the BOSH Director from the Ops Manager VM. For more information, see Advanced Troubleshooting with the BOSH CLI.
  2. After logging in to the BOSH Director, list the names of your BOSH deployments by running:

    bosh -e ENVIRONMENT deployments

    Where ENVIRONMENT is your BOSH environment alias. For example:

    $ bosh -e tkgi deployments

  3. Identify the names of the VMs that you want to retrieve logs from by listing the VMs in your target BOSH deployment:

    bosh -e ENVIRONMENT -d DEPLOYMENT vms

    Where:

    • ENVIRONMENT is the BOSH environment alias.
    • DEPLOYMENT is your target BOSH deployment name.

    For example, the following command lists the VMs in a Kubernetes cluster:

    $ bosh -e tkgi -d service-instance_ae681cd1-7ff4-4661-b12c-49a5b543f16f vms
    Kubernetes cluster deployment names begin with service-instance_ and include a unique identifier.

  4. Download logs from a VM:

    bosh -e ENVIRONMENT -d DEPLOYMENT logs VM-NAME

    For example:

    $ bosh -e tkgi \
    -d service-instance_ae681cd1-7ff4-4661-b12c-49a5b543f16f \
    logs master/000a1111-222b-3333-4cc5-de66f7a8899b
    For more information about log files, see View Log Files in Using BOSH Diagnostic Commands in Tanzu Kubernetes Grid Integrated Edition.


Please send any feedback you have to pks-feedback@pivotal.io.