Skip to content

docs: document custom attribute log options for the local driver - #25827

Open
santhiprakash wants to merge 1 commit into
docker:mainfrom
santhiprakash:docs/local-logging-custom-attributes
Open

docs: document custom attribute log options for the local driver#25827
santhiprakash wants to merge 1 commit into
docker:mainfrom
santhiprakash:docs/local-logging-custom-attributes

Conversation

@santhiprakash

Copy link
Copy Markdown
Contributor

Summary

Documents the custom attribute log options (labels, labels-regex, env, env-regex, tag) that were added to the local logging driver in Docker Engine 29.5.0.

Problem

The local file logging driver reference page only listed max-size, max-file, and compress in its Options table. Docker Engine 29.5.0 (moby/moby#52348) added support for custom attributes to the local driver, bringing feature-parity with the json-file driver for the labels, labels-regex, env, env-regex, and tag log options. These options were missing from the reference page, so users had no way to discover that the local driver now accepts them.

Fix

Added labels, labels-regex, env, env-regex, and tag rows to the Options table in content/manuals/engine/logging/drivers/local.md, matching the wording and style used by the json-file driver reference (json-file.md). Each option links to the existing log_tags.md page for the advanced tag templating details.

The option names, descriptions, and example values were verified against:

  • The LogOptKeys map in moby/moby daemon/logger/local/local.go (which registers labels, labels-regex, env, env-regex, tag via the shared logger.Attr* constants).
  • The release notes entry in content/manuals/engine/release-notes/29.md (29.5.0: "The local logging driver now has support for custom attributes...").

Verification

  • git diff confirms a minimal, single-file change (10 insertions, 5 deletions).
  • The Options table markdown is well-formed and the log_tags.md relative link resolves to the existing file in the same directory.
  • Option names match the actual CLI option strings accepted by the driver (e.g. --log-opt labels=..., not the singular label=...).

The local logging driver gained support for custom attributes in Docker
Engine 29.5.0 (moby/moby#52348), bringing feature-parity with the
json-file driver for labels, labels-regex, env, env-regex, and tag log
options. These options were missing from the local driver reference
page, which only listed max-size, max-file, and compress.
@santhiprakash
santhiprakash requested a review from dvdksn as a code owner August 13, 2026 23:38
@netlify

netlify Bot commented Aug 13, 2026

Copy link
Copy Markdown

Deploy Preview for docsdocker ready!

Name Link
🔨 Latest commit 8167660
🔍 Latest deploy log https://app.netlify.com/projects/docsdocker/deploys/6a7e559627b60f0008b4ab3d
😎 Deploy Preview https://deploy-preview-25827--docsdocker.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@github-actions github-actions Bot added the area/engine Issue affects Docker engine/daemon label Aug 13, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/engine Issue affects Docker engine/daemon

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant