Αρχεία καταγραφής και αποθήκευση

Διάβασε το log

1. Άνοιξε το Settings > Logs (Ρυθμίσεις > Αρχείο καταγραφής). Το βλέπουν ο ιδιοκτήτης και οι διαχειριστές.
2. Διάλεξε ένα Level (επίπεδο): Every line (κάθε γραμμή), Warnings and errors (προειδοποιήσεις και σφάλματα) ή Errors only (μόνο σφάλματα).
3. Γράψε στο Text (κείμενο) για να κρατήσεις τις γραμμές με αυτές τις λέξεις. Τα κεφαλαία δεν έχουν σημασία.
4. Όρισε From (από) και To (έως) για να περιορίσεις τις μέρες· η μέρα To συμπεριλαμβάνεται. Πάτησε Apply (εφαρμογή).
5. Γύρνα σελίδες με Newer (νεότερα) και Older (παλιότερα), 100 γραμμές τη φορά, με τις νεότερες πρώτες. Θα πρέπει να δεις μόνο τις γραμμές που ταιριάζουν.

Μοιράσου το log

1. Στο Settings > Logs, πάτησε Download (λήψη). Παίρνεις τις νεότερες γραμμές, έως 2 MB, ως αρχείο κειμένου.
2. Επισύναψέ το εκεί όπου ζητάς βοήθεια. Δες Βρες υποστήριξη.

Τα κλειδιά, τα tokens και οι κωδικοί πρόσβασης είναι ήδη κρυμμένα ως [hidden]. Διάβασε πάντως το αρχείο μία φορά πριν το αναρτήσεις: τα ονόματα τίτλων, φακέλων και η διεύθυνση του διακομιστή σου παραμένουν ορατά.

Πού μένουν τα αρχεία

Το Settings > This app > Storage (Ρυθμίσεις > Αυτή η εφαρμογή > Αποθήκευση) δείχνει κάθε διαδρομή όπως τη βλέπει το HolyArrs, με τον ελεύθερο χώρο του δίσκου της. Στο Docker αυτές είναι διαδρομές μέσα στο container.

Διαδρομή	Περιέχει
Φάκελος ρυθμίσεων	Όλα τα δεδομένα του HolyArrs
holyarrs.db	Κύρια βάση δεδομένων
holyarrs-events.db	Βάση δεδομένων του Ιστορικού
Φάκελοι αντιγράφων, εξωφύλλων και logs	Μέσα στον φάκελο ρυθμίσεων
Φάκελοι της Βιβλιοθήκης, φάκελος αποθήκευσης του προγράμματος λήψεων	Τα πολυμέσα και οι λήψεις σου

Το “free space unknown” (άγνωστος ελεύθερος χώρος) σημαίνει ότι το σύστημα δεν το είπε.

Το αρχείο του log είναι το logs/holyarrs.log στον φάκελο ρυθμίσεων. Στα 5 MB μετακινείται στο logs/holyarrs.log.1, οπότε τα logs μένουν κοντά στα 10 MB. Το docker logs holyarrs δείχνει την ίδια έξοδο.

Αν δεν δουλεύει

Σύμπτωμα: λείπει η σελίδα Logs. Αιτία: τη βλέπουν μόνο ο ιδιοκτήτης και οι διαχειριστές. Λύση: ζήτα το από έναν από αυτούς.

Σύμπτωμα: μια διαδρομή φαίνεται λάθος. Αιτία: στο Docker, το Storage δείχνει διαδρομές του container. Λύση: σύγκρινε με τις αντιστοιχίσεις των volumes σου. Δες Φάκελοι.

Για έμπειρους

Πώς μαντεύεται το επίπεδο

Το επίπεδο προκύπτει από λέξεις στη γραμμή. Τα “failed”, “crashed” και “error” σημαδεύουν σφάλματα. Τα “could not”, “refused” και “timed out” σημαδεύουν προειδοποιήσεις.

Τι κρύβεται

Κάθε γραμμή κρύβεται όταν γράφεται, και ξανά όταν διαβάζεται ή κατεβαίνει:

• Κάθε αποθηκευμένο κλειδί, token, κωδικός πρόσβασης και σύνδεσμος webhook, και σε μορφές με escape συνδέσμου και base64.
• Παλιές τιμές. Όταν ένα μυστικό αλλάζει ή αφαιρείται, και τα δύο αρχεία του log ξαναγράφονται με κρυμμένη την τιμή πριν πεταχτεί η παλιά.
• Ονόματα και κωδικοί σε συνδέσμους: το http://user:pass@host γίνεται http://[hidden]@host.
• Παράμετροι συνδέσμου όπως apikey=, token=, passkey=, password=.
• Ζευγάρια με όνομα μυστικού: API key, token, password, secret, cookie, authorization, setup code. Οι τιμές σε εισαγωγικά κρύβονται μέχρι το κλείσιμο των εισαγωγικών.
• Bearer και basic tokens, κλειδιά API του HolyArrs (hak_...), ο κωδικός ρύθμισης της πρώτης εκκίνησης και μεγάλες συμβολοσειρές που μοιάζουν με token.

Οι αλλαγές γραμμής και οι κωδικοί χρωμάτων του τερματικού μέσα σε τιμές εμφανίζονται με escape, ώστε μια τιμή να μην μπορεί να ψευτίσει νέα γραμμή. Οι αποθηκευμένες τιμές 4 ή 5 χαρακτήρων κρύβονται μόνο ως ολόκληρη λέξη, και ποτέ όταν είναι κοινή λέξη όπως admin ή test.

API

Route	Ποιος	Τι
GET /api/v1/app/storage	Change settings	Διαδρομές με ελεύθερο χώρο
GET /api/v1/logs?level=&q=&from=&to=&offset=&limit=	Ιδιοκτήτης, διαχειριστές	Γραμμές και σύνολο
GET /api/v1/logs/download	Ιδιοκτήτης, διαχειριστές	Τα νεότερα 2 MB ως απλό κείμενο

Τα κλειδιά API χρειάζονται το scope admin και για τα τρία.

Σχετικά

• Βρες υποστήριξη
• Έλεγχοι υγείας
• Αντίγραφα ασφαλείας