JOURNAL-UPLOAD.CONF(5)

BEZEICHNUNG
journal-upload.conf, journal-upload.conf.d - Konfigurationsdateien für den Journal-Hochladedienst

ÜBERSICHT

/etc/systemd/journal-upload.conf

/run/systemd/journal-upload.conf

/usr/lib/systemd/journal-upload.conf

/etc/systemd/journal-upload.conf.d/*.conf

/run/systemd/journal-upload.conf.d/*.conf

/usr/lib/systemd/journal-upload.conf.d/*.conf

BESCHREIBUNG

Diese Dateien konfigurieren verschiedene Parameter von systemd-journal-upload.service(8). Siehe systemd.syntax(7) für eine allgemeine Beschreibung der Syntax.

KONFIGURATIONSVERZEICHNISSE UND RANGFOLGE

Die Standardkonfiguration wird während der Kompilierung gesetzt. Daher wird eine Konfiguration nur benötigt, wenn von diesen Vorgaben abgewichen werden muss. Die Hauptkonfigurationsdatei wird aus einem der aufgeführten Verzeichnisse in der Prioritätsreihenfolge geladen; nur die zuerst gefundene Datei wird verwandt: /etc/systemd/, /run/systemd/, /usr/local/lib/systemd/ [1], /usr/lib/systemd/. Die Lieferantenversion der Datei enthält die Vorgaben als auskommentierte Hinweise für den Administrator. Lokal können diese Einstellungen durch die Erstellung von Ergänzungen, wie nachfolgend beschrieben, außer Kraft gesetzt werden. Zu diesem Zweck kann die Hauptkonfigurationsdatei (oder eine Kopie in /etc/, falls sie in /usr/ ausgeliefert wird) auch bearbeitet werden, allerdings wird empfohlen, Ergänzungen für die lokale Konfiguration zu verwenden, statt die Hauptkonfigurationsdatei zu verändern.

Zusätzlich zu der Hauptkonfigurationsdatei werden Ergänzungs-Konfigurationsschnipsel aus /usr/lib/systemd/*.conf.d/, /usr/local/lib/systemd/*.conf.d/ und /etc/systemd/*.conf.d/ gelesen. Diese Ergänzungen haben Vorrang vor der Hauptkonfigurationsdatei und setzen diese außer Kraft. Dateien in den Konfigurationsunterverzeichnissen *.conf.d/ werden in lexikographischer Reihenfolge nach ihrem Dateinamen sortiert, unabhängig davon, in welchem Unterverzeichnis sie sich befinden. Bei Optionen, die nur einen einzelnen Wert akzeptieren, hat der Eintrag in der Datei, die als letztes in der Sortierung folgt, Vorrang, falls mehrere Dateien die gleiche Option angeben. Bei Optionen, die eine Liste von Werten akzeptieren, werden Einträge gesammelt, wie sie in den sortierten Dateien auftauchen.

Wenn Pakete die Konfiguration anpassen müssen, können sie Ergänzungen unter /usr/ installieren. Dateien in /etc/ sind für den lokalen Administrator reserviert, der diese Logik verwenden kann, um die durch die Lieferantenpakete bereitgestellten Konfigurationsdateien außer Kraft zu setzen. Um Ergänzungen der Pakete außer Kraft zu setzen, müssen Ergänzungen verwandt werden, da die Hauptkonfigurationsdatei die niedrigste Priorität hat. Es wird empfohlen, allen Dateinamen in diesen Unterverzeichnissen eine zweistellige Zahl und einen Bindestrich voranzustellen, um die Sortierung zu vereinfachen. Dies definiert auch ein Konzept von Ergänzungsprioritäten, um es Betriebssystemlieferanten zu ermöglichen, Ergänzungen in einem bestimmten Bereich auszuliefern, der unterhalb des von Benutzern verwandten Bereichs liegt. Dies sollte das Risiko reduzieren, dass eine Paketergänzung versehentlich durch Benutzer definierte Ergänzungen außer Kraft setzt. Es wird empfohlen, den Bereich 10-40 für Ergänzungen in /usr/ und den Bereich 60-90 für Ergänzungen in /etc/ und /run/ zu verwenden um sicherzustellen, dass lokale und flüchtige Ergänzungen Priorität gegenüber Ergänzungen haben, die vom Betriebssystemlieferanten geliefert werden.

Um eine vom Lieferanten bereitgestellte Konfigurationsdatei zu deaktivieren, wird empfohlen, einen Symlink nach /dev/null in dem Konfigurationsverzeichnis in /etc/ mit dem gleichen Dateinamen wie die Konfigurationsdatei des Lieferanten abzulegen.

OPTIONEN

Alle Optionen werden im Abschnitt »[Upload]« konfiguriert:

URL=
    Die URL, zu der die Journal-Einträge hochgeladen werden sollen. Lesen Sie die Darstellung der Option --url= in systemd-journal-upload(8) für eine Beschreibung der möglichen Werte. Es gibt keinen Vorgabewert, daher muss entweder diese Option oder die Befehlszeilenoption immer vorhanden sein, um das Hochladen durchzuführen.

    Hinzugefügt in Version 232.

ServerKeyFile=
    SSL-Schlüssel im PEM-Format.

    Hinzugefügt in Version 232.

ServerCertificateFile=
    SSL-CA-Zertifikat im PEM-Format.

    Hinzugefügt in Version 232.

TrustedCertificateFile=
    SSL-CA-Zertifikat.

    Hinzugefügt in Version 232.

NetworkTimeoutSec=
    Wenn eine Netzwerkverbindung zu dem Server verloren ging, konfiguriert diese Option die Zeit, die auf die Wiederherstellung der Verbindung gewartet wird. Wenn der Server für die konfigurierte Zeit über das Netzwerk nicht erreichbar ist, beendet sich systemd-journal-upload. Akzeptiert einen Wert in Sekunden (oder in anderen Zeiteinheiten, falls »ms«, »min«, »h« usw. angehängt wird). Für Details, siehe systemd.time(7).

    Hinzugefügt in Version 249.

Compression=
    Konfiguriert Komprimierungsalgorithmen, die vor dem Versenden von Protokolldaten angewandt werden sollen. Akzeptiert eine durch Leerzeichen getrennte Liste von Komprimierungsalgorithmen oder »no«. Unterstützte Algorithmen sind »zstd«, »xz« und »lz4«. Optional kann an jeden Algorithmus ein Doppelpunkt (»:«) und seine Komprimierungsstufe angehängt werden, beispielsweise »zstd:4«. Die Komprimierungsstufe wird als positive Ganzzahl erwartet. Wird »no« angegeben, wird auf die zu sendenden Daten kein Komprimierungsalgorithmus angewandt. Diese Option kann mehrfach angegeben werden. Wird eine leere Zeichenkette zugewiesen, dann werden alle vorhergehenden Zuweisungen zurückgesetzt. Standardmäßig nicht gesetzt und alle unterstützten Kompressionsalgorithmen mit ihren Standardstufen werden aufgelistet.

    Beispiel:

        Compression=zstd:4 lz4:2

    Selbst wenn die Komprimierung aktiviert ist, werden die anfänglichen Anfragen ohne Komprimierung versandt. Sie wird wirksam, falls entweder »ForceCompression=« aktiviert ist oder die Antwort des Servers die Kopfzeile »Accept-Encoding« mit einer Liste der Komprimierungsalgorithmen enthält, die eine der in dieser Option festgelegten Algorithmen enthält.

    Hinzugefügt in Version 258.

ForceCompression=
    Akzeptiert einen logischen Wert und erzwingt die Verwendung von Komprimierung, ohne Inhaltsaushandlung. Standardmäßig »false«.

    Hinzugefügt in Version 258.

Header=
    Legt eine zusätzliche HTTP-Kopfzeile fest, die bei jeder URL-Anfrage hinzugefügt wird. Akzeptiert ein Paar aus Kopfzeilenname und -wert, getrennt durch einen Doppelpunkt (»:«), z.B. »Name:Wert«. Kopfzeilennamen können alphanumerische Werte und zusätzlich die Symbole »_« und »-« enthalten. Diese Option kann mehr als einmal angegeben werden, dann werden alle aufgeführten Kopfzeilen gesetzt. Falls der gleiche Kopfzeilenname mehr als einmal aufgeführt ist, werden alle seine eindeutigen Werte, getrennt durch Kommata, aneinandergehängt. Wird Header= auf die leere Zeichenkette gesetzt, dann werden alle vorhergehenden Zuweisungen zurückgesetzt.

    Beispiel:

        Header=»Kopfzeilenname«: Kopfzeilenwert
        Header=»Kopfzeilenname«: Neuerwert
        Header=»Kopfzeilenname«: Kopfzeilenwert

    fügt die Kopfzeile »Kopfzeilenname« mit »Kopfzeilenwert, Neuerwert« zu jeder HTTP-Anfrage hinzu.

    Hinzugefügt in Version 258.

SIEHE AUCH

systemd-journal-upload.service(8), systemd(1), systemd-journald.service(8)

ANMERKUNGEN

1.  💣💥🧨💥💥💣 Bitte beachten Sie, dass diese Konfigurationsdateien zu allen Zeiten verfügbar sein müssen. Falls /usr/local/ eine separate Partition ist, könnte diese während des frühen Systemstarts nicht verfügbar sein und darf dann nicht für Konfiguration verwandt werden.

Ü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 (https://www.gnu.org/licenses/gpl-3.0.html) 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).