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 --disable-compression=false If true, opt-out of response compres‐
107 sion for all requests to the server
108 --insecure-skip-tls-verify=false If true, the server's certificate
111 will not be checked for validity. This will make your HTTPS connections
112 insecure
113 --kubeconfig="" Path to the kubeconfig file to use for CLI re‐
116 quests.
117 --match-server-version=false Require server version to match
120 client version
121 -n, --namespace="" If present, the namespace scope for this CLI
124 request
125 --password="" Password for basic authentication to the API server
128 --profile="none" Name of profile to capture. One of
131 (none|cpu|heap|goroutine|threadcreate|block|mutex)
132 --profile-output="profile.pprof" Name of the file to write the
135 profile to
136 --request-timeout="0" The length of time to wait before giving up
139 on a single server request. Non-zero values should contain a corre‐
140 sponding time unit (e.g. 1s, 2m, 3h). A value of zero means don't time‐
141 out requests.
142 -s, --server="" The address and port of the Kubernetes API server
145 --tls-server-name="" Server name to use for server certificate
148 validation. If it is not provided, the hostname used to contact the
149 server is used
150 --token="" Bearer token for authentication to the API server
153 --user="" The name of the kubeconfig user to use
156 --username="" Username for basic authentication to the API server
159 --version=false Print version information and quit
162 --warnings-as-errors=false Treat warnings received from the server
165 as errors and exit with a non-zero exit code
166
170 # Dump current cluster state to stdout
171 kubectl cluster-info dump
172 # Dump current cluster state to /path/to/cluster-state
174 kubectl cluster-info dump --output-directory=/path/to/cluster-state
175 # Dump all namespaces to stdout
177 kubectl cluster-info dump --all-namespaces
178 # Dump a set of namespaces to /path/to/cluster-state
180 kubectl cluster-info dump --namespaces default,kube-system --output-directory=/path/to/cluster-state
181
186 kubectl-cluster-info(1),
187
191 January 2015, Originally compiled by Eric Paris (eparis at redhat dot
192 com) based on the kubernetes source material, but hopefully they have
193 been automatically generated since!
194Manuals User KUBERNETES(1)(kubernetes)