Lokit ja tallennustila

Lue loki

1. Avaa Settings > Logs (asetukset > lokit). Omistaja ja ylläpitäjät näkevät sen.
2. Valitse Level (taso): Every line (kaikki rivit), Warnings and errors (varoitukset ja virheet) tai Errors only (vain virheet).
3. Kirjoita kenttään Text (teksti), niin näet vain rivit, joilla on nämä sanat. Isoilla ja pienillä kirjaimilla ei ole väliä.
4. Rajaa päiviä kentillä From (alkaen) ja To (asti); To on mukana. Napsauta Apply (käytä).
5. Selaa painikkeilla Newer (uudemmat) ja Older (vanhemmat), 100 riviä kerrallaan, uusin ensin. Näet vain täsmäävät rivit.

Jaa loki

1. Napsauta sivulla Settings > Logs kohtaa Download. Saat uusimmat rivit, enintään 2 Mt, tekstitiedostona.
2. Liitä se sinne, mistä pyydät apua. Katso Tuen saanti.

Avaimet, tokenit ja salasanat on jo peitetty merkinnällä [hidden]. Lue tiedosto silti kerran läpi ennen julkaisua: nimikkeiden ja kansioiden nimet sekä palvelimesi osoite näkyvät.

Missä tiedostot ovat

Sivu Settings > This app > Storage (asetukset > tämä sovellus > tallennustila) listaa jokaisen polun sellaisena kuin HolyArrs sen näkee, ja sen levyn vapaan tilan. Dockerissa nämä ovat containerin sisäisiä polkuja.

Polku	Sisältö
Asetuskansio	Kaikki HolyArrsin tiedot
holyarrs.db	Päätietokanta
holyarrs-events.db	Historiatietokanta
Varmuuskopioiden, kuvituksen ja lokien kansiot	Asetuskansion sisällä
Kirjastokansiot, latausohjelman tallennuskansio	Mediasi ja lataukset

“free space unknown” tarkoittaa, ettei järjestelmä kertonut sitä.

Lokitiedosto on logs/holyarrs.log asetuskansiossa. 5 Mt:n kohdalla se siirtyy tiedostoon logs/holyarrs.log.1, joten lokit pysyvät noin 10 Mt:ssa. Komento docker logs holyarrs näyttää saman tulosteen.

Jos se ei toimi

Oire: Logs-sivu puuttuu. Syy: vain omistaja ja ylläpitäjät näkevät sen. Ratkaisu: pyydä jotakuta heistä.

Oire: polku näyttää väärältä. Syy: Dockerissa Storage näyttää containerin polut. Ratkaisu: vertaa volume-liitoksiisi. Katso Kansiot.

Asiantuntijoille

Kuinka tasot arvataan

Taso päätellään rivin sanoista. “failed”, “crashed” ja “error” merkitsevät virheitä. “could not”, “refused” ja “timed out” merkitsevät varoituksia.

Mitä peitetään

Jokainen rivi peitetään kirjoitettaessa ja uudelleen luettaessa tai ladattaessa:

• Jokainen tallennettu avain, token, salasana ja webhook-linkki, myös linkkimuotoon koodatut ja base64-muotoiset.
• Vanhat arvot. Kun salaisuus muuttuu tai poistetaan, molemmat lokitiedostot kirjoitetaan uudelleen sen ollessa peitettynä, ennen kuin vanha arvo hylätään.
• Linkkien käyttäjätunnukset ja salasanat: http://user:pass@host muuttuu muotoon http://[hidden]@host.
• Linkkien parametrit, kuten apikey=, token=, passkey=, password=.
• Salaisuuden nimen sisältävät parit: API key, token, password, secret, cookie, authorization, setup code. Lainausmerkeissä olevat arvot peitetään loppulainausmerkkiin asti.
• Bearer- ja basic-tokenit, HolyArrsin API-avaimet (hak_...), ensimmäisen käynnistyksen setup code ja pitkät token-näköiset merkkijonot.

Rivinvaihdot ja päätteen värikoodit arvojen sisällä näytetään erikseen merkittyinä, joten arvolla ei voi väärentää uutta riviä. Tallennetut 4 tai 5 merkin arvot peitetään vain kokonaisena sanana, eikä koskaan silloin, kun ne ovat yleisiä sanoja kuten admin tai test.

API

Reitti	Kuka	Mitä
GET /api/v1/app/storage	Change settings	Polut ja vapaa tila
GET /api/v1/logs?level=&q=&from=&to=&offset=&limit=	Omistaja, ylläpitäjät	Rivit ja kokonaismäärä
GET /api/v1/logs/download	Omistaja, ylläpitäjät	Uusimmat 2 Mt pelkkänä tekstinä

API-avaimet tarvitsevat admin-oikeuden kaikkiin kolmeen.

Aiheesta lisää

• Tuen saanti
• Kuntotarkistukset
• Varmuuskopiot