Analyzing a Swimlane Platform Installer (TPI) Support Bundle

a support bundle is a collection of logs and output from the underlying kubernetes cluster resources this information is invaluable for troubleshooting as it includes tons of information about node health, swimlane pod health and logs, kots pod health and logs, and more the support bundle is a gzip’d tarball ( tar gz) that can be extracted using the tar command tar zxvf supportbundle xxxx xx xxtyy yy yy tar gz the support bundle is comprised of logs divided into several directories cluster info information about the kubernetes version cluster resources definitions of all of the resources running in the clusters each resource type is a different subdirectory (deployments, services, statefulsets, etc ) each resource subdirectory has a json file for each namespace that has that resource type swimlane resources are in the default namespace kots logs specific to the kots ui and process pods goldpinger goldpinger checks the network connections between each unique pair of nodes results are stored as json in default/kotsadm ###/goldpinger statistics stdout txt when working correctly, each ping should return a 200 status code swimlane the custom support bundle collectors we have written for our swimlane platform resources each pod type has a separate subdirectory for the logs collected for each pod of that type what we collect api logs api pod logs pip list list of python packages installed in the api pods sw mongo cert expiration date of the mongodb certificate df disk usage for the partitions of the mongodb pods free memory usage of the mongodb pods logs mongodb pod logs mongo version the version of mongodb stats mongodb database stats time drift the current time of the mongodb pods to use to compare against the support bundle date and time to check for time drift top top running processes in the mongodb pods tasks logs tasks pod logs pip list list of python packages installed in the tasks pods tools environment validator output of the environment validator script being run from the tools pod logs tools pod logs ping a ping test done from the tools pod to see if there is internet access note this only confirms if the node that the tools pod is running on has internet access and not every node in the cluster web logs web pod logs velero logs for the velero resources that handle snapshots