1
<?xml version='1.0'?> <!--*-nxml-*-->
2
<?xml-stylesheet type="text/xsl" href="http://docbook.sourceforge.net/release/xsl/current/xhtml/docbook.xsl"?>
3
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
4
"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
7
This file is part of systemd.
9
Copyright 2010 Lennart Poettering
11
systemd is free software; you can redistribute it and/or modify it
12
under the terms of the GNU Lesser General Public License as published by
13
the Free Software Foundation; either version 2.1 of the License, or
14
(at your option) any later version.
16
systemd is distributed in the hope that it will be useful, but
17
WITHOUT ANY WARRANTY; without even the implied warranty of
18
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
19
Lesser General Public License for more details.
21
You should have received a copy of the GNU Lesser General Public License
22
along with systemd; If not, see <http://www.gnu.org/licenses/>.
25
<refentry id="journald.conf">
27
<title>journald.conf</title>
28
<productname>systemd</productname>
32
<contrib>Developer</contrib>
33
<firstname>Lennart</firstname>
34
<surname>Poettering</surname>
35
<email>lennart@poettering.net</email>
41
<refentrytitle>journald.conf</refentrytitle>
42
<manvolnum>5</manvolnum>
46
<refname>journald.conf</refname>
47
<refpurpose>Journal service configuration file</refpurpose>
51
<para><filename>/etc/systemd/journald.conf</filename></para>
55
<title>Description</title>
57
<para>This files configures various parameters of the
58
systemd journal service
59
<citerefentry><refentrytitle>systemd-journald.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>.</para>
64
<title>Options</title>
66
<para>All options are configured in the
67
<literal>[Journal]</literal> section:</para>
72
<term><varname>Storage=</varname></term>
74
<listitem><para>Controls where to
75
store journal data. One of
76
<literal>volatile</literal>,
77
<literal>persistent</literal>,
78
<literal>auto</literal> and
79
<literal>none</literal>. If
80
<literal>volatile</literal> journal
81
log data will be stored only in
82
memory, i.e. below the
83
<filename>/run/log/journal</filename>
84
hierarchy (which is created if
86
<literal>persistent</literal> data will
87
be stored preferably on disk,
89
<filename>/var/log/journal</filename>
90
hierarchy (which is created if
91
needed), with a fallback to
92
<filename>/run/log/journal</filename>
93
(which is created if needed), during
94
early boot and if the disk is not
95
writable. <literal>auto</literal> is
97
<literal>persistent</literal> but the
99
<filename>/var/log/journal</filename>
100
is not created if needed, so that its
101
existence controls where log data
102
goes. <literal>none</literal> turns
103
off all storage, all log data received
104
will be dropped. Forwarding to other
105
targets, such as the console, the
106
kernel log buffer or a syslog daemon
107
will still work however. Defaults to
108
<literal>auto</literal>.</para></listitem>
112
<term><varname>Compress=</varname></term>
114
<listitem><para>Takes a boolean
115
value. If enabled (the default) data
116
objects that shall be stored in the
117
journal and are larger than a certain
118
threshold are compressed with the XZ
119
compression algorithm before they are
121
system.</para></listitem>
125
<term><varname>Seal=</varname></term>
127
<listitem><para>Takes a boolean
128
value. If enabled (the default) and a
129
sealing key is available (as created
131
<citerefentry><refentrytitle>journalctl</refentrytitle><manvolnum>1</manvolnum></citerefentry>'s
132
<option>--setup-keys</option>
133
command), forward secure sealing (FSS) for
134
all persistent journal files is
135
enabled.</para></listitem>
139
<term><varname>SplitMode=</varname></term>
141
<listitem><para>Controls whether to
142
split up journal files per user. One
143
of <literal>login</literal>,
144
<literal>uid</literal> and
145
<literal>none</literal>. If
146
<literal>login</literal> each logged
147
in user will get his own journal
148
files, but systemd user IDs will log
149
into the system journal. If
150
<literal>uid</literal> any user ID
151
will get his own journal files
152
regardless whether it belongs to a
153
system service or refers to a real
155
<literal>none</literal> journal files
156
are not split up per-user and all
157
messages are stored in the single
158
system journal. Note that splitting
159
up journal files per-user is only
160
available of journals are stored
161
persistently. If journals are stored
162
on volatile storage (see above) only a
163
single journal file for all user IDs
165
<literal>login</literal>.</para></listitem>
169
<term><varname>RateLimitInterval=</varname></term>
170
<term><varname>RateLimitBurst=</varname></term>
172
<listitem><para>Configures the rate
173
limiting that is applied to all
174
messages generated on the system. If
175
in the time interval defined by
176
<varname>RateLimitInterval=</varname>
177
more messages than specified in
178
<varname>RateLimitBurst=</varname> are
179
logged by a service all further
180
messages within the interval are
181
dropped, until the interval is over. A
182
message about the number of dropped
183
messages is generated. This rate
184
limiting is applied per-service, so
185
that two services which log do not
186
interfere with each other's
187
limits. Defaults to 200 messages in
188
10s. The time specification for
189
<varname>RateLimitInterval=</varname>
190
may be specified in the following
191
units: <literal>s</literal>,
192
<literal>min</literal>,
193
<literal>h</literal>,
194
<literal>ms</literal>,
195
<literal>us</literal>. To turn off any
196
kind of rate limiting, set either
197
value to 0.</para></listitem>
201
<term><varname>SystemMaxUse=</varname></term>
202
<term><varname>SystemKeepFree=</varname></term>
203
<term><varname>SystemMaxFileSize=</varname></term>
204
<term><varname>RuntimeMaxUse=</varname></term>
205
<term><varname>RuntimeKeepFree=</varname></term>
206
<term><varname>RuntimeMaxFileSize=</varname></term>
208
<listitem><para>Enforce size limits on
209
the journal files stored. The options
211
<literal>System</literal> apply to the
212
journal files when stored on a
213
persistent file system, more
215
<filename>/var/log/journal</filename>. The
216
options prefixed with
217
<literal>Runtime</literal> apply to
218
the journal files when stored on a
219
volatile in-memory file system, more
221
<filename>/run/log/journal</filename>. The
222
former is used only when
223
<filename>/var</filename> is mounted,
224
writable and the directory
225
<filename>/var/log/journal</filename>
226
exists. Otherwise only the latter
227
applies. Note that this means that
228
during early boot and if the
229
administrator disabled persistent
230
logging only the latter options apply,
231
while the former apply if persistent
232
logging is enabled and the system is
234
up. <varname>SystemMaxUse=</varname>
235
and <varname>RuntimeMaxUse=</varname>
236
control how much disk space the
237
journal may use up at
238
maximum. Defaults to 10% of the size
239
of the respective file
240
system. <varname>SystemKeepFree=</varname>
242
<varname>RuntimeKeepFree=</varname>
243
control how much disk space the
244
journal shall always leave free for
245
other uses if less than the disk space
247
<varname>SystemMaxUse=</varname> and
248
<varname>RuntimeMaxUse=</varname> is
249
available. Defaults to 15% of the size
250
of the respective file
251
system. <varname>SystemMaxFileSize=</varname>
253
<varname>RuntimeMaxFileSize=</varname>
254
control how large individual journal
255
files may grow at maximum. This
256
influences the granularity in which
257
disk space is made available through
258
rotation, i.e. deletion of historic
259
data. Defaults to one eighth of the
260
values configured with
261
<varname>SystemMaxUse=</varname> and
262
<varname>RuntimeMaxUse=</varname>, so
263
that usually seven rotated journal
264
files are kept as history. Specify
265
values in bytes or use K, M, G, T, P,
266
E as units for the specified
267
sizes. Note that size limits are
268
enforced synchronously to journal
269
files as they are extended, and need
270
no explicit rotation step triggered by
271
time.</para></listitem>
275
<term><varname>MaxFileSec=</varname></term>
277
<listitem><para>The maximum time to
278
store entries in a single journal
279
file, before rotating to the next
280
one. Normally time-based rotation
281
should not be required as size-based
282
rotation with options such as
283
<varname>SystemMaxFileSize=</varname>
284
should be sufficient to ensure that
285
journal files don't grow without
286
bounds. However, to ensure that not
287
too much data is lost at once when old
288
journal files are deleted it might
289
make sense to change this value from
290
the default of one month. Set to 0 to
291
turn off this feature. This setting
292
takes time values which may be
293
suffixed with the units year, month,
294
week, day, h, m to override the
296
seconds.</para></listitem>
300
<term><varname>MaxRetentionSec=</varname></term>
302
<listitem><para>The maximum time to
303
store journal entries. This
304
controls whether journal files
305
containing entries older then the
306
specified time span are
307
deleted. Normally time-based deletion
308
of old journal files should not be
309
required as size-based deletion with
311
<varname>SystemMaxUse=</varname>
312
should be sufficient to ensure that
313
journal files don't grow without
314
bounds. However, to enforce data
315
retention policies it might make sense
316
to change this value from the
317
default of 0 (which turns off this
318
feature). This setting also takes
319
time values which may be suffixed with
320
the units year, month, week, day, h, m
321
to override the default time unit of
322
seconds. </para></listitem>
327
<term><varname>SyncIntervalSec=</varname></term>
329
<listitem><para>The timeout before syncing journal
330
data to disk. After syncing journal files have
331
OFFLINE state. Default timeout is 5 minutes.
336
<term><varname>ForwardToSyslog=</varname></term>
337
<term><varname>ForwardToKMsg=</varname></term>
338
<term><varname>ForwardToConsole=</varname></term>
340
<listitem><para>Control whether log
341
messages received by the journal
342
daemon shall be forwarded to a
343
traditional syslog daemon, to the
344
kernel log buffer (kmsg), or to the
345
system console. These options take
346
boolean arguments. If forwarding to
347
syslog is enabled but no syslog daemon
348
is running the respective option has
349
no effect. By default only forwarding
350
to syslog is enabled. These settings
351
may be overridden at boot time with
352
the kernel command line options
353
<literal>systemd.journald.forward_to_syslog=</literal>,
354
<literal>systemd.journald.forward_to_kmsg=</literal>
356
<literal>systemd.journald.forward_to_console=</literal>.
361
<term><varname>MaxLevelStore=</varname></term>
362
<term><varname>MaxLevelSyslog=</varname></term>
363
<term><varname>MaxLevelKMsg=</varname></term>
364
<term><varname>MaxLevelConsole=</varname></term>
366
<listitem><para>Controls the maximum
367
log level of messages that are stored
368
on disk, forwarded to syslog, kmsg or
369
the console (if that is enabled, see
370
above). As argument, takes one of
371
<literal>emerg</literal>,
372
<literal>alert</literal>,
373
<literal>crit</literal>,
374
<literal>err</literal>,
375
<literal>warning</literal>,
376
<literal>notice</literal>,
377
<literal>info</literal>,
378
<literal>debug</literal> or integer
379
values in the range of 0..7 (corresponding
380
to the same levels). Messages equal or below
381
the log level specified are
382
stored/forwarded, messages above are
384
<literal>debug</literal> for
385
<varname>MaxLevelStore=</varname> and
386
<varname>MaxLevelSyslog=</varname>, to
387
ensure that the all messages are
388
written to disk and forwarded to
390
<literal>notice</literal> for
391
<varname>MaxLevelKMsg=</varname> and
392
<literal>info</literal> for
393
<varname>MaxLevelConsole=</varname>.</para></listitem>
397
<term><varname>TTYPath=</varname></term>
399
<listitem><para>Change the console TTY
401
<varname>ForwardToConsole=yes</varname>
403
<filename>/dev/console</filename>.</para></listitem>
411
<title>See Also</title>
413
<citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
414
<citerefentry><refentrytitle>systemd-journald.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
415
<citerefentry><refentrytitle>journalctl</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
416
<citerefentry><refentrytitle>systemd.journal-fields</refentrytitle><manvolnum>7</manvolnum></citerefentry>,
417
<citerefentry><refentrytitle>systemd-system.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry>