Rolle `journal_upload`
Quelle: pkr-lab/pkr-lab-docs/capulus/capulus-ansible/rollen/journal_upload.md
Rolle journal_upload
journald → VictoriaLogs.
| Läuft gegen | alle Ansible-Hosts |
| Tags | journal-upload, logging |
| Quellcode | roles/journal_upload |
Variablen
Defaults aus defaults/main.yml. Überschreiben in group_vars/ oder host_vars/.
| Variable | Default | Bedeutung |
|---|---|---|
journal_upload_enabled |
true |
– |
journal_upload_state_dir |
/var/lib/private/systemd/journal-upload |
– |
journal_upload_push_url |
https://logs-write.tech.homeserver:443/insert/journald |
– |
journal_upload_ca_src |
{{ playbook_dir }}/files/homeserver-root-ca.pem |
– |
journal_upload_ca_dest |
/usr/local/share/ca-certificates/homeserver-root-ca.crt |
– |
journal_upload_hosts_entry_enabled |
true |
– |
journal_upload_hosts_entry_name |
logs-write.tech.homeserver |
– |
journal_upload_hosts_entry_ip |
127.0.0.1 |
– |
journal_upload_basic_auth_user |
{{ vault_logs_write_auth_user \| default('') }} |
– |
journal_upload_basic_auth_password |
{{ vault_logs_write_auth_password \| default('') }} |
– |
journal_upload_credentials_group |
jupload-cred |
– |
Ablauf
- systemd-journal-remote installieren (liefert systemd-journal-upload)
- homeserver-root-ca verteilen (Rolle
homeserver_ca, tls-prüfung des log-endpunkts) - journal-upload nach einem ca-wechsel neu starten
- Log-Endpunkt per /etc/hosts auflösen (unabhängig von DNS)
- Drop-in-Verzeichnis für systemd-journal-upload anlegen
- Dauerhaften Neustart für systemd-journal-upload konfigurieren
- Gruppe für die Zugangsdaten des Log-Endpunkts anlegen
- Dienst für den Zugriff auf die Zugangsdaten berechtigen
- journal-upload.conf deployen
- Startpunkt für systemd-journal-upload setzen (kein Upload des Alt-Journals)
- State-Verzeichnis prüfen
- State-Datei prüfen
- Aktuellen Journal-Cursor ermitteln
- State-Verzeichnis anlegen
- State-Datei mit Startpunkt anlegen
- Handler sofort ausführen (Start-Limit zurücksetzen, bevor der Dienst gestartet wird)
- systemd-journal-upload aktivieren und starten
- systemd-journal-upload deaktivieren (journal_upload_enabled false)
Handler
- start-limit des dienstes zurücksetzen (nach endlos-fehlschlägen)
- systemd-journal-upload neu starten
Templates
journal-upload.conf.j2
Fehlersuche
Allgemeines Vorgehen bei Rollen: ansible-playbook <playbook>.yml --limit <host> --tags <tag> --check --diff -vvv zeigt Änderungen ohne sie anzuwenden (make <ziel>-check bei den Playbooks mit Dry-Run). Die Rollenübersicht mit Make-Zielen: Rollen.
sudo systemctl status systemd-journal-upload
sudo journalctl -u systemd-journal-upload -n 100 --no-pager
cat /etc/systemd/journal-upload.conf
getent hosts logs-write.tech.homeserver
sudo cat /var/lib/private/systemd/journal-upload/state
| Symptom | Ursache | Lösung |
|---|---|---|
Dienst failed mit Start-Limit |
zu viele Neustarts, Endpunkt nicht erreichbar | systemctl reset-failed systemd-journal-upload, Endpunkt und Zugangsdaten prüfen |
401 Unauthorized im Log |
Basic-Auth-Zugang logs-writer stimmt nicht (vault_logs_write_auth_*) |
Vault-Variablen und Secret logs-write-auth prüfen (Logging) |
TLS-Fehler (certificate verify failed) |
Root-CA fehlt (/usr/local/share/ca-certificates/homeserver-root-ca.crt) oder update-ca-certificates nicht gelaufen |
CA ablegen, sudo update-ca-certificates |
Name logs-write.tech.homeserver nicht auflösbar |
Hosts-Eintrag (journal_upload_hosts_entry_ip) zeigt auf falsche Adresse |
Eintrag in /etc/hosts prüfen |
| Alte Logs fehlen in Grafana | Startpunkt wird auf den aktuellen Cursor gesetzt, es wird kein Alt-Journal hochgeladen | gewollt |
| Dienst hat keinen Zugriff auf das Passwort | Gruppe jupload-cred und Dienstberechtigung |
Rolle erneut ausrollen |
Allgemeine Fehlersuche: Host-Troubleshooting, zentrale Fehlersuche.