docs: dockerd: add documentation for --log-format option

Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
(cherry picked from commit baceb4b158)
Signed-off-by: Austin Vazquez <macedonv@amazon.com>
This commit is contained in:
Sebastiaan van Stijn 2024-09-16 13:16:13 +02:00 committed by Austin Vazquez
parent 11634426e8
commit a0f4097740
No known key found for this signature in database
GPG Key ID: 5F5F4008442CADB8
1 changed files with 30 additions and 0 deletions

View File

@ -79,6 +79,7 @@ Options:
--label list Set key=value labels to the daemon --label list Set key=value labels to the daemon
--live-restore Enable live restore of docker when containers are still running --live-restore Enable live restore of docker when containers are still running
--log-driver string Default driver for container logs (default "json-file") --log-driver string Default driver for container logs (default "json-file")
--log-format string Set the logging format ("text"|"json") (default "text")
-l, --log-level string Set the logging level ("debug"|"info"|"warn"|"error"|"fatal") (default "info") -l, --log-level string Set the logging level ("debug"|"info"|"warn"|"error"|"fatal") (default "info")
--log-opt map Default log driver options for containers (default map[]) --log-opt map Default log driver options for containers (default map[])
--max-concurrent-downloads int Set the max concurrent downloads (default 3) --max-concurrent-downloads int Set the max concurrent downloads (default 3)
@ -895,6 +896,33 @@ Alternatively, you can set custom locations for CDI specifications using the
When CDI is enabled for a daemon, you can view the configured CDI specification When CDI is enabled for a daemon, you can view the configured CDI specification
directories using the `docker info` command. directories using the `docker info` command.
#### <a name="log-format"></a> Daemon logging format
The `--log-format` option or "log-format" option in the [daemon configuration file](#daemon-configuration-file)
lets you set the format for logs produced by the daemon. The logging format should
only be configured either through the `--log-format` command line option or
through the "log-format" field in the configuration file; using both
the command-line option and the "log-format" field in the configuration
file produces an error. If this option is not set, the default is "text".
The following example configures the daemon through the `--log-format` command
line option to use `json` formatted logs;
```console
$ dockerd --log-format=json
# ...
{"level":"info","msg":"API listen on /var/run/docker.sock","time":"2024-09-16T11:06:08.558145428Z"}
```
The following example shows a `daemon.json` configuration file with the
"log-format" set;
```json
{
"log-format": "json"
}
```
### Miscellaneous options ### Miscellaneous options
IP masquerading uses address translation to allow containers without a public IP masquerading uses address translation to allow containers without a public
@ -1094,6 +1122,7 @@ The following is a full example of the allowed configuration options on Linux:
"labels": [], "labels": [],
"live-restore": true, "live-restore": true,
"log-driver": "json-file", "log-driver": "json-file",
"log-format": "text",
"log-level": "", "log-level": "",
"log-opts": { "log-opts": {
"cache-disabled": "false", "cache-disabled": "false",
@ -1189,6 +1218,7 @@ The following is a full example of the allowed configuration options on Windows:
"insecure-registries": [], "insecure-registries": [],
"labels": [], "labels": [],
"log-driver": "", "log-driver": "",
"log-format": "text",
"log-level": "", "log-level": "",
"max-concurrent-downloads": 3, "max-concurrent-downloads": 3,
"max-concurrent-uploads": 5, "max-concurrent-uploads": 5,