QKView and iHealth¶
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 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:
Use the procedures below to generate the qkview diagnostic tarball, and upload it to the iHealth website.
Use these steps to generate the QKView diagnostic tarball.
Verify the integrity of the downloaded file:
Note: The output from the cat and the md5sum commands should match.
Extract the qkview-packaging.tar.gz file:
tar xvf qkview-packaging.tar.gz
List the qkview files:
The following files should be available.
qkview-collector.sh qkview-packaging.tar.gz qkview-packaging.tar.gz.md5 qkview-wrapper-darwin qkview-wrapper-linux
Ensure the QKView files are executable:
chmod 755 qkview-wrapper-* qkview-collector.sh
Run the following command to see usage on Mac:
Run the following command to see usage on Linux:
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
The completed diagnostic file will appear in the directory as:
Continue to the next section.
Uploading to iHealth¶
Use these steps to upload the QKView diagnostic tarball to the iHealth website.
- Log in to the iHealth website at https://ihealth.f5.com/qkview-analyzer/.
- Click Upload toward the top left.
- Click Choose and navigate to the iHealth_qkview-packaging.tar.gz file on your local workstation.
- Click Open.
- If you opened a support case, add the case number to the F5 Support Case (SR) field.
- Click Upload QKView(s).
- The uploaded qkview link will appear at the top of the list and can be used to view the collected data.