2014-04-16 14:07:55 -04:00
|
|
|
|
% DOCKER(1) Docker User Manuals
|
2014-06-30 22:58:04 -04:00
|
|
|
|
% Docker Community
|
|
|
|
|
% JUNE 2014
|
2014-04-16 14:07:55 -04:00
|
|
|
|
# NAME
|
|
|
|
|
docker-logs - Fetch the logs of a container
|
|
|
|
|
|
|
|
|
|
# SYNOPSIS
|
2014-06-30 22:58:04 -04:00
|
|
|
|
**docker logs**
|
|
|
|
|
[**-f**|**--follow**[=*false*]]
|
2014-10-15 17:14:12 -04:00
|
|
|
|
[**--help**]
|
2015-04-14 00:36:12 -04:00
|
|
|
|
[**--since**[=*SINCE*]]
|
2014-06-30 22:58:04 -04:00
|
|
|
|
[**-t**|**--timestamps**[=*false*]]
|
2014-07-22 22:40:10 -04:00
|
|
|
|
[**--tail**[=*"all"*]]
|
2014-06-30 22:58:04 -04:00
|
|
|
|
CONTAINER
|
2014-04-16 14:07:55 -04:00
|
|
|
|
|
|
|
|
|
# DESCRIPTION
|
|
|
|
|
The **docker logs** command batch-retrieves whatever logs are present for
|
2014-04-17 11:36:58 -04:00
|
|
|
|
a container at the time of execution. This does not guarantee execution
|
2015-01-06 23:23:32 -05:00
|
|
|
|
order when combined with a docker run (i.e., your run may not have generated
|
2014-04-17 11:36:58 -04:00
|
|
|
|
any logs at the time you execute docker logs).
|
2014-04-16 14:07:55 -04:00
|
|
|
|
|
|
|
|
|
The **docker logs --follow** command combines commands **docker logs** and
|
2014-04-21 16:28:25 -04:00
|
|
|
|
**docker attach**. It will first return all logs from the beginning and
|
2014-04-16 14:07:55 -04:00
|
|
|
|
then continue streaming new output from the container’s stdout and stderr.
|
|
|
|
|
|
2015-02-05 19:24:47 -05:00
|
|
|
|
**Warning**: This command works only for **json-file** logging driver.
|
|
|
|
|
|
2014-04-16 14:07:55 -04:00
|
|
|
|
# OPTIONS
|
2014-10-15 17:14:12 -04:00
|
|
|
|
**--help**
|
|
|
|
|
Print usage statement
|
|
|
|
|
|
2014-06-30 22:58:04 -04:00
|
|
|
|
**-f**, **--follow**=*true*|*false*
|
|
|
|
|
Follow log output. The default is *false*.
|
|
|
|
|
|
2015-04-14 00:36:12 -04:00
|
|
|
|
**--since**=""
|
|
|
|
|
Show logs since timestamp
|
|
|
|
|
|
2014-06-30 22:58:04 -04:00
|
|
|
|
**-t**, **--timestamps**=*true*|*false*
|
|
|
|
|
Show timestamps. The default is *false*.
|
2014-04-16 14:07:55 -04:00
|
|
|
|
|
2014-07-22 22:40:10 -04:00
|
|
|
|
**--tail**="all"
|
|
|
|
|
Output the specified number of lines at the end of logs (defaults to all logs)
|
|
|
|
|
|
2014-04-16 14:07:55 -04:00
|
|
|
|
# HISTORY
|
|
|
|
|
April 2014, Originally compiled by William Henry (whenry at redhat dot com)
|
2014-07-01 20:30:25 -04:00
|
|
|
|
based on docker.com source material and internal work.
|
2014-06-30 22:58:04 -04:00
|
|
|
|
June 2014, updated by Sven Dowideit <SvenDowideit@home.org.au>
|
2014-07-22 22:40:10 -04:00
|
|
|
|
July 2014, updated by Sven Dowideit <SvenDowideit@home.org.au>
|
2015-04-14 00:36:12 -04:00
|
|
|
|
April 2015, updated by Ahmet Alp Balkan <ahmetalpbalkan@gmail.com>
|