1KUBERNETES(1)(kubernetes) KUBERNETES(1)(kubernetes)
2Eric Paris Jan 2015
6
9 kubectl events - List events
10
14 kubectl events [OPTIONS]
15
19 Display events
20 Prints a table of the most important information about events. You can
23 request events for a namespace, for all namespace, or filtered to only
24 those pertaining to a specified resource.
25
29 -A, --all-namespaces=false If present, list the requested ob‐
30 ject(s) across all namespaces. Namespace in current context is ignored
31 even if specified with --namespace.
32 --allow-missing-template-keys=true If true, ignore any errors in
35 templates when a field or map key is missing in the template. Only ap‐
36 plies to golang and jsonpath output formats.
37 --chunk-size=500 Return large lists in chunks rather than all at
40 once. Pass 0 to disable. This flag is beta and may change in the fu‐
41 ture.
42 --for="" Filter events to only those pertaining to the specified
45 resource.
46 --no-headers=false When using the default output format, don't
49 print headers.
50 -o, --output="" Output format. One of: (json, yaml, name, go-tem‐
53 plate, go-template-file, template, templatefile, jsonpath, jsonpath-as-
54 json, jsonpath-file).
55 --show-managed-fields=false If true, keep the managedFields when
58 printing objects in JSON or YAML format.
59 --template="" Template string or path to template file to use when
62 -o=go-template, -o=go-template-file. The template format is golang tem‐
63 plates [http://golang.org/pkg/text/template/#pkg-overview].
64 --types=[] Output only events of given types.
67 -w, --watch=false After listing the requested events, watch for
70 more events.
71
75 --as="" Username to impersonate for the operation. User could be a
76 regular user or a service account in a namespace.
77 --as-group=[] Group to impersonate for the operation, this flag
80 can be repeated to specify multiple groups.
81 --as-uid="" UID to impersonate for the operation.
84 --azure-container-registry-config="" Path to the file containing
87 Azure container registry configuration information.
88 --cache-dir="/builddir/.kube/cache" Default cache directory
91 --certificate-authority="" Path to a cert file for the certificate
94 authority
95 --client-certificate="" Path to a client certificate file for TLS
98 --client-key="" Path to a client key file for TLS
101 --cluster="" The name of the kubeconfig cluster to use
104 --context="" The name of the kubeconfig context to use
107 --disable-compression=false If true, opt-out of response compres‐
110 sion for all requests to the server
111 --insecure-skip-tls-verify=false If true, the server's certificate
114 will not be checked for validity. This will make your HTTPS connections
115 insecure
116 --kubeconfig="" Path to the kubeconfig file to use for CLI re‐
119 quests.
120 --match-server-version=false Require server version to match
123 client version
124 -n, --namespace="" If present, the namespace scope for this CLI
127 request
128 --password="" Password for basic authentication to the API server
131 --profile="none" Name of profile to capture. One of
134 (none|cpu|heap|goroutine|threadcreate|block|mutex)
135 --profile-output="profile.pprof" Name of the file to write the
138 profile to
139 --request-timeout="0" The length of time to wait before giving up
142 on a single server request. Non-zero values should contain a corre‐
143 sponding time unit (e.g. 1s, 2m, 3h). A value of zero means don't time‐
144 out requests.
145 -s, --server="" The address and port of the Kubernetes API server
148 --tls-server-name="" Server name to use for server certificate
151 validation. If it is not provided, the hostname used to contact the
152 server is used
153 --token="" Bearer token for authentication to the API server
156 --user="" The name of the kubeconfig user to use
159 --username="" Username for basic authentication to the API server
162 --version=false Print version information and quit
165 --warnings-as-errors=false Treat warnings received from the server
168 as errors and exit with a non-zero exit code
169
173 # List recent events in the default namespace.
174 kubectl events
175 # List recent events in all namespaces.
177 kubectl events --all-namespaces
178 # List recent events for the specified pod, then wait for more events and list them as they arrive.
180 kubectl events --for pod/web-pod-13je7 --watch
181 # List recent events in given format. Supported ones, apart from default, are json and yaml.
183 kubectl events -oyaml
184 # List recent only events in given event types
186 kubectl events --types=Warning,Normal
187
192 kubectl(1),
193
197 January 2015, Originally compiled by Eric Paris (eparis at redhat dot
198 com) based on the kubernetes source material, but hopefully they have
199 been automatically generated since!
200Manuals User KUBERNETES(1)(kubernetes)