1OC(1) June 2016 OC(1)
2
6 oc logs - Print the logs for a resource
7
11 oc logs [OPTIONS]
12
16 Print the logs for a resource
17 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 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
32 --all-containers=false
33 Get all containers's logs in the pod(s).
34 -c, --container=""
37 Print the logs of this container
38 -f, --follow=false
41 Specify if the logs should be streamed.
42 --limit-bytes=0
45 Maximum bytes of logs to return. Defaults to no limit.
46 --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 -p, --previous=false
54 If true, print the logs for the previous instance of the container
55 in a pod if it exists.
56 -l, --selector=""
59 Selector (label query) to filter on.
60 --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 --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 --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 --timestamps=false
78 Include timestamps on each line in the log output
79
83 --allow_verification_with_non_compliant_keys=false
84 Allow a SignatureVerifier to use keys which are technically
85 non-compliant with RFC6962.
86 --alsologtostderr=false
89 log to standard error as well as files
90 --application_metrics_count_limit=100
93 Max number of application metrics to store (per container)
94 --as=""
97 Username to impersonate for the operation
98 --as-group=[]
101 Group to impersonate for the operation, this flag can be repeated
102 to specify multiple groups.
103 --azure-container-registry-config=""
106 Path to the file containing Azure container registry configuration
107 information.
108 --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 --cache-dir="/builddir/.kube/http-cache"
116 Default HTTP cache directory
117 --certificate-authority=""
120 Path to a cert file for the certificate authority
121 --client-certificate=""
124 Path to a client certificate file for TLS
125 --client-key=""
128 Path to a client key file for TLS
129 --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 --cluster=""
136 The name of the kubeconfig cluster to use
137 --container_hints="/etc/cadvisor/container_hints.json"
140 location of the container hints file
141 --containerd="unix:///var/run/containerd.sock"
144 containerd endpoint
145 --context=""
148 The name of the kubeconfig context to use
149 --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 --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 --docker="unix:///var/run/docker.sock"
164 docker endpoint
165 --docker-tls=false
168 use TLS to connect to docker
169 --docker-tls-ca="ca.pem"
172 path to trusted CA
173 --docker-tls-cert="cert.pem"
176 path to client certificate
177 --docker-tls-key="key.pem"
180 path to private key
181 --docker_env_metadata_whitelist=""
184 a comma-separated list of environment variable keys that needs to
185 be collected for docker containers
186 --docker_only=false
189 Only report docker containers in addition to root stats
190 --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 --enable_load_reader=false
198 Whether to enable cpu load reader
199 --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 --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 --global_housekeeping_interval=0
216 Interval between global housekeepings
217 --housekeeping_interval=0
220 Interval between container housekeepings
221 --httptest.serve=""
224 if non-empty, httptest.NewServer serves on this address and blocks
225 --insecure-skip-tls-verify=false
228 If true, the server's certificate will not be checked for validity.
229 This will make your HTTPS connections insecure
230 --kubeconfig=""
233 Path to the kubeconfig file to use for CLI requests.
234 --log-flush-frequency=0
237 Maximum number of seconds between log flushes
238 --log_backtrace_at=:0
241 when logging hits line file:N, emit a stack trace
242 --log_cadvisor_usage=false
245 Whether to log the usage of the cAdvisor container
246 --log_dir=""
249 If non-empty, write log files in this directory
250 --logtostderr=true
253 log to standard error instead of files
254 --machine_id_file="/etc/machine-id,/var/lib/dbus/machine-id"
257 Comma-separated list of files to check for machine-id. Use the
258 first one that exists.
259 --match-server-version=false
262 Require server version to match client version
263 -n, --namespace=""
266 If present, the namespace scope for this CLI request
267 --request-timeout="0"
270 The length of time to wait before giving up on a single server
271 request. Non-zero values should contain a corresponding time unit (e.g.
272 1s, 2m, 3h). A value of zero means don't timeout requests.
273 -s, --server=""
276 The address and port of the Kubernetes API server
277 --stderrthreshold=2
280 logs at or above this threshold go to stderr
281 --storage_driver_buffer_duration=0
284 Writes in the storage driver will be buffered for this duration,
285 and committed to the non memory backends as a single transaction
286 --storage_driver_db="cadvisor"
289 database name
290 --storage_driver_host="localhost:8086"
293 database host:port
294 --storage_driver_password="root"
297 database password
298 --storage_driver_secure=false
301 use secure connection with database
302 --storage_driver_table="stats"
305 table name
306 --storage_driver_user="root"
309 database username
310 --token=""
313 Bearer token for authentication to the API server
314 --user=""
317 The name of the kubeconfig user to use
318 -v, --v=0
321 log level for V logs
322 --version=false
325 Print version information and quit
326 --vmodule=
329 comma-separated list of pattern=N settings for file-filtered log‐
330 ging
331
335 # Start streaming the logs of the most recent build of the openldap build config.
336 oc logs -f bc/openldap
337 # Start streaming the logs of the latest deployment of the mysql deployment config.
339 oc logs -f dc/mysql
340 # Get the logs of the first deployment for the mysql deployment config. Note that logs
342 # from older deployments may not exist either because the deployment was successful
343 # or due to deployment pruning or manual deletion of the deployment.
344 oc logs --version=1 dc/mysql
345 # Return a snapshot of ruby-container logs from pod backend.
347 oc logs backend -c ruby-container
348 # Start streaming of ruby-container logs from pod backend.
350 oc logs -f pod/backend -c ruby-container
351
356 oc(1),
357
361 June 2016, Ported from the Kubernetes man-doc generator
362Openshift Openshift CLI User Manuals OC(1)