Run eck-diagnostics
editRun eck-diagnostics
editeck-diagnostics
is a stand-alone command line tool to create a diagnostic archive to help troubleshoot issues with ECK.
Prepare
editThe tool is available at https://github.com/elastic/eck-diagnostics/. You can find detailed installation instructions there.
Run
editThe eck-diagnostics tool supports various command line flags. Run it with -h
or --help
to print all available options. The only required flag is -r
or --resources-namespace
which indicates the namespaces where your Elastic stack resources are deployed.
There is also -o
or --operator-namespaces
that indicate where the ECK operator is deployed. If you don’t specify this flag the tool assumes the operator to be deployed in the elastic-system
namespace.
eck-diagnostics -o <operator-namespaces> -r <resources-namespaces>
By default, the tool automatically runs support diagnostics for every Elasticsearch cluster and Kibana instance. This requires the temporary deployment of additional Pods into the Kubernetes cluster. If this is not what you want, you can turn off the feature by specifying the --run-stack-diagnostics=false
flag.
Example
editAssuming the ECK operator is deployed in a namespace called operators
and Elastic stack resources are deployed in the security
and monitoring
namespaces, you should run eck-diagnostics
as follows:
eck-diagnostics -o=operators -r=security,monitoring
Sample output:
2021/10/06 20:34:20 ECK diagnostics with parameters: {DiagnosticImage:docker.elastic.co/eck-dev/support-diagnostics:8.1.4 ECKVersion: Kubeconfig: OperatorNamespaces:[operators] ResourcesNamespaces:[security monitoring] OutputDir:/tmp RunStackDiagnostics:true Verbose:false} 2021/10/06 20:34:22 Extracting Kubernetes diagnostics from operators 2021/10/06 20:34:23 ECK version is 1.8.0 2021/10/06 20:34:23 Extracting Kubernetes diagnostics from security 2021/10/06 20:34:23 Extracting Kubernetes diagnostics from monitoring 2021/10/06 20:34:24 ECK diagnostics written to /tmp/eck-diagnostic-2021-10-06T20-34-21.zip