Logs und Speicherorte

Einrichtung

Das Log lesen

Öffne Settings > Logs (Einstellungen > Logs). Der Besitzer und die Admins sehen die Seite.
Wähle ein Level (Stufe): Every line (jede Zeile), Warnings and errors (Warnungen und Fehler) oder Errors only (nur Fehler).
Gib bei Text Wörter ein, um nur Zeilen mit diesen Wörtern zu behalten. Groß- und Kleinschreibung spielt keine Rolle.
Lege mit From (von) und To (bis) die Tage fest; der Tag bei To zählt mit. Klicke auf Apply (Anwenden).
Blättere mit Newer (neuer) und Older (älter), je 100 Zeilen, die neuesten zuerst. Du solltest nur passende Zeilen sehen.

Das Log weitergeben

Klicke unter Settings > Logs auf Download (Herunterladen). Du bekommst die neuesten Zeilen, bis zu 2 MB, als Textdatei.
Hänge sie dort an, wo du um Hilfe bittest. Siehe Support erhalten.

Schlüssel, Token und Passwörter sind schon als [hidden] maskiert. Lies die Datei trotzdem einmal durch, bevor du sie postest: Namen von Titeln und Ordnern und die Adresse deines Servers bleiben sichtbar.

Wo die Dateien liegen

Settings > This app > Storage (Einstellungen > Diese App > Speicherorte) listet jeden Pfad so auf, wie HolyArrs ihn sieht, mit dem freien Speicherplatz auf seinem Datenträger. In Docker sind das Pfade im Container.

Pfad	Enthält
Konfigurationsordner	Alle Daten von HolyArrs
`holyarrs.db`	Hauptdatenbank
`holyarrs-events.db`	Verlaufsdatenbank
Ordner für Backups, Bilder und Logs	Im Konfigurationsordner
Bibliotheksordner, Speicherordner des Downloaders	Deine Medien und Downloads

„free space unknown“ (freier Speicherplatz unbekannt) heißt, dass das System keinen Wert geliefert hat.

Die Log-Datei ist logs/holyarrs.log im Konfigurationsordner. Bei 5 MB wandert sie nach logs/holyarrs.log.1, so bleiben die Logs bei rund 10 MB. docker logs holyarrs zeigt dieselbe Ausgabe.

Wenn es nicht funktioniert

Symptom: Die Seite Logs fehlt. Ursache: Nur der Besitzer und die Admins sehen sie. Lösung: Frag einen von ihnen.

Symptom: Ein Pfad sieht falsch aus. Ursache: In Docker zeigt Storage die Pfade im Container. Lösung: Vergleiche sie mit deinen Volume-Zuordnungen. Siehe Ordner.

Für Fortgeschrittene

Wie die Stufen erkannt werden

Die Stufe ergibt sich aus Wörtern in der Zeile. „failed“, „crashed“ und „error“ kennzeichnen Fehler. „could not“, „refused“ und „timed out“ kennzeichnen Warnungen.

Was maskiert wird

Jede Zeile wird beim Schreiben maskiert und noch einmal beim Lesen oder Herunterladen:

Jeder gespeicherte Schlüssel, jedes Token, jedes Passwort und jeder Webhook-Link, auch in link-kodierter und in base64-Form.
Alte Werte. Wenn ein Geheimnis geändert oder entfernt wird, werden beide Log-Dateien neu geschrieben und der Wert darin maskiert, bevor der alte Wert verworfen wird.
Namen und Passwörter in Links: Aus http://user:pass@host wird http://[hidden]@host.
Link-Parameter wie apikey=, token=, passkey=, password=.
Paare mit dem Namen eines Geheimnisses: API key, token, password, secret, cookie, authorization, setup code. Werte in Anführungszeichen werden bis zum schließenden Anführungszeichen maskiert.
Bearer- und Basic-Token, API-Schlüssel von HolyArrs (hak_...), der Einrichtungscode vom ersten Start und lange Zeichenfolgen, die wie ein Token aussehen.

Zeilenumbrüche und Farbcodes des Terminals in Werten werden escaped dargestellt, damit ein Wert keine neue Zeile vortäuschen kann. Gespeicherte Werte mit 4 oder 5 Zeichen werden nur als ganzes Wort maskiert, und nie, wenn sie ein gängiges Wort wie admin oder test sind.

API

Route	Wer	Was
`GET /api/v1/app/storage`	Change settings (Einstellungen ändern)	Pfade mit freiem Speicherplatz
`GET /api/v1/logs?level=&q=&from=&to=&offset=&limit=`	Besitzer, Admins	Zeilen und eine Gesamtzahl
`GET /api/v1/logs/download`	Besitzer, Admins	Die neuesten 2 MB als reiner Text

API-Schlüssel brauchen für alle drei den Scope admin.