Log ir saugykla

Log skaitymas

1. Atidaryk Settings > Logs (nustatymai > log). Jį mato savininkas ir administratoriai.
2. Pasirink Level (lygis): Every line (kiekviena eilutė), Warnings and errors (įspėjimai ir klaidos) arba Errors only (tik klaidos).
3. Į Text (tekstas) įvesk žodžius, kad liktų tik eilutės su jais. Didžiosios ir mažosios raidės nesvarbios.
4. Nustatyk From (nuo) ir To (iki), kad apribotum dienas; To įskaitoma. Paspausk Apply (taikyti).
5. Naršyk su Newer (naujesni) ir Older (senesni) po 100 eilučių, naujausios pirmos. Turėtum pamatyti tik atitinkančias eilutes.

Log pasidalinimas

1. Puslapyje Settings > Logs paspausk Download (atsisiųsti). Gausi naujausias eilutes, iki 2 MB, kaip tekstinį failą.
2. Prisegk jį ten, kur prašai pagalbos. Žr. Gauk pagalbos.

Raktai, tokenai ir slaptažodžiai jau paslėpti kaip [hidden]. Vis tiek kartą perskaityk failą prieš paskelbiant: pavadinimai, aplankų vardai ir tavo serverio adresas lieka matomi.

Kur laikomi failai

Settings > This app > Storage (nustatymai > ši programa > saugykla) išvardija kiekvieną kelią taip, kaip jį mato HolyArrs, su laisva vieta jo diske. Docker aplinkoje tai keliai konteinerio viduje.

Kelias	Ką laiko
Konfigūracijos aplankas	Visi HolyArrs duomenys
holyarrs.db	Pagrindinė duomenų bazė
holyarrs-events.db	Istorijos duomenų bazė
Backup, iliustracijų ir log aplankai	Konfigūracijos aplanko viduje
Bibliotekos aplankai, atsisiuntimo programos išsaugojimo aplankas	Tavo medija ir atsisiuntimai

„free space unknown“ reiškia, kad sistema neatsakė.

Log failas yra logs/holyarrs.log konfigūracijos aplanke. Pasiekęs 5 MB, jis perkeliamas į logs/holyarrs.log.1, todėl log užima apie 10 MB. docker logs holyarrs rodo tą patį išvestį.

Jei neveikia

Požymis: nėra Logs puslapio. Priežastis: jį mato tik savininkas ir administratoriai. Sprendimas: paprašyk vieno iš jų.

Požymis: kelias atrodo neteisingas. Priežastis: Docker Storage rodo konteinerio kelius. Sprendimas: palygink su savo volume susiejimais. Žr. Aplankai.

Pažengusiems

Kaip nustatomi lygiai

Lygis nustatomas pagal žodžius eilutėje. „failed“, „crashed“ ir „error“ žymi klaidas. „could not“, „refused“ ir „timed out“ žymi įspėjimus.

Kas paslepiama

Kiekviena eilutė paslepiama ją rašant, o paskui dar kartą ją skaitant ar atsisiunčiant:

• Kiekvienas išsaugotas raktas, tokenas, slaptažodis ir webhook nuoroda, taip pat nuorodoje užkoduotos ir base64 formos.
• Senos reikšmės. Kai paslaptis pasikeičia ar pašalinama, abu log failai perrašomi su paslėpta reikšme, prieš pašalinant senąją reikšmę.
• Vardai ir slaptažodžiai nuorodose: http://user:pass@host tampa http://[hidden]@host.
• Nuorodų parametrai, tokie kaip apikey=, token=, passkey=, password=.
• Poros su paslapties pavadinimu: API key, token, password, secret, cookie, authorization, setup code. Reikšmės kabutėse paslepiamos iki uždarančios kabutės.
• Bearer ir basic tokenai, HolyArrs API raktai (hak_...), pirmo paleidimo sąrankos kodas ir ilgos tokeną primenančios eilutės.

Eilučių lūžiai ir terminalo spalvų kodai reikšmių viduje rodomi užkoduoti, todėl reikšmė negali suklastoti naujos eilutės. Išsaugotos 4 ar 5 simbolių reikšmės paslepiamos tik kaip visas žodis ir niekada, jei tai įprastas žodis, pavyzdžiui, admin ar test.

API

Maršrutas	Kas	Ką daro
GET /api/v1/app/storage	Change settings (keisti nustatymus)	Keliai su laisva vieta
GET /api/v1/logs?level=&q=&from=&to=&offset=&limit=	Savininkas, administratoriai	Eilutės ir bendras skaičius
GET /api/v1/logs/download	Savininkas, administratoriai	Naujausi 2 MB kaip paprastas tekstas

Visiems trims API raktams reikia administratoriaus apimties.

Susiję puslapiai

• Gauk pagalbos
• Būklės patikros
• Backup