Provided by: manpages-de_4.27.0-1_all 
BEZEICHNUNG
systemd-journal-gatewayd.service, systemd-journal-gatewayd.socket, systemd-journal-gatewayd - HTTP-Server
für Journal-Ereignisse
ÜBERSICHT
systemd-journal-gatewayd.service
systemd-journal-gatewayd.socket
/usr/lib/systemd/systemd-journal-gatewayd [OPTIONEN…]
BESCHREIBUNG
systemd-journal-gatewayd bedient Journal-Ereignisse über das Netzwerk. Clients müssen sich mit HTTP
verbinden. Der Server wartet standardmäßig auf Port 19531 auf Anfragen. Falls --cert= angegeben ist,
erwartet der Server HTTPS-Verbindungen.
Das Programm wird durch systemd(1) gestartet und erwartet den Empfang eines einzelnen Sockets. Verwenden
Sie zum Starten des Dienstes systemctl start systemd-journal-gatewayd.socket und systemctl enable
systemd-journal-gatewayd.socket, um ihn beim Systemstart zu starten.
OPTIONEN
Die folgenden Optionen werden verstanden:
--cert=
Gibt den Pfad zu einer Datei oder einem AF_UNIX-Datenstrom-Socket an, woraus das Server-Zertifikat
gelesen wird. Das Zertifikat muss im PEM-Format vorliegen. Diese Option schaltet
systemd-journal-gatewayd in den HTTPS-Modus um und muss zusammen mit --key= verwandt werden.
Hinzugefügt in Version 198.
--key=
Gibt den Pfad zu einer Datei oder einem AF_UNIX-Datenstrom-Socket an, woraus der
Server-Geheimschlüssel, der dem mit --cert= festgelegten Zertifikat entspricht, gelesen wird. Das
Zertifikat muss im PEM-Format vorliegen.
Hinzugefügt in Version 198.
--trust=
Gibt den Pfad zu einer Datei oder einem AF_UNIX-Datenstrom-Socket an, woraus das CA-Zertifikat
gelesen wird. Das Zertifikat muss im PEM-Format vorliegen.
Hinzugefügt in Version 236.
--system, --user
Begrenzt die ausgelieferten Einträge auf Einträge von Systemdiensten und dem Kernel oder auf Einträge
vom aktuellen Benutzer. Dies hat die gleiche Bedeutung wie die Optionen --system und --user für
journalctl(1). Falls keine davon festgelegt ist, dann werden alle zugreifbaren Einträge ausgeliefert.
Hinzugefügt in Version 249.
-m, --merge
Liefert Einträge verschachtelt von allen verfügbaren Journals aus, einschließlich anderer Maschinen.
Dies hat die gleiche Bedeutung wie die Option --merge für journalctl(1).
Hinzugefügt in Version 249.
-D VERZEICHNIS, --directory=VERZEICHNIS
Akzeptiert einen Verzeichnispfad als Argument. Falls angegeben, wird systemd-journal-gatewayd das
angegebene Journal-Verzeichnis VERZ statt der vorgegebenen Laufzeit- und System-Journal-Pfade
bedienen.
Hinzugefügt in Version 232.
--file=GLOB
Akzeptiert einen Datei-Glob als Argument. Liefert Einträge von den festgelegten Journal-Dateien, die
auf GLOB passen, aus, statt von den Standard-Laufzeit- und System-Journal-Pfaden. Kann mehrfach
angegeben werden, wodurch die Dateien geeignet verschachtelt werden. Dies hat die gleiche Bedeutung
wie die Option --file= für journalctl(1).
Hinzugefügt in Version 249.
-h, --help
Zeigt einen kurzen Hilfetext an und beendet das Programm.
--version
Zeigt eine kurze Versionszeichenkette an und beendet das Programm.
UNTERSTÜTZTE URLS
Die folgenden URLs werden erkannt:
/browse
Interaktives Browsen.
Hinzugefügt in Version 197.
/entries[?Option1&Option2=Wert…]
Abruf von Ereignissen in verschiedenen Formaten.
Der Accept:-Anteil der HTTP-Kopfzeilen bestimmt das Format. Unterstützte Werte werden nachfolgend
beschrieben.
Der Range:-Anteil der HTTP-Kopfzeilen bestimmt den Bereich der zurückgelieferten Ereignisse.
Unterstützte Werte werden nachfolgend beschrieben.
GET-Parameter können zur Veränderung der Auswahl der zurückgelieferten Ereignisse verwandt werden.
Unterstützte Parameter werden nachfolgend beschrieben.
Hinzugefügt in Version 197.
/machine
Liefert eine die Maschine beschreibende JSON-Struktur zurück.
Beispiel:
{ "machine_id" : "8cf7ed9d451ea194b77a9f118f3dc446",
"boot_id" : "3d3c9efaf556496a9b04259ee35df7f7",
"hostname" : "fedora",
"os_pretty_name" : "Fedora 19 (Rawhide)",
"virtualization" : "kvm",
…}
Hinzugefügt in Version 197.
/fields/FELDNAME
Liefert eine in den Protokollen vorhandende Liste von Werte dieses Feldes zurück.
Hinzugefügt in Version 197.
ACCEPT-KOPFZEILEN
Accept: Format
Erkannte Formate:
text/plain
Die Vorgabe. Syslog-artige Ausgabe im Klartext, eine Zeile pro Journal-Eintrag (wie journalctl
--output short).
Hinzugefügt in Version 197.
application/json
Einträge werden als JSON-Datenstruktur formatiert, eine pro Zeile (wie journalctl --output json).
Siehe Journal-JSON-Format[1] für weitere Informationen.
Hinzugefügt in Version 197.
text/event-stream
Einträge werden als JSON-Datenstrukturen, eingehüllt in einem für Server-gesandte Ereignisse[2]
geeigneten Format, formatiert (wie journalctl --output json-sse).
Hinzugefügt in Version 229.
application/vnd.fdo.journal
Einträge werden in einen binären (aber primär textbasierten), für Datensicherungen und
Netzwerktransfer geeigneten Datenstrom serialisiert (wie journalctl --output export). Siehe Journal
Exportformat[3] für weitere Informationen.
Hinzugefügt in Version 197.
BEREICHSKOPFZEILEN
Range: entries=Position[[:Ausl_Anz]:Eintrag_Anz]
Range: realtime=[seit]:[bis][[:Ausl_Anz]:Eintrag_Anz]
wobei Position eine Positionszeichenkette, seit und bis Zeitstempel (Sekunden seit 1970-01-01 00:00:00
UTC), Ausl_Anz eine Ganzzahl und Eintrag_Anz eine vorzeichenfreie Ganzzahl ist.
Der Bereich umfasst standardmäßig alle Ereignisse.
URL GET-PARAMETER
Die folgenden Parameter können als Teil der URL verwandt werden:
follow
Wartet auf neue Ereignisse (wie journalctl --follow, außer dass die Anzahl der zurückgelieferten
Ereignisse nicht begrenzt wird).
Hinzugefügt in Version 197.
discrete
Prüft, ob sich die festgelegte Position auf einen Eintrag im Journal bezieht. Liefert nur diesen
Eintrag zurück.
Hinzugefügt in Version 197.
boot
Begrenzt Ereignisse auf den derzeitigen Systemstart (wie journalctl -b).
Hinzugefügt in Version 197.
KEY=Treffer
Überprüft auf Journal-Felder. Siehe systemd.journal-fields(7).
Hinzugefügt in Version 197.
BEISPIELE
Fragt Ereignisse von diesem Systemstart aus dem lokalen Journal im Journal-Exportformat[3] ab:
curl --silent -H'Accept: application/vnd.fdo.journal' \
'http://localhost:19531/entries?boot'
Warten auf Speicherauszüge:
curl 'http://localhost:19531/entries?follow&MESSAGE_ID=fc2e22bc6ee647b6b90729ab34a250b1'
SIEHE AUCH
systemd(1), journalctl(1), systemd.journal-fields(7), systemd-journald.service(8),
systemd-journal-remote.service(8), systemd-journal-upload.service(8)
ANMERKUNGEN
1. Journal-JSON-Format
https://systemd.io/JOURNAL_EXPORT_FORMATS#journal-json-format
2. Server-gesandte Ereignisse
https://developer.mozilla.org/de/docs/Web/API/Server-sent_events/Using_server-sent_events
3. Journal-Exportformat
https://systemd.io/JOURNAL_EXPORT_FORMATS#journal-export-format
ÜBERSETZUNG
Die deutsche Übersetzung dieser Handbuchseite wurde von Helge Kreutzmann <debian@helgefjell.de> erstellt.
Diese Übersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 oder neuer
bezüglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen.
Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an die
Mailingliste der Übersetzer: debian-l10n-german@lists.debian.org.
systemd 257.6 SYSTEMD-JOURNAL-GATEWAYD.SERVICE(8)