1
<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>systemd-journald.service</title><meta name="generator" content="DocBook XSL Stylesheets V1.77.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><a href="index.html">Index </a>·
2
<a href="systemd.directives.html">Directives </a>·
3
<a href="../python-systemd/index.html">Python </a>·
4
<a href="../libudev/index.html">libudev </a>·
5
<a href="../libudev/index.html">gudev </a><span style="float:right">systemd 202</span><hr><div class="refentry"><a name="systemd-journald.service"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>systemd-journald.service, systemd-journald.socket, systemd-journald — Journal service</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><p><code class="filename">systemd-journald.service</code></p><p><code class="filename">systemd-journald.socket</code></p><p><code class="filename">/usr/lib/systemd/systemd-journald</code></p></div><div class="refsect1"><a name="idp2969984"></a><h2>Description</h2><p><code class="filename">systemd-journald</code> is a
6
system service that collects and stores logging
7
data. It creates and maintains structured, indexed
8
journals based on logging information that is received
9
from the kernel, from user processes via the libc
10
<a href="syslog.html"><span class="citerefentry"><span class="refentrytitle">syslog</span>(3)</span></a>
11
call, from STDOUT/STDERR of system services or via its
12
native API. It will implicitly collect numerous meta
13
data fields for each log messages in a secure and
15
<a href="systemd.journal-fields.html"><span class="citerefentry"><span class="refentrytitle">systemd.journal-fields</span>(7)</span></a>
16
for more information about the collected meta data.
17
</p><p>Log data collected by the journal is primarily
18
text based but can also include binary data where
19
necessary. All objects stored in the journal can be up
20
to 2^64-1 bytes in size.</p><p>By default the journal stores log data in
21
<code class="filename">/run/log/journal/</code>. Since
22
<code class="filename">/run/</code> is volatile log data is
23
lost at reboot. To make the data persistent it
24
is sufficient to create
25
<code class="filename">/var/log/journal/</code> where
26
<code class="filename">systemd-journald</code> will then store
27
the data.</p><p><code class="filename">systemd-journald</code> will
28
forward all received log messages to the AF_UNIX
30
<code class="filename">/run/systemd/journal/syslog</code> (if it exists) which
31
may be used by UNIX syslog daemons to process the data
33
<a href="journald.conf.html"><span class="citerefentry"><span class="refentrytitle">journald.conf</span>(5)</span></a>
34
for information about the configuration of this
35
service.</p></div><div class="refsect1"><a name="idp4809744"></a><h2>Signals</h2><div class="variablelist"><dl class="variablelist"><dt><span class="term">SIGUSR1</span></dt><dd><p>Request that journal
36
data from <code class="filename">/run/</code>
38
<code class="filename">/var/</code> in order to
39
make it persistent (if this is
40
enabled). This may be used after
41
<code class="filename">/var/</code> is mounted,
42
but is generally not required since
43
the first journal write when
44
<code class="filename">/var/</code> becomes
45
writable triggers the flushing
46
anyway.</p></dd><dt><span class="term">SIGUSR2</span></dt><dd><p>Request immediate
47
rotation of the journal
48
files.</p></dd></dl></div></div><div class="refsect1"><a name="idp3248992"></a><h2>Kernel Command Line</h2><p>A few configuration parameters from
49
<code class="filename">journald.conf</code> may be overridden on
50
the kernel command line:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><code class="varname">systemd.journald.forward_to_syslog=</code>, </span><span class="term"><code class="varname">systemd.journald.forward_to_kmsg=</code>, </span><span class="term"><code class="varname">systemd.journald.forward_to_console=</code></span></dt><dd><p>Enables/disables
51
forwarding of collected log messages
52
to syslog, the kernel log buffer or
55
<a href="journald.conf.html"><span class="citerefentry"><span class="refentrytitle">journald.conf</span>(5)</span></a>
56
for information about these settings.</p></dd></dl></div></div><div class="refsect1"><a name="idp2460864"></a><h2>Access Control</h2><p>Journal files are by default owned and readable
57
by the <code class="literal">systemd-journal</code> system group
58
(but not writable). Adding a user to this group thus
59
enables her/him to read the journal files.</p><p>By default, each logged in user will get her/his
60
own set of journal files in
61
<code class="filename">/var/log/journal/</code>. These files
62
will not be owned by the user however, in order to
63
avoid that the user can write to them
64
directly. Instead, file system ACLs are used to ensure
65
the user gets read access only.</p><p>Additional users and groups may be granted
66
access to journal files via file system access control
67
lists (ACL). Distributions and administrators may
68
choose to grant read access to all members of the
69
<code class="literal">wheel</code> and <code class="literal">adm</code>
70
system groups with a command such as the
71
following:</p><pre class="programlisting"># setfacl -Rnm g:wheel:rx,d:g:wheel:rx,g:adm:rx,d:g:adm:rx /var/log/journal/</pre><p>Note that this command will update the ACLs both
72
for existing journal files and for future journal
74
<code class="filename">/var/log/journal/</code>
75
directory.</p></div><div class="refsect1"><a name="idp2340640"></a><h2>See Also</h2><p>
76
<a href="systemd.html"><span class="citerefentry"><span class="refentrytitle">systemd</span>(1)</span></a>,
77
<a href="journalctl.html"><span class="citerefentry"><span class="refentrytitle">journalctl</span>(1)</span></a>,
78
<a href="journald.conf.html"><span class="citerefentry"><span class="refentrytitle">journald.conf</span>(5)</span></a>,
79
<a href="systemd.journal-fields.html"><span class="citerefentry"><span class="refentrytitle">systemd.journal-fields</span>(7)</span></a>,
80
<a href="sd-journal.html"><span class="citerefentry"><span class="refentrytitle">sd-journal</span>(3)</span></a>,
81
<a href="setfacl.html"><span class="citerefentry"><span class="refentrytitle">setfacl</span>(1)</span></a>
82
</p></div></div></body></html>