Diagnostics
Okteto provides a diagnostics tool through the Replicated Troubleshoot framework. This tool is completely optional but can help troubleshoot complex issues, specially if you are getting assistance through Okteto Support.
Starting in Okteto 1.16, as part of the helm installation we deploy a okteto-support-bundle
configmaps in the okteto namespace that contain the specs to create a support bundle.
Installation
The support-bundle provided by Replicated Troubleshoot is a client-side utility, packaged as a kubectl plugin and distributed through the krew package manager. Make sure to have it installed as per the installation guide
Run kubectl krew
to check the installation and make sure krew
is in your $PATH as described in the installation guide
Once krew is installed, you can install the kubectl
plugin:
kubectl krew install support-bundle
More info about the installation here.
Support bundle
Creates a gzipped tarball which includes cluster information, logs for okteto components, and other relevant information. This bundle can help troubleshoot issues with the cluster specially during an incident in which you are getting assistance from Okteto Support.
kubectl support-bundle \
--interactive=false \
--debug \
-n okteto \
--load-cluster-specs
The default file name for the bundle is support-bundle-TIMESTAMP.tar.gz
but it can be overridden with -o <filename>
. More info about the support bundle command, extra arguments, etc can be found here: https://troubleshoot.sh/docs/support-bundle/introduction/