Troubleshooting
In case of malfunction of AHD or one of the applications distributed through it, support from Smeup LAB may be necessary.
To collect information about the state of AHD and send it securely and streamlined to Smeup LAB, you can use the open-source tool Troubleshoot.
With Troubleshoot, it is possible to create a Support-Bundle containing:
- application logs
- networking information
- system information (memory, CPU, disk, OS, ...)
Creating a Support-Bundle
After connecting via SSH to AHD VM, run the following command:
kubectl support-bundle https://smartkit-vm.smeup.cloud/support-bundle/data.yaml
After a few seconds, you will see the result of a series of health tests on AHD, highlighting:
- ✅ the tests ran successfully
- ⚠️ the tests ran successfully, but with warnings
- ❗ the tests failed
Press s to save the test results in a file named:
support-bundle-<year>-<month>-<day>T<hour>_<minutes>_<seconds>.tar.gz
Then, press q to close the interactive screen.
Uploading the Support-Bundle
To proceed with uploading the Support-Bundle directly from AHD VM, you must ask Smeup LAB for a temporary URL to use for the upload.
You can also manually download the Support-Bundle through scp and save it on your PC.
Run the following command from AHD VM, replacing:
<support-bundle-filename>with the name of the Support-Bundle file generated in the previous step<smeup-lab-url>with the URL provided by Smeup LAB
curl -X PUT -T <support-bundle-filename> <smeup-lab-url>
The Support-Bundle has been successfully uploaded and can be analyzed by Smeup LAB.