Log Tags

The tag log option specifies how to format a tag that identifies the container’s log messages. By default, the system uses the first 12 characters of the container id. To override this behavior, specify a tag option:

docker run --log-driver=fluentd --log-opt fluentd-address=myhost.local:24224 --log-opt tag="mailer"

Docker supports some special template markup you can use when specifying a tag’s value:

Markup Description
{{.ID}} The first 12 characters of the container id.
{{.FullID}} The full container id.
{{.Name}} The container name.
{{.ImageID}} The first 12 characters of the container’s image id.
{{.ImageFullID}} The container’s full image identifier.
{{.ImageName}} The name of the image used by the container.

For example, specifying a --log-opt tag="{{.ImageName}}/{{.Name}}/{{.ID}}" value yields syslog log lines like:

Aug  7 18:33:19 HOSTNAME docker/hello-world/foobar/5790672ab6a0[9103]: Hello from Docker.

At startup time, the system sets the container_name field and {{.Name}} in the tags. If you use docker rename to rename a container, the new name is not reflected in the log messages. Instead, these messages continue to use the original container name.

For advanced usage, the generated tag’s use go templates and the container’s logging context.

Note:The driver specific log options syslog-tag, fluentd-tag and gelf-tag still work for backwards compatibility. However, going forward you should standardize on using the generic tag log option instead.

© 2017 Docker, Inc.
Licensed under the Apache License, Version 2.0.
Docker and the Docker logo are trademarks or registered trademarks of Docker, Inc. in the United States and/or other countries.
Docker, Inc. and other parties may also have trademark rights in other terms used herein.
https://docs.docker.com/v1.11/engine/admin/logging/log_tags/