kubectl-alpha-events(1)

1KUBERNETES(1)(kubernetes)                            KUBERNETES(1)(kubernetes)
2
3
4
5Eric Paris Jan 2015
6
7

NAME

9       kubectl alpha events - Experimental: List events
10
11
12

SYNOPSIS

14       kubectl alpha events [OPTIONS]
15
16
17

DESCRIPTION

19       Experimental: Display events
20
21
22       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
26
27

OPTIONS

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
33
34       --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
38
39       --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
43
44       --for=""       Filter  events to only those pertaining to the specified
45       resource.
46
47
48       --no-headers=false      When using the  default  output  format,  don't
49       print headers.
50
51
52       -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
56
57       --show-managed-fields=false       If  true, keep the managedFields when
58       printing objects in JSON or YAML format.
59
60
61       --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
65
66       --types=[]      Output only events of given types.
67
68
69       -w, --watch=false      After listing the requested  events,  watch  for
70       more events.
71
72
73

OPTIONS INHERITED FROM PARENT COMMANDS

75       --as=""      Username to impersonate for the operation. User could be a
76       regular user or a service account in a namespace.
77
78
79       --as-group=[]      Group to impersonate for the  operation,  this  flag
80       can be repeated to specify multiple groups.
81
82
83       --as-uid=""      UID to impersonate for the operation.
84
85
86       --azure-container-registry-config=""       Path  to the file containing
87       Azure container registry configuration information.
88
89
90       --cache-dir="/builddir/.kube/cache"      Default cache directory
91
92
93       --certificate-authority=""      Path to a cert file for the certificate
94       authority
95
96
97       --client-certificate=""      Path to a client certificate file for TLS
98
99
100       --client-key=""      Path to a client key file for TLS
101
102
103       --cluster=""      The name of the kubeconfig cluster to use
104
105
106       --context=""      The name of the kubeconfig context to use
107
108
109       --insecure-skip-tls-verify=false      If true, the server's certificate
110       will not be checked for validity. This will make your HTTPS connections
111       insecure
112
113
114       --kubeconfig=""       Path  to  the  kubeconfig file to use for CLI re‐
115       quests.
116
117
118       --match-server-version=false       Require  server  version  to   match
119       client version
120
121
122       -n,  --namespace=""       If  present, the namespace scope for this CLI
123       request
124
125
126       --password=""      Password for basic authentication to the API server
127
128
129       --profile="none"        Name   of   profile   to   capture.   One    of
130       (none|cpu|heap|goroutine|threadcreate|block|mutex)
131
132
133       --profile-output="profile.pprof"       Name  of  the  file to write the
134       profile to
135
136
137       --request-timeout="0"      The length of time to wait before giving  up
138       on  a  single  server  request. Non-zero values should contain a corre‐
139       sponding time unit (e.g. 1s, 2m, 3h). A value of zero means don't time‐
140       out requests.
141
142
143       -s, --server=""      The address and port of the Kubernetes API server
144
145
146       --tls-server-name=""       Server  name  to  use for server certificate
147       validation. If it is not provided, the hostname  used  to  contact  the
148       server is used
149
150
151       --token=""      Bearer token for authentication to the API server
152
153
154       --user=""      The name of the kubeconfig user to use
155
156
157       --username=""      Username for basic authentication to the API server
158
159
160       --version=false      Print version information and quit
161
162
163       --warnings-as-errors=false      Treat warnings received from the server
164       as errors and exit with a non-zero exit code
165
166
167

EXAMPLE

169                # List recent events in the default namespace.
170                kubectl alpha events
171
172                # List recent events in all namespaces.
173                kubectl alpha events --all-namespaces
174
175                # List recent events for the specified pod, then wait for more events and list them as they arrive.
176                kubectl alpha events --for pod/web-pod-13je7 --watch
177
178                # List recent events in given format. Supported ones, apart from default, are json and yaml.
179                kubectl alpha events -oyaml
180
181                # List recent only events in given event types
182                kubectl alpha events --types=Warning,Normal
183
184
185
186

HISTORY

193       January 2015, Originally compiled by Eric Paris (eparis at  redhat  dot
194       com)  based  on the kubernetes source material, but hopefully they have
195       been automatically generated since!
196
197
198
199Manuals                              User            KUBERNETES(1)(kubernetes)