New

The executive guide to generative AI

Read more
About usPartnersSupport|Login

WARNING: Version 6.0 of Winlogbeat has passed its EOL date.

This documentation is no longer being maintained and may be removed. If you are running this version, we strongly advise you to upgrade. For the latest information, see the current release documentation.

« Add Kubernetes metadata Parse logs by using ingest node »
Elastic Docs ›Winlogbeat Reference [6.0] ›Configuring Winlogbeat ›Filter and Enhance the exported data

Add Docker metadata

edit
IMPORTANT: This documentation is no longer updated. Refer to Elastic's version policy and the latest documentation.

Add Docker metadata

edit

This functionality is in beta and is subject to change. The design and code is less mature than official GA features and is being provided as-is with no warranties. Beta features are not subject to the support SLA of official GA features.

The add_docker_metadata processor annotates each event with relevant metadata from Docker containers:

  • Container ID
  • Name
  • Image
  • Labels 
processors:
- add_docker_metadata:
    host: "unix:///var/run/docker.sock"
    #match_fields: ["system.process.cgroup.id"]
    #match_source: true
    #match_source_index: 4
    #cleanup_timeout: 60
    # To connect to Docker over TLS you must specify a client and CA certificate.
    #ssl:
    #  certificate_authority: "/etc/pki/root/ca.pem"
    #  certificate:           "/etc/pki/client/cert.pem"
    #  key:                   "/etc/pki/client/cert.key"

It has the following settings:

host
(Optional) Docker socket (UNIX or TCP socket). It uses unix:///var/run/docker.sock by default.
match_fields
(Optional) A list of fields to match a container id, at least one of them should hold a container id to get the event enriched.
match_source
(Optional) Match container id from a log path present in source field. Enabled by default.
match_source_index
(Optional) Index in the source path split by / to look for container id. It defaults to 4 to match /var/lib/docker/containers/<container_id>/*.log
cleanup_timeout
(Optional) Time of inactivity to consider we can clean and forget metadata for a container, 60s by default.
« Add Kubernetes metadata Parse logs by using ingest node »
Was this helpful?
Feedback