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
/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.
--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.
--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.
--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.
-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).
-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.
--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).
-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: /browseInteraktives Browsen.
/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.
/machine
Liefert eine die Maschine beschreibende
JSON-Struktur zurück.
Beispiel:
/fields/ FELDNAME
{ "machine_id" : "8cf7ed9d451ea194b77a9f118f3dc446",
"boot_id" : "3d3c9efaf556496a9b04259ee35df7f7",
"hostname" : "fedora",
"os_pretty_name" : "Fedora 19 (Rawhide)",
"virtualization" : "kvm",
…}
Liefert eine in den Protokollen vorhandende
Liste von Werte dieses Feldes zurück.
ACCEPT-KOPFZEILEN
Accept: Format Erkannte Formate: text/plainDie Vorgabe. Syslog-artige Ausgabe im
Klartext, eine Zeile pro Journal-Eintrag (wie journalctl --output
short).
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.
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).
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.
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 standardmäßig alle Ereignisse.URL GET-PARAMETER
Die folgenden Parameter können als Teil der URL verwandt werden: followWartet auf neue Ereignisse (wie journalctl
--follow, außer dass die Anzahl der zurückgelieferten
Ereignisse nicht begrenzt wird).
discrete
Prüft, ob sich die festgelegte Position
auf einen Eintrag im Journal bezieht. Liefert nur diesen Eintrag
zurück.
boot
Begrenzt Ereignisse auf den derzeitigen
Systemstart (wie journalctl -b).
KEY=Treffer
Überprüft auf Journal-Felder.
Siehe systemd.journal-fields(7).
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'
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
- 2.
- Server-gesandte Ereignisse
- 3.
- Journal-Exportformat
ÜBERSETZUNG
Die deutsche Übersetzung dieser Handbuchseite wurde von Helge Kreutzmann <[email protected]> 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| systemd 252 |