Journald

Agent Check

Supported OS:

Overview

Systemd-journald is a system service that collects and stores logging data. It creates and maintains structured, indexed journals based on logging information that is received from a variety of sources.

Setup

Installation

Journal files are, by default, owned and readable by the systemd-journal system group. To start collecting your journal logs, you need to:

Install the agent on the instance running the journal
Add the dd-agent user to the systemd-journal group by running:

usermod -a -G systemd-journal dd-agent

Configuration

Create the journald.d/conf.yaml file in the in the Agent’s conf.d/ folder at the root of your Agent’s directory.

Log collection

Available for Agent version >6.0

Collecting logs is disabled by default in the Datadog Agent, you need to enable it in datadog.yaml with:

logs_enabled: true

Then add this configuration block to your journald.d/conf.yaml file to start collecting your Logs:

logs:
  - type: journald

Finally, restart the agent.

Advanced features

Change journal location

By default the Agent looks for the journal at the following locations:

/var/log/journal
/var/run/journal

If your journal is located elsewhere, add a path parameter with the corresponding journal path.

Filter journal units

It is possible to filter in/out specific units thanks to the following parameters:

include_units: Includes all units specified.
exclude_units: Excludes all units specified.

Example:

logs:
  - type: journald
    path: /var/log/journal/
    include_units:
      - docker.service
      - sshd.service

Collect Container tags

Tags are critical for finding information in highly dynamic containerized environments, which is why the Agent can collect container tags in journald logs.

This works automatically when the Agent is running from the host. If you are using the containerized version of the Datadog Agent, mount your journal path and the following file:

/etc/machine-id: this ensures that the Agent can query the journal that is stored on the host.