SYSTEMD-JOURNAL-GATEWAYD.SERVICE(8) systemd-journal-gatewayd.service BEZEICHNUNG systemd-journal-gatewayd.service, systemd-journal-gatewayd.socket, systemd-journal-gatewayd - HTTP-Server fur Journal-Ereignisse UBERSICHT systemd-journal-gatewayd.service systemd-journal-gatewayd.socket /usr/lib/systemd/systemd-journal-gatewayd [OPTIONEN] BESCHREIBUNG systemd-journal-gatewayd bedient Journal-Ereignisse uber das Netzwerk. Clients mussen sich mit HTTP verbinden. Der Server wartet standardmassig 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. Hinzugefugt in Version 198. --key= Gibt den Pfad zu einer Datei oder einem AF_UNIX-Datenstrom-Socket an, woraus der Server-Geheimschlussel, der dem mit --cert= festgelegten Zertifikat entspricht, gelesen wird. Das Zertifikat muss im PEM-Format vorliegen. Hinzugefugt 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. Hinzugefugt in Version 236. --system, --user Begrenzt die ausgelieferten Eintrage auf Eintrage von Systemdiensten und dem Kernel oder auf Eintrage vom aktuellen Benutzer. Dies hat die gleiche Bedeutung wie die Optionen --system und --user fur journalctl(1). Falls keine davon festgelegt ist, dann werden alle zugreifbaren Eintrage ausgeliefert. Hinzugefugt in Version 249. -m, --merge Liefert Eintrage verschachtelt von allen verfugbaren Journals aus, einschliesslich anderer Maschinen. Dies hat die gleiche Bedeutung wie die Option --merge fur journalctl(1). Hinzugefugt 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. Hinzugefugt in Version 232. --file=GLOB Akzeptiert einen Datei-Glob als Argument. Liefert Eintrage 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= fur journalctl(1). Hinzugefugt in Version 249. -h, --help Zeigt einen kurzen Hilfetext an und beendet das Programm. --version Zeigt eine kurze Versionszeichenkette an und beendet das Programm. UNTERSTUTZTE URLS Die folgenden URLs werden erkannt: /browse Interaktives Browsen. Hinzugefugt in Version 197. /entries[?Option1&Option2=Wert] Abruf von Ereignissen in verschiedenen Formaten. Der Accept:-Anteil der HTTP-Kopfzeilen bestimmt das Format. Unterstutzte Werte werden nachfolgend beschrieben. Der Range:-Anteil der HTTP-Kopfzeilen bestimmt den Bereich der zuruckgelieferten Ereignisse. Unterstutzte Werte werden nachfolgend beschrieben. GET-Parameter konnen zur Veranderung der Auswahl der zuruckgelieferten Ereignisse verwandt werden. Unterstutzte Parameter werden nachfolgend beschrieben. Hinzugefugt in Version 197. /machine Liefert eine die Maschine beschreibende JSON-Struktur zuruck. Beispiel: { "machine_id" : "8cf7ed9d451ea194b77a9f118f3dc446", "boot_id" : "3d3c9efaf556496a9b04259ee35df7f7", "hostname" : "fedora", "os_pretty_name" : "Fedora 19 (Rawhide)", "virtualization" : "kvm", } Hinzugefugt in Version 197. /fields/FELDNAME Liefert eine in den Protokollen vorhandende Liste von Werte dieses Feldes zuruck. Hinzugefugt 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). Hinzugefugt in Version 197. application/json Eintrage werden als JSON-Datenstruktur formatiert, eine pro Zeile (wie journalctl --output json). Siehe Journal-JSON-Format[1] fur weitere Informationen. Hinzugefugt in Version 197. text/event-stream Eintrage werden als JSON-Datenstrukturen, eingehullt in einem fur Server-gesandte Ereignisse[2] geeigneten Format, formatiert (wie journalctl --output json-sse). Hinzugefugt in Version 229. application/vnd.fdo.journal Eintrage werden in einen binaren (aber primar textbasierten), fur Datensicherungen und Netzwerktransfer geeigneten Datenstrom serialisiert (wie journalctl --output export). Siehe Journal Exportformat[3] fur weitere Informationen. Hinzugefugt in Version 197. BEREICHSKOPFZEILEN Range: entries=Position[[:Ausl_Anz]:Eintrag_Anz] wobei Position eine Positionszeichenkette, Ausl_Anz eine Ganzzahl und Eintrag_Anz eine vorzeichenfreie Ganzzahl ist. Der Bereich umfasst standardmassig alle Ereignisse. URL GET-PARAMETER Die folgenden Parameter konnen als Teil der URL verwandt werden: follow Wartet auf neue Ereignisse (wie journalctl --follow, ausser dass die Anzahl der zuruckgelieferten Ereignisse nicht begrenzt wird). Hinzugefugt in Version 197. discrete Pruft, ob sich die festgelegte Position auf einen Eintrag im Journal bezieht. Liefert nur diesen Eintrag zuruck. Hinzugefugt in Version 197. boot Begrenzt Ereignisse auf den derzeitigen Systemstart (wie journalctl -b). Hinzugefugt in Version 197. KEY=Treffer Uberpruft auf Journal-Felder. Siehe systemd.journal-fields(7). Hinzugefugt 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 Speicherauszuge: 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 UBERSETZUNG Die deutsche Ubersetzung dieser Handbuchseite wurde von Helge Kreutzmann erstellt. Diese Ubersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 oder neuer bezuglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG ubernommen. Wenn Sie Fehler in der Ubersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an die Mailingliste der Ubersetzer . systemd 255 SYSTEMD-JOURNAL-GATEWAYD.SERVICE(8)