1KUBERNETES(1)(kubernetes) KUBERNETES(1)(kubernetes)
2Eric Paris Jan 2015
6
9 kubectl cluster-info dump - Dump relevant information for debugging and
10 diagnosis
11
15 kubectl cluster-info dump [OPTIONS]
16
20 Dump cluster information out suitable for debugging and diagnosing
21 cluster problems. By default, dumps everything to stdout. You can op‐
22 tionally specify a directory with --output-directory. If you specify a
23 directory, Kubernetes will build a set of files in that directory. By
24 default, only dumps things in the current namespace and 'kube-system'
25 namespace, but you can switch to a different namespace with the --name‐
26 spaces flag, or specify --all-namespaces to dump all namespaces.
27 The command also dumps the logs of all of the pods in the cluster;
30 these logs are dumped into different directories based on namespace and
31 pod name.
32
36 -A, --all-namespaces=false If true, dump all namespaces. If true,
37 --namespaces is ignored.
38 --allow-missing-template-keys=true If true, ignore any errors in
41 templates when a field or map key is missing in the template. Only ap‐
42 plies to golang and jsonpath output formats.
43 --namespaces=[] A comma separated list of namespaces to dump.
46 -o, --output="json" Output format. One of: (json, yaml, name, go-
49 template, go-template-file, template, templatefile, jsonpath, jsonpath-
50 as-json, jsonpath-file).
51 --output-directory="" Where to output the files. If empty or '-'
54 uses stdout, otherwise creates a directory hierarchy in that directory
55 --pod-running-timeout=20s The length of time (like 5s, 2m, or 3h,
58 higher than zero) to wait until at least one pod is running
59 --show-managed-fields=false If true, keep the managedFields when
62 printing objects in JSON or YAML format.
63 --template="" Template string or path to template file to use when
66 -o=go-template, -o=go-template-file. The template format is golang tem‐
67 plates [http://golang.org/pkg/text/template/#pkg-overview].
68
72 --as="" Username to impersonate for the operation. User could be a
73 regular user or a service account in a namespace.
74 --as-group=[] Group to impersonate for the operation, this flag
77 can be repeated to specify multiple groups.
78 --as-uid="" UID to impersonate for the operation.
81 --azure-container-registry-config="" Path to the file containing
84 Azure container registry configuration information.
85 --cache-dir="/builddir/.kube/cache" Default cache directory
88 --certificate-authority="" Path to a cert file for the certificate
91 authority
92 --client-certificate="" Path to a client certificate file for TLS
95 --client-key="" Path to a client key file for TLS
98 --cluster="" The name of the kubeconfig cluster to use
101 --context="" The name of the kubeconfig context to use
104 --insecure-skip-tls-verify=false If true, the server's certificate
107 will not be checked for validity. This will make your HTTPS connections
108 insecure
109 --kubeconfig="" Path to the kubeconfig file to use for CLI re‐
112 quests.
113 --match-server-version=false Require server version to match
116 client version
117 -n, --namespace="" If present, the namespace scope for this CLI
120 request
121 --password="" Password for basic authentication to the API server
124 --profile="none" Name of profile to capture. One of
127 (none|cpu|heap|goroutine|threadcreate|block|mutex)
128 --profile-output="profile.pprof" Name of the file to write the
131 profile to
132 --request-timeout="0" The length of time to wait before giving up
135 on a single server request. Non-zero values should contain a corre‐
136 sponding time unit (e.g. 1s, 2m, 3h). A value of zero means don't time‐
137 out requests.
138 -s, --server="" The address and port of the Kubernetes API server
141 --tls-server-name="" Server name to use for server certificate
144 validation. If it is not provided, the hostname used to contact the
145 server is used
146 --token="" Bearer token for authentication to the API server
149 --user="" The name of the kubeconfig user to use
152 --username="" Username for basic authentication to the API server
155 --version=false Print version information and quit
158 --warnings-as-errors=false Treat warnings received from the server
161 as errors and exit with a non-zero exit code
162
166 # Dump current cluster state to stdout
167 kubectl cluster-info dump
168 # Dump current cluster state to /path/to/cluster-state
170 kubectl cluster-info dump --output-directory=/path/to/cluster-state
171 # Dump all namespaces to stdout
173 kubectl cluster-info dump --all-namespaces
174 # Dump a set of namespaces to /path/to/cluster-state
176 kubectl cluster-info dump --namespaces default,kube-system --output-directory=/path/to/cluster-state
177
182 kubectl-cluster-info(1),
183
187 January 2015, Originally compiled by Eric Paris (eparis at redhat dot
188 com) based on the kubernetes source material, but hopefully they have
189 been automatically generated since!
190Manuals User KUBERNETES(1)(kubernetes)