{"id":3218,"date":"2022-12-20T16:43:51","date_gmt":"2022-12-20T19:43:51","guid":{"rendered":"http:\/\/lode.uno\/linux-man\/index.php\/2022\/12\/20\/systemdjournalgatewayd-service-man8\/"},"modified":"2022-12-20T16:43:51","modified_gmt":"2022-12-20T19:43:51","slug":"systemdjournalgatewayd-service-man8","status":"publish","type":"post","link":"https:\/\/lode.uno\/linux-man\/2022\/12\/20\/systemdjournalgatewayd-service-man8\/","title":{"rendered":"SYSTEMD−JOURNAL−GATEWAYD.SERVICE (man8)"},"content":{"rendered":"

SYSTEMD\u2212JOURNAL\u2212GATEWAYD.SERVICE<\/h1>\n

NAME<\/a>
SYNOPSIS<\/a>
DESCRIPTION<\/a>
OPTIONS<\/a>
SUPPORTED URLS<\/a>
ACCEPT HEADER<\/a>
RANGE HEADER<\/a>
URL GET PARAMETERS<\/a>
EXAMPLES<\/a>
SEE ALSO<\/a>
NOTES<\/a> <\/p>\n

\n

NAME <\/a> <\/h2>\n

systemd-journal-gatewayd.service, systemd-journal-gatewayd.socket, systemd-journal-gatewayd \u2212 HTTP server for journal events<\/p>\n

SYNOPSIS <\/a> <\/h2>\n

systemd\u2212journal\u2212gatewayd.service<\/p>\n

systemd\u2212journal\u2212gatewayd.socket<\/p>\n\n\n
<\/td>\n\n

\/usr\/lib\/systemd\/systemd\u2212journal\u2212gatewayd<\/b> [OPTIONS…]<\/p>\n<\/td>\n

 <\/td>\n<\/tr>\n<\/table>\n

DESCRIPTION <\/a> <\/h2>\n

systemd\u2212journal\u2212gatewayd<\/b> serves journal events over the network. Clients must connect using HTTP. The server listens on port 19531 by default. If \u2212\u2212cert=<\/b> is specified, the server expects HTTPS connections.<\/p>\n

The program is started by systemd<\/b>(1) and expects to receive a single socket. Use systemctl start systemd\u2212journal\u2212gatewayd.socket<\/b> to start the service, and systemctl enable systemd\u2212journal\u2212gatewayd.socket<\/b> to have it started on boot.<\/p>\n

OPTIONS <\/a> <\/h2>\n

The following options are understood:<\/p>\n

\u2212\u2212cert=<\/b><\/p>\n

Specify the path to a file or AF_UNIX<\/b> stream socket to read the server certificate from. The certificate must be in PEM format. This option switches systemd\u2212journal\u2212gatewayd<\/b> into HTTPS mode and must be used together with \u2212\u2212key=<\/b>.<\/p>\n

\u2212\u2212key=<\/b><\/p>\n

Specify the path to a file or AF_UNIX<\/b> stream socket to read the server key corresponding to the certificate specified with \u2212\u2212cert=<\/b> from. The key must be in PEM format.<\/p>\n

\u2212\u2212trust=<\/b><\/p>\n

Specify the path to a file or AF_UNIX<\/b> stream socket to read a CA certificate from. The certificate must be in PEM format.<\/p>\n

\u2212D<\/b> DIR<\/i>, \u2212\u2212directory=<\/b>DIR<\/i><\/p>\n

Takes a directory path as argument. If specified, systemd\u2212journal\u2212gatewayd<\/b> will serve the specified journal directory DIR<\/i> instead of the default runtime and system journal paths.<\/p>\n

\u2212h<\/b>, \u2212\u2212help<\/b><\/p>\n

Print a short help text and exit.<\/p>\n

\u2212\u2212version<\/b><\/p>\n

Print a short version string and exit.<\/p>\n

SUPPORTED URLS <\/a> <\/h2>\n

The following URLs are recognized:<\/p>\n

\/browse<\/p>\n

Interactive browsing.<\/p>\n

\/entries[?option1&option2=value…]<\/p>\n

Retrieval of events in various formats.<\/p>\n

The Accept:<\/b> part of the HTTP header determines the format. Supported values are described below.<\/p>\n

The Range:<\/b> part of the HTTP header determines the range of events returned. Supported values are described below.<\/p>\n

GET parameters can be used to modify what events are returned. Supported parameters are described below.<\/p>\n

\/machine<\/p>\n

Return a JSON structure describing the machine.<\/p>\n

Example:<\/p>\n

{ “machine_id” : “8cf7ed9d451ea194b77a9f118f3dc446”,
“boot_id” : “3d3c9efaf556496a9b04259ee35df7f7”,
“hostname” : “fedora”,
“os_pretty_name” : “Fedora 19 (Rawhide)”,
“virtualization” : “kvm”,
…}<\/p>\n

\/fields\/FIELD_NAME<\/i><\/p>\n

Return a list of values of this field present in the logs.<\/p>\n

ACCEPT HEADER <\/a> <\/h2>\n

Accept:<\/b> format<\/i><\/p>\n

Recognized formats:<\/p>\n

text\/plain<\/b><\/p>\n

The default. Plaintext syslog\u2212like output, one line per journal entry (like journalctl \u2212\u2212output short<\/b>).<\/p>\n

application\/json<\/b><\/p>\n

Entries are formatted as JSON data structures, one per line (like journalctl \u2212\u2212output json<\/b>). See Journal JSON Format<\/font><\/b> [1]<\/font><\/small> for more information.<\/font><\/p>\n

text\/event\u2212stream<\/b><\/font><\/p>\n

Entries are formatted as JSON data structures, wrapped in a format suitable for<\/font> Server\u2212Sent Events<\/font><\/b> [2]<\/font><\/small> (like journalctl \u2212\u2212output json\u2212sse<\/b>).<\/font><\/p>\n

application\/vnd.fdo.journal<\/b><\/font><\/p>\n

Entries are serialized into a binary (but mostly text\u2212based) stream suitable for backups and network transfer (like journalctl \u2212\u2212output export<\/b>). See<\/font> Journal Export Format<\/font><\/b> [3]<\/font><\/small> for more information.<\/font><\/p>\n

RANGE HEADER <\/a> <\/h2>\n

Range: entries=<\/b>cursor<\/i>[[:<\/b>num_skip<\/i>]:<\/b>num_entries<\/i>]<\/b><\/font><\/p>\n

where cursor<\/i> is a cursor string, num_skip<\/i> is an integer, num_entries<\/i> is an unsigned integer.<\/font><\/p>\n

Range defaults to all available events.<\/font><\/p>\n

URL GET PARAMETERS <\/a> <\/h2>\n

Following parameters can be used as part of the URL:<\/font><\/p>\n

follow<\/font><\/p>\n

wait for new events (like journalctl \u2212\u2212follow<\/b>, except that the number of events returned is not limited).<\/font><\/p>\n

discrete<\/font><\/p>\n

Test that the specified cursor refers to an entry in the journal. Returns just this entry.<\/font><\/p>\n

boot<\/font><\/p>\n

Limit events to the current boot of the system (like journalctl \u2212b<\/b>).<\/font><\/p>\n

KEY<\/i>=match<\/i><\/font><\/p>\n

Match journal fields. See systemd.journal-fields<\/b>(7).<\/font><\/p>\n

EXAMPLES <\/a> <\/h2>\n

Retrieve events from this boot from local journal in<\/font> Journal Export Format<\/font><\/b> [3]<\/font><\/small> :<\/font><\/p>\n

curl \u2212\u2212silent \u2212H’Accept: application\/vnd.fdo.journal’
‘http:\/\/localhost:19531\/entries?boot’<\/font><\/p>\n

Listen for core dumps:<\/font><\/p>\n

curl ‘http:\/\/localhost:19531\/entries?follow&MESSAGE_ID=fc2e22bc6ee647b6b90729ab34a250b1’<\/font><\/p>\n

SEE ALSO <\/a> <\/h2>\n

systemd<\/b>(1), journalctl<\/b>(1), systemd.journal-fields<\/b>(7), systemd-journald.service<\/b>(8), systemd-journal-remote.service<\/b>(8), systemd-journal-upload.service<\/b>(8)<\/font><\/p>\n

NOTES <\/a> <\/h2>\n\n\n
<\/td>\n\n

1.<\/font><\/p>\n<\/td>\n

<\/td>\n\n

Journal JSON Format<\/font><\/p>\n<\/td>\n

 <\/td>\n<\/tr>\n<\/table>\n

https:\/\/www.freedesktop.org\/wiki\/Software\/systemd\/json<\/font><\/p>\n\n\n
<\/td>\n\n

2.<\/font><\/p>\n<\/td>\n

<\/td>\n\n

Server-Sent Events<\/font><\/p>\n<\/td>\n

 <\/td>\n<\/tr>\n<\/table>\n

https:\/\/developer.mozilla.org\/en-US\/docs\/Server-sent_events\/Using_server-sent_events<\/font><\/p>\n\n\n
<\/td>\n\n

3.<\/font><\/p>\n<\/td>\n

<\/td>\n\n

Journal Export Format<\/font><\/p>\n<\/td>\n

 <\/td>\n<\/tr>\n<\/table>\n

https:\/\/www.freedesktop.org\/wiki\/Software\/systemd\/export<\/font><\/p>\n

\n","protected":false},"excerpt":{"rendered":"

systemd-journal-gatewayd.service, systemd-journal-gatewayd.socket, systemd-journal-gatewayd \u2212 HTTP server for journal events <\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[2],"tags":[5,52,4,357],"class_list":["post-3218","post","type-post","status-publish","format-standard","hentry","category-8-administracion-del-sistema","tag-5","tag-administracion","tag-man8","tag-systemd-journal-gatewayd"],"gutentor_comment":0,"_links":{"self":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts\/3218","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/comments?post=3218"}],"version-history":[{"count":0,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts\/3218\/revisions"}],"wp:attachment":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/media?parent=3218"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/categories?post=3218"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/tags?post=3218"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}