journald.conf
systemd
Developer
Lennart
Poettering
lennart@poettering.net
journald.conf
5
journald.conf
Journal service configuration file
/etc/systemd/journald.conf
Description
This files configures various parameters of the
systemd journal service
systemd-journald.service8.
Options
All options are configured in the
[Journal] section:
Compress=
Takes a boolean
value. If enabled (the default) data
objects that shall be stored in the
journal and are larger than a certain
threshold are compressed with the XZ
compression algorithm before they are
written to the file
system.
RateLimitInterval=
RateLimitBurst=
Configures the rate
limiting that is applied to all
messages generated on the system. If
in the time interval defined by
RateLimitInterval=
more messages than specified in
RateLimitBurst= are
logged by a service all further
messages within the interval are
dropped, until the interval is over. A
message about the number of dropped
messages is generated. This rate
limiting is applied per-service, so
that two services which log do not
interfere with each other's
limit. Defaults to 100 messages in
10s. The time specification for
RateLimitInterval=
may be specified in the following
units: s,
min,
h,
ms,
us. To turn off any
kind of rate limiting, set either
value to 0.
SystemMaxUse=
SystemKeepFree=
SystemMaxFileSize=
SystemMinFileSize=
RuntimeMaxUse=
RuntimeKeepFree=
RuntimeMaxFileSize=
RuntimeMinFileSize=
Enforce size limits on
the journal files stored. The options
prefixed with
System apply to the
journal files when stored on a
persistent file system, more
specifically
/var/log/journal. The
options prefixed with
Runtime apply to
the journal files when stored on a
volatile in-memory file system, more
specifically
/run/log/journal. The
former is used only when
/var is mounted,
writable and the directory
/var/log/journal
exists. Otherwise only the latter
applies. Note that this means that
during early boot and if the
administrator disabled persistent
logging only the latter options apply,
while the former apply if persistent
logging is enabled and the system is
fully booted
up. SystemMaxUse=
and RuntimeMaxUse=
control how much disk space the
journal may use up at
maximum. Defaults to 10% of the size
of the respective file
system. SystemKeepFree=
and
RuntimeKeepFree=
control how much disk space the
journal shall always leave free for
other uses if less than the disk space
configured in
SystemMaxUse= and
RuntimeMaxUse= is
available. Defaults to 5% of the size
of the respective file
system. SystemMaxFileSize=
and
RuntimeMaxFileSize=
control how large individual journal
files may grow at maximum. This
influences the granularity in which
disk space is made available through
rotation, i.e. deletion of historic
data. Defaults to one eigth of the
values configured with
SystemMaxUse= and
RuntimeMaxUse=, so
that usually seven rotated journal
files are kept as
history. SystemMinFileSize=
and
RuntimeMinFileSize=
control how large individual journal
files grow at minimum. Defaults to
64K. Specify values in bytes or use
K, M, G, T, P, E as units for the
specified sizes. Note that size limits
are enforced synchronously to journal
files as they are extended, and need
no explicit rotation step triggered by
time.
ForwardToSyslog=
ForwardToKMsg=
ForwardToConsole=
Control whether log
messages received by the journal
daemon shall be forwarded to a
traditional syslog daemon, to the
kernel log buffer (kmsg), or to the
system console. These options take
boolean arguments. If forwarding to
syslog is enabled but no syslog daemon
is running the respective option has
no effect. By default only forwarding
to syslog is enabled. These settings
may be overridden at boot time with the
kernel command line options
systemd.journald.forward_to_syslog=,
systemd.journald.forward_to_kmsg=
and
systemd.journald.forward_to_console=. If
forwarding to the kernel log buffer and
ImportKernel= is
enabled at the same time care is taken
to avoid logging loops. It is safe to
use these options in combination.
MaxLevelStore=
MaxLevelSyslog=
MaxLevelKMsg=
MaxLevelConsole=
Controls the maximum
log level of messages that are stored
on disk, forwarded to syslog, kmsg or
the console (if that is enabled, see
above). As argument, takes one of
emerg,
alert,
crit,
err,
warning,
notice,
info,
debug or integer
values in the range of 0..7 (corresponding
to the same levels). Messages equal or below
the log level specified are
stored/forwarded, messages above are
dropped. Defaults to
debug for
MaxLevelStore= and
MaxLevelSyslog=, to
ensure that the all messages are
written to disk and forwarded to
syslog. Defaults to
notice for
MaxLevelKMsg= and
info for
MaxLevelConsole=.
TTYPath=
Change the console TTY
to use if
ForwardToConsole=yes
is used. Defaults to
/dev/console.
ImportKernel=
Controls whether
kernel log messages shall be stored in
the journal. Takes a boolean argument
and defaults to disabled. Note that
currently only one userspace service
can read kernel messages at a time,
which means that kernel log message
reading might get corrupted if it
is enabled in more than one service,
for example in both the journal and a
traditional syslog service.
Storage=
Controls where to
store journal data. One of
volatile,
permanent,
auto and
none. If
volatile journal
log data will be stored only in
memory, i.e. below the
/run/log/journal
hierarchy (which is created if
needed). If
permanent data will
be stored preferably on disk,
i.e. below the
/var/log/journal
hierarchy (which is created if
needed), with a fallback to
/run/log/journal
(which is created if needed), during
early boot and if the disk is not
writable. auto is
similar to
permanent but the
directory
/var/log/journal
is not created if needed, so that its
existance controls where log data
goes. none turns
off all storage, all log data received
will be dropped. Forwarding to other
targets, such as the console, the
kernel log buffer or a syslog daemon
will still work however. Defaults to
auto.
See Also
systemd1,
systemd-journald.service8,
journalctl1,
systemd.journal-fields7,
systemd.conf5