1
<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>systemd-journalctl</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" title="systemd-journalctl"><a name="systemd-journalctl"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>systemd-journalctl — Query the systemd journal</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">systemd-journalctl [OPTIONS...] [MATCH]</code> </p></div></div><div class="refsect1" title="Description"><a name="id571330"></a><h2>Description</h2><p><span class="command"><strong>systemd-journalctl</strong></span> may be
2
used to query the contents of the
3
<span class="citerefentry"><span class="refentrytitle">systemd</span>(1)</span>
4
journal.</p><p>If called without parameter will show the full
5
contents of the journal, starting with the oldest
6
entry collected.</p><p>If a match argument is passed the output is
7
filtered accordingly. A match is in the format
8
<code class="literal">FIELD=VALUE</code>,
9
e.g. <code class="literal">_SYSTEMD_UNIT=httpd.service</code>.</p><p>Output is interleaved from all accessible
10
journal files, whether they are rotated or currently
11
being written, and regardless whether they belong to the
12
system itself or are accessible user journals.</p><p>All users are granted access to their private
13
per-user journals. However, by default only root and
14
users who are members of the <code class="literal">adm</code>
15
group get access to the system journal and the
16
journals of other users.</p></div><div class="refsect1" title="Options"><a name="id571389"></a><h2>Options</h2><p>The following options are understood:</p><div class="variablelist"><dl><dt><span class="term"><code class="option">--help</code>, </span><span class="term"><code class="option">-h</code></span></dt><dd><p>Prints a short help
17
text and exits.</p></dd><dt><span class="term"><code class="option">--version</code></span></dt><dd><p>Prints a short version
18
string and exits.</p></dd><dt><span class="term"><code class="option">--no-pager</code></span></dt><dd><p>Do not pipe output into a
19
pager.</p></dd><dt><span class="term"><code class="option">--all</code>, </span><span class="term"><code class="option">-a</code></span></dt><dd><p>Show all fields in
20
full, even if they include unprintable
21
characters or are very
22
long.</p></dd><dt><span class="term"><code class="option">--follow</code>, </span><span class="term"><code class="option">-f</code></span></dt><dd><p>Show only most recent
23
journal entries, and continously print
24
new entries as they are appended to
25
the journal.</p></dd><dt><span class="term"><code class="option">--lines=</code>, </span><span class="term"><code class="option">-n</code></span></dt><dd><p>Controls the number of
26
journal lines to show, counting from
27
the most recent ones. Takes a positive
28
integer argument. In follow mode
29
defaults to 10, otherwise is unset
30
thus not limiting how many lines are
31
shown.</p></dd><dt><span class="term"><code class="option">--no-tail</code></span></dt><dd><p>Show all stored output
32
lines, even in follow mode. Undoes the
34
<code class="option">--lines=</code>.</p></dd><dt><span class="term"><code class="option">--output=</code>, </span><span class="term"><code class="option">-o</code></span></dt><dd><p>Controls the
35
formatting of the journal entries that are
37
<code class="literal">short</code>,
38
<code class="literal">short-monotonic</code>,
39
<code class="literal">verbose</code>,
40
<code class="literal">export</code>,
41
<code class="literal">json</code>,
42
<code class="literal">cat</code>. <code class="literal">short</code>
43
is the default and generates an output
44
that is mostly identical to the
45
formatting of classic syslog log
46
files, showing one line per journal
47
entry. <code class="literal">short-monotonic</code>
48
is very similar but shows monotonic
49
timestamps instead of wallclock
50
timestamps. <code class="literal">verbose</code>
51
shows the full structered entry items
53
fiels. <code class="literal">export</code>
54
serializes the journal into a binary
55
(but mostly text-based) stream
56
suitable for backups and network
57
transfer. <code class="literal">json</code>
58
formats entries as JSON data
59
structures. <code class="literal">cat</code>
60
generates a very terse output only
61
showing the actual message of each
62
journal entry with no meta data, not
63
even a timestamp.</p></dd><dt><span class="term"><code class="option">--quiet</code>, </span><span class="term"><code class="option">-q</code></span></dt><dd><p>Suppresses any warning
64
message regarding inaccessable system
65
journals when run as normal
66
user.</p></dd><dt><span class="term"><code class="option">--new-id128</code></span></dt><dd><p>Instead of showing
67
journal contents generate a new 128
68
bit ID suitable for identifying
69
messages. This is intended for usage
70
by developers who need a new
71
identifier for a new message they
72
introduce and want to make
73
recognizable. Will print the new ID in
74
three different formats which can be
75
copied into source code or
76
similar.</p></dd></dl></div></div><div class="refsect1" title="Exit status"><a name="id539113"></a><h2>Exit status</h2><p>On success 0 is returned, a non-zero failure
77
code otherwise.</p></div><div class="refsect1" title="Environment"><a name="id539124"></a><h2>Environment</h2><div class="variablelist"><dl><dt><span class="term"><code class="varname">$SYSTEMD_PAGER</code></span></dt><dd><p>Pager to use when
78
<code class="option">--no-pager</code> is not given;
79
overrides <code class="varname">$PAGER</code>. Setting
80
this to an empty string or the value
81
<code class="literal">cat</code> is equivalent to passing
82
<code class="option">--no-pager</code>.</p></dd></dl></div></div><div class="refsect1" title="See Also"><a name="id539163"></a><h2>See Also</h2><p>
83
<span class="citerefentry"><span class="refentrytitle">systemd</span>(1)</span>,
84
<span class="citerefentry"><span class="refentrytitle">systemctl</span>(1)</span>,
85
<span class="citerefentry"><span class="refentrytitle">systemd-journald.conf</span>(5)</span>
86
</p></div></div></body></html>