SYSTEMD-JOURNAL-REMOTE.SERVICE(8) | systemd-journal-remote.service | SYSTEMD-JOURNAL-REMOTE.SERVICE(8) |
NAME
systemd-journal-remote.service, systemd-journal-remote.socket, systemd-journal-remote - Receive journal messages over the network
SYNOPSIS
systemd-journal-remote.service
systemd-journal-remote.socket
/usr/lib/systemd/systemd-journal-remote [OPTIONS...] [-o/--output=DIR|FILE] [SOURCES...]
DESCRIPTION
systemd-journal-remote is a command to receive serialized journal events and store them to journal files. Input streams are in the Journal Export Format[1], i.e. like the output from journalctl --output=export. For transport over the network, this serialized stream is usually carried over an HTTPS connection.
systemd-journal-remote.service is a system service that uses systemd-journal-remote to listen for connections. systemd-journal-remote.socket configures the network address that systemd-journal-remote.service listens on. By default this is port 19532. What connections are accepted and how the received data is stored can be configured through the journal-remote.conf(5) configuration file.
SOURCES
Sources can be either "active" (systemd-journal-remote requests and pulls the data), or "passive" (systemd-journal-remote waits for a connection and then receives events pushed by the other side).
systemd-journal-remote can read more than one event stream at a time. They will be interleaved in the output file. In case of "active" connections, each "source" is one stream, and in case of "passive" connections, each connection can result in a separate stream. Sockets can be configured in "accept" mode (i.e. only one connection), or "listen" mode (i.e. multiple connections, each resulting in a stream).
When there are no more connections, and no more can be created (there are no listening sockets), then systemd-journal-remote will exit.
Active sources can be specified in the following ways:
[SOURCES]
Added in version 239.
--url=ADDRESS
Added in version 239.
--getter='PROG [OPTIONS]'
Examples:
--getter='curl "-HAccept: application/vnd.fdo.journal" https://some.host:19531/'
--getter='wget --header="Accept: application/vnd.fdo.journal" -O- https://some.host:19531/'
Added in version 239.
Passive sources can be specified in the following ways:
--listen-raw=ADDRESS
Added in version 239.
--listen-http=ADDRESS, --listen-https=ADDRESS
Added in version 239.
$LISTEN_FDS
Added in version 239.
--key=
Added in version 239.
--cert=
Added in version 239.
--trust=
Added in version 239.
--gnutls-log=
Added in version 239.
SINKS
The location of the output journal can be specified with -o or --output=.
-o FILE, --output=FILE
Added in version 239.
-o DIR, --output=DIR
Added in version 239.
If --output= is not used, the output directory /var/log/journal/remote/ will be used. In case the output file is not specified, journal files will be created underneath the selected directory. Files will be called remote-hostname.journal, where the hostname part is the escaped hostname of the source endpoint of the connection, or the numerical address if the hostname cannot be determined.
In the case that "active" sources are given by the positional arguments or --getter= option, the output file name must always be given explicitly.
OPTIONS
The following options are understood:
--split-mode
In the case that "active" sources are given by the positional arguments or --getter= option, the output file name must always be given explicitly and only none is allowed.
Added in version 239.
--compress [BOOL]
Added in version 239.
--seal [BOOL]
Added in version 239.
-h, --help
--version
EXAMPLES
Copy local journal events to a different journal directory:
journalctl -o export | systemd-journal-remote -o /tmp/dir/foo.journal -
Retrieve all available events from a remote systemd-journal-gatewayd(8) instance and store them in /var/log/journal/remote/remote-some.host.journal:
systemd-journal-remote --url http://some.host:19531/
Retrieve current boot events and wait for new events from a remote systemd-journal-gatewayd(8) instance, and store them in /var/log/journal/remote/remote-some.host.journal:
systemd-journal-remote --url http://some.host:19531/entries?boot&follow
SEE ALSO
journal-remote.conf(5), journalctl(1), systemd-journal-gatewayd.service(8), systemd-journal-upload.service(8), systemd-journald.service(8)
NOTES
- 1.
- Journal Export Format
systemd 256.6 |