1OC(1) June 2016 OC(1)
2
3
4
6 oc logs - Print the logs for a resource
7
8
9
11 oc logs [OPTIONS]
12
13
14
16 Print the logs for a resource
17
18
19 Supported resources are builds, build configs (bc), deployment configs
20 (dc), and pods. When a pod is specified and has more than one con‐
21 tainer, the container name should be specified via -c. When a build
22 config or deployment config is specified, you can view the logs for a
23 particular version of it via --version.
24
25
26 If your pod is failing to start, you may need to use the --previous
27 option to see the logs of the last attempt.
28
29
30
32 --all-containers=false
33 Get all containers's logs in the pod(s).
34
35
36 -c, --container=""
37 Print the logs of this container
38
39
40 -f, --follow=false
41 Specify if the logs should be streamed.
42
43
44 --limit-bytes=0
45 Maximum bytes of logs to return. Defaults to no limit.
46
47
48 --pod-running-timeout=0
49 The length of time (like 5s, 2m, or 3h, higher than zero) to wait
50 until at least one pod is running
51
52
53 -p, --previous=false
54 If true, print the logs for the previous instance of the container
55 in a pod if it exists.
56
57
58 -l, --selector=""
59 Selector (label query) to filter on.
60
61
62 --since=0
63 Only return logs newer than a relative duration like 5s, 2m, or 3h.
64 Defaults to all logs. Only one of since-time / since may be used.
65
66
67 --since-time=""
68 Only return logs after a specific date (RFC3339). Defaults to all
69 logs. Only one of since-time / since may be used.
70
71
72 --tail=-1
73 Lines of recent log file to display. Defaults to -1 with no selec‐
74 tor, showing all log lines otherwise 10, if a selector is provided.
75
76
77 --timestamps=false
78 Include timestamps on each line in the log output
79
80
81
83 --allow_verification_with_non_compliant_keys=false
84 Allow a SignatureVerifier to use keys which are technically
85 non-compliant with RFC6962.
86
87
88 --alsologtostderr=false
89 log to standard error as well as files
90
91
92 --application_metrics_count_limit=100
93 Max number of application metrics to store (per container)
94
95
96 --as=""
97 Username to impersonate for the operation
98
99
100 --as-group=[]
101 Group to impersonate for the operation, this flag can be repeated
102 to specify multiple groups.
103
104
105 --azure-container-registry-config=""
106 Path to the file containing Azure container registry configuration
107 information.
108
109
110 --boot_id_file="/proc/sys/kernel/random/boot_id"
111 Comma-separated list of files to check for boot-id. Use the first
112 one that exists.
113
114
115 --cache-dir="/builddir/.kube/http-cache"
116 Default HTTP cache directory
117
118
119 --certificate-authority=""
120 Path to a cert file for the certificate authority
121
122
123 --client-certificate=""
124 Path to a client certificate file for TLS
125
126
127 --client-key=""
128 Path to a client key file for TLS
129
130
131 --cloud-provider-gce-lb-src-cidrs=130.211.0.0/22,209.85.152.0/22,209.85.204.0/22,35.191.0.0/16
132 CIDRs opened in GCE firewall for LB traffic proxy health checks
133
134
135 --cluster=""
136 The name of the kubeconfig cluster to use
137
138
139 --container_hints="/etc/cadvisor/container_hints.json"
140 location of the container hints file
141
142
143 --containerd="unix:///var/run/containerd.sock"
144 containerd endpoint
145
146
147 --context=""
148 The name of the kubeconfig context to use
149
150
151 --default-not-ready-toleration-seconds=300
152 Indicates the tolerationSeconds of the toleration for
153 notReady:NoExecute that is added by default to every pod that does not
154 already have such a toleration.
155
156
157 --default-unreachable-toleration-seconds=300
158 Indicates the tolerationSeconds of the toleration for unreach‐
159 able:NoExecute that is added by default to every pod that does not
160 already have such a toleration.
161
162
163 --docker="unix:///var/run/docker.sock"
164 docker endpoint
165
166
167 --docker-tls=false
168 use TLS to connect to docker
169
170
171 --docker-tls-ca="ca.pem"
172 path to trusted CA
173
174
175 --docker-tls-cert="cert.pem"
176 path to client certificate
177
178
179 --docker-tls-key="key.pem"
180 path to private key
181
182
183 --docker_env_metadata_whitelist=""
184 a comma-separated list of environment variable keys that needs to
185 be collected for docker containers
186
187
188 --docker_only=false
189 Only report docker containers in addition to root stats
190
191
192 --docker_root="/var/lib/docker"
193 DEPRECATED: docker root is read from docker info (this is a fall‐
194 back, default: /var/lib/docker)
195
196
197 --enable_load_reader=false
198 Whether to enable cpu load reader
199
200
201 --event_storage_age_limit="default=24h"
202 Max length of time for which to store events (per type). Value is a
203 comma separated list of key values, where the keys are event types
204 (e.g.: creation, oom) or "default" and the value is a duration. Default
205 is applied to all non-specified event types
206
207
208 --event_storage_event_limit="default=100000"
209 Max number of events to store (per type). Value is a comma sepa‐
210 rated list of key values, where the keys are event types (e.g.: cre‐
211 ation, oom) or "default" and the value is an integer. Default is
212 applied to all non-specified event types
213
214
215 --global_housekeeping_interval=0
216 Interval between global housekeepings
217
218
219 --housekeeping_interval=0
220 Interval between container housekeepings
221
222
223 --insecure-skip-tls-verify=false
224 If true, the server's certificate will not be checked for validity.
225 This will make your HTTPS connections insecure
226
227
228 --kubeconfig=""
229 Path to the kubeconfig file to use for CLI requests.
230
231
232 --log-flush-frequency=0
233 Maximum number of seconds between log flushes
234
235
236 --log_backtrace_at=:0
237 when logging hits line file:N, emit a stack trace
238
239
240 --log_cadvisor_usage=false
241 Whether to log the usage of the cAdvisor container
242
243
244 --log_dir=""
245 If non-empty, write log files in this directory
246
247
248 --logtostderr=true
249 log to standard error instead of files
250
251
252 --machine_id_file="/etc/machine-id,/var/lib/dbus/machine-id"
253 Comma-separated list of files to check for machine-id. Use the
254 first one that exists.
255
256
257 --match-server-version=false
258 Require server version to match client version
259
260
261 -n, --namespace=""
262 If present, the namespace scope for this CLI request
263
264
265 --request-timeout="0"
266 The length of time to wait before giving up on a single server
267 request. Non-zero values should contain a corresponding time unit (e.g.
268 1s, 2m, 3h). A value of zero means don't timeout requests.
269
270
271 -s, --server=""
272 The address and port of the Kubernetes API server
273
274
275 --stderrthreshold=2
276 logs at or above this threshold go to stderr
277
278
279 --storage_driver_buffer_duration=0
280 Writes in the storage driver will be buffered for this duration,
281 and committed to the non memory backends as a single transaction
282
283
284 --storage_driver_db="cadvisor"
285 database name
286
287
288 --storage_driver_host="localhost:8086"
289 database host:port
290
291
292 --storage_driver_password="root"
293 database password
294
295
296 --storage_driver_secure=false
297 use secure connection with database
298
299
300 --storage_driver_table="stats"
301 table name
302
303
304 --storage_driver_user="root"
305 database username
306
307
308 --token=""
309 Bearer token for authentication to the API server
310
311
312 --user=""
313 The name of the kubeconfig user to use
314
315
316 -v, --v=0
317 log level for V logs
318
319
320 --version=false
321 Print version information and quit
322
323
324 --vmodule=
325 comma-separated list of pattern=N settings for file-filtered log‐
326 ging
327
328
329
331 # Start streaming the logs of the most recent build of the openldap build config.
332 oc logs -f bc/openldap
333
334 # Start streaming the logs of the latest deployment of the mysql deployment config.
335 oc logs -f dc/mysql
336
337 # Get the logs of the first deployment for the mysql deployment config. Note that logs
338 # from older deployments may not exist either because the deployment was successful
339 # or due to deployment pruning or manual deletion of the deployment.
340 oc logs --version=1 dc/mysql
341
342 # Return a snapshot of ruby-container logs from pod backend.
343 oc logs backend -c ruby-container
344
345 # Start streaming of ruby-container logs from pod backend.
346 oc logs -f pod/backend -c ruby-container
347
348
349
350
352 oc(1),
353
354
355
357 June 2016, Ported from the Kubernetes man-doc generator
358
359
360
361Openshift Openshift CLI User Manuals OC(1)