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 --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 --kubeconfig=""
229 Path to the kubeconfig file to use for CLI requests.
230 --log-flush-frequency=0
233 Maximum number of seconds between log flushes
234 --log_backtrace_at=:0
237 when logging hits line file:N, emit a stack trace
238 --log_cadvisor_usage=false
241 Whether to log the usage of the cAdvisor container
242 --log_dir=""
245 If non-empty, write log files in this directory
246 --logtostderr=true
249 log to standard error instead of files
250 --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 --match-server-version=false
258 Require server version to match client version
259 -n, --namespace=""
262 If present, the namespace scope for this CLI request
263 --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 -s, --server=""
272 The address and port of the Kubernetes API server
273 --stderrthreshold=2
276 logs at or above this threshold go to stderr
277 --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 --storage_driver_db="cadvisor"
285 database name
286 --storage_driver_host="localhost:8086"
289 database host:port
290 --storage_driver_password="root"
293 database password
294 --storage_driver_secure=false
297 use secure connection with database
298 --storage_driver_table="stats"
301 table name
302 --storage_driver_user="root"
305 database username
306 --token=""
309 Bearer token for authentication to the API server
310 --user=""
313 The name of the kubeconfig user to use
314 -v, --v=0
317 log level for V logs
318 --version=false
321 Print version information and quit
322 --vmodule=
325 comma-separated list of pattern=N settings for file-filtered log‐
326 ging
327
331 # Start streaming the logs of the most recent build of the openldap build config.
332 oc logs -f bc/openldap
333 # Start streaming the logs of the latest deployment of the mysql deployment config.
335 oc logs -f dc/mysql
336 # 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 # Return a snapshot of ruby-container logs from pod backend.
343 oc logs backend -c ruby-container
344 # Start streaming of ruby-container logs from pod backend.
346 oc logs -f pod/backend -c ruby-container
347
352 oc(1),
353
357 June 2016, Ported from the Kubernetes man-doc generator
358Openshift Openshift CLI User Manuals OC(1)