Logid ja ruum

Loe logi

1. Ava Settings > Logs (seaded > logid). Omanik ja adminid näevad seda.
2. Vali Level (tase): Every line (iga rida), Warnings and errors (hoiatused ja vead) või Errors only (ainult vead).
3. Sisesta väljale Text (tekst), et hoida read nende sõnadega. Suur- ja väiketäht ei loe.
4. Määra From (alates) ja To (kuni), et piirata päevi; To on kaasa arvatud. Vajuta Apply (rakenda).
5. Lehitse nuppudega Newer (uuemad) ja Older (vanemad), 100 rida korraga, uusimad enne. Näed ainult sobivaid ridu.

Jaga logi

1. Vajuta lehel Settings > Logs nuppu Download (laadi alla). Saad uusimad read, kuni 2 MB, tekstifailina.
2. Lisa see sinna, kus abi küsid. Vaata Abi saamine.

Võtmed, tokenid ja paroolid on juba maskeeritud kujule [hidden]. Loe fail enne postitamist siiski üks kord läbi: pealkirjade nimed, kaustade nimed ja sinu serveri aadress jäävad nähtavaks.

Kus failid asuvad

Settings > This app > Storage (seaded > see rakendus > ruum) loetleb iga tee nii, nagu HolyArrs seda näeb, koos selle ketta vaba ruumiga. Dockeris on need teed konteineri sees.

Tee	Sisaldab
Seadete kaust	Kõik HolyArrsi andmed
holyarrs.db	Põhiandmebaas
holyarrs-events.db	Ajaloo andmebaas
Varukoopiate, kaanepiltide ja logide kaustad	Seadete kausta sees
Meediakogu kaustad, allalaadija salvestuskaust	Sinu meedia ja allalaadimised

„free space unknown“ tähendab, et süsteem ei öelnud.

Logifail on logs/holyarrs.log seadete kaustas. 5 MB juures liigub see faili logs/holyarrs.log.1, nii et logid püsivad umbes 10 MB juures. docker logs holyarrs näitab sama väljundit.

Kui see ei tööta

Sümptom: logide lehte pole. Põhjus: seda näevad ainult omanik ja adminid. Lahendus: palu üht neist.

Sümptom: tee tundub vale. Põhjus: Dockeris näitab Storage konteineri teid. Lahendus: võrdle oma volume’ite vastendustega. Vaata Kaustad.

Asjatundjale

Kuidas tasemeid ära arvatakse

Tase tuleb rea sõnadest. „failed“, „crashed“ ja „error“ märgivad vigu. „could not“, „refused“ ja „timed out“ märgivad hoiatusi.

Mida maskeeritakse

Iga rida maskeeritakse kirjutamisel ning uuesti lugemisel või allalaadimisel:

• Iga salvestatud võti, token, parool ja webhooki link, ka lingis escape’itud ja base64 kujul.
• Vanad väärtused. Kui saladus muutub või eemaldatakse, kirjutatakse mõlemad logifailid maskeeritult ümber enne, kui vana väärtus kustutatakse.
• Nimed ja paroolid linkides: http://user:pass@host muutub kujuks http://[hidden]@host.
• Lingi parameetrid nagu apikey=, token=, passkey=, password=.
• Paarid saladuse nimega: API key, token, password, secret, cookie, authorization, setup code. Jutumärkides väärtused maskeeritakse kuni sulgeva jutumärgini.
• Bearer- ja basic-tokenid, HolyArrsi API-võtmed (hak_...), esimese käivituse seadistuskood ja pikad tokeni moodi stringid.

Reavahetused ja terminali värvikoodid väärtuste sees näidatakse escape’itult, nii et väärtus ei saa võltsida uut rida. Salvestatud 4- või 5-märgilisi väärtusi maskeeritakse ainult terve sõnana ja mitte kunagi siis, kui need on tavaline sõna nagu admin või test.

API

Marsruut	Kes	Mida
GET /api/v1/app/storage	Change settings (seadete muutmine)	Teed vaba ruumiga
GET /api/v1/logs?level=&q=&from=&to=&offset=&limit=	Omanik, adminid	Read ja kogusumma
GET /api/v1/logs/download	Omanik, adminid	Uusimad 2 MB lihttekstina

API-võtmed vajavad kõigi kolme jaoks admin-ulatust.

Seotud lehed

• Abi saamine
• Tervisekontrollid
• Varukoopiad