QKView and iHealth

Overview

The QKView utility collects diagnostic data about the cluster, the SPK Pods, and information about the SPK configurations such as Custom Resources, secrets, serviceAccounts, configMaps, etc. The collected data is stored in a diagnostic tarball that can be uploaded to the iHealth website and reviewed by your team, or shared with F5 Support when opening a support case.

Note: The SPK 1.7.0 QKView is considered Early Access (EA). EA features are unsupported, and are made available to get customer feedback on feature functionality and stability.

This document demonstrates how to run the QKView utility on you local workstation, and upload the file to the iHealth website.

Note: You must have an F5 Login account to upload QKView files to iHealth.

Ensure you have:

• Installed the SPK Controller.
• A Linux workstation with Go installed.

Procedures

Use the procedures below to generate the qkview diagnostic tarball, and upload it to the iHealth website.

Running QKView

Use these steps to generate the QKView diagnostic tarball.

1. Download the QKView tarball, and the QKView md5sum files.

2. Verify the integrity of the downloaded file:

   Note: The output from the cat and the md5sum commands should match.

   cat qkview-packaging.tar.gz.md5
   

   9c5450dcef6009ce3c153d2c29f2c8ad  qkview-packaging.tar.gz
   

   md5sum qkview-packaging.tar.gz
   

   9c5450dcef6009ce3c153d2c29f2c8ad  qkview-packaging.tar.gz
   

3. Extract the qkview-packaging.tar.gz file:

   tar xvf qkview-packaging.tar.gz
   

4. List the qkview files:

   ls -1
   

   The following files should be available.

   qkview-collector.sh
   qkview-packaging.tar.gz
   qkview-packaging.tar.gz.md5
   qkview-wrapper-darwin
   qkview-wrapper-linux
   

5. Ensure the QKView files are executable:

   chmod 755 qkview-wrapper-* qkview-collector.sh
   

6. Run the following command to see usage on Mac:

   ./qkview-wrapper-darwin -h 
   

7. Run the following command to see usage on Linux:

   ./qkview-wrapper-linux -h 
   

8. Run the qkview utility for your type of workstation: Linux or Darwin (Mac): to collect qkview for multiple namespaces.

   ./qkview-wrapper-darwin -f ./qkview-collector.sh -n <SPK namespace>,<watched 1>,<watched 2>
   

   In this example, the -n option targets the namespace to gather data from.

   ./qkview-wrapper-darwin -f ./qkview-collector.sh -n spk-ingress,spk-watchns1,spk-watchns2
   

9. The completed diagnostic file will appear in the directory as:

   iHealth_qkview-packaging.tar.gz
   

10. Continue to the next section.

Uploading to iHealth

Use these steps to upload the QKView diagnostic tarball to the iHealth website.

1. Log in to the iHealth website at https://ihealth.f5.com/qkview-analyzer/.
2. Click Upload toward the top left.
3. Click Choose and navigate to the iHealth_qkview-packaging.tar.gz file on your local workstation.
4. Click Open.
5. If you opened a support case, add the case number to the F5 Support Case (SR) field.
6. Click Upload QKView(s).
7. The uploaded qkview link will appear at the top of the list and can be used to view the collected data.

Feedback

Provide feedback to improve this document by emailing spkdocs@f5.com.

Supplemental

• Persistence Volumes