Günlükler ve depolama

Günlüğü oku

1. Settings > Logs’u (Ayarlar > Günlükler) aç. Sahip ve yöneticiler görür.
2. Bir Level (düzey) seç: Every line (her satır), Warnings and errors (uyarılar ve hatalar) ya da Errors only (yalnızca hatalar).
3. O kelimelerin geçtiği satırları tutmak için Text’e (metin) yaz. Büyük küçük harf fark etmez.
4. Günleri sınırlamak için From (başlangıç) ve To (bitiş) değerlerini ayarla; To dahildir. Apply’a (uygula) bas.
5. Newer (daha yeni) ve Older (daha eski) ile sayfa değiştir; her sayfada 100 satır, en yeni en üstte. Yalnızca eşleşen satırları görmelisin.

Günlüğü paylaş

1. Settings > Logs sayfasında Download’a (indir) bas. En yeni satırları, en fazla 2 MB, metin dosyası olarak alırsın.
2. Dosyayı yardım istediğin yere ekle. Bkz. Destek al.

Anahtarlar, token’lar ve parolalar zaten [hidden] olarak gizlenir. Yine de paylaşmadan önce dosyayı bir kez oku: başlık adları, klasörler ve sunucu adresin görünür kalır.

Dosyalar nerede duruyor

Settings > This app > Storage (Ayarlar > Bu uygulama > Depolama), her yolu HolyArrs’ın gördüğü haliyle ve diskindeki boş alanla listeler. Docker’da bunlar konteynerin içindeki yollardır.

Yol	Ne tutar
Yapılandırma klasörü	Tüm HolyArrs verisi
holyarrs.db	Ana veritabanı
holyarrs-events.db	Geçmiş veritabanı
Yedek, kapak görseli ve günlük klasörleri	Yapılandırma klasörünün içinde
Kütüphane klasörleri, indiricinin kayıt klasörü	Medyan ve indirmelerin

“free space unknown” (boş alan bilinmiyor), sistemin söylemediği anlamına gelir.

Günlük dosyası, yapılandırma klasöründeki logs/holyarrs.log dosyasıdır. 5 MB olunca logs/holyarrs.log.1 dosyasına taşınır, böylece günlükler 10 MB civarında kalır. docker logs holyarrs aynı çıktıyı gösterir.

Çalışmazsa

Belirti: Günlükler sayfası yok. Neden: yalnızca sahip ve yöneticiler görür. Çözüm: onlardan birine sor.

Belirti: bir yol yanlış görünüyor. Neden: Docker’da Storage konteyner yollarını gösterir. Çözüm: birim eşlemelerinle karşılaştır. Bkz. Klasörler.

Uzmanlar için

Düzeyler nasıl tahmin edilir

Düzey, satırdaki kelimelerden çıkarılır. “failed”, “crashed” ve “error” hata sayılır. “could not”, “refused” ve “timed out” uyarı sayılır.

Neler gizlenir

Her satır yazılırken ve okunurken ya da indirilirken yeniden gizlenir:

• Kayıtlı her anahtar, token, parola ve webhook bağlantısı; bağlantı için kaçışlanmış ve base64 biçimleri de.
• Eski değerler. Bir gizli değer değişince ya da silinince, eski değer atılmadan önce iki günlük dosyası da o değer gizlenerek yeniden yazılır.
• Bağlantılardaki adlar ve parolalar: http://user:pass@host olur http://[hidden]@host.
• apikey=, token=, passkey=, password= gibi bağlantı parametreleri.
• Adı gizli bir değeri belirten çiftler: API key, token, password, secret, cookie, authorization, setup code. Tırnak içindeki değerler kapanış tırnağına kadar gizlenir.
• Bearer ve basic token’lar, HolyArrs API anahtarları (hak_...), ilk açılış kurulum kodu ve uzun token benzeri diziler.

Değerlerin içindeki satır sonları ve terminal renk kodları kaçışlanmış gösterilir, bu yüzden bir değer sahte yeni satır oluşturamaz. 4 ya da 5 karakterlik kayıtlı değerler yalnızca tam kelime olarak gizlenir; admin ya da test gibi yaygın kelimeler hiç gizlenmez.

API

Rota	Kim	Ne
GET /api/v1/app/storage	Change settings (ayarları değiştir)	Boş alanlı yollar
GET /api/v1/logs?level=&q=&from=&to=&offset=&limit=	Sahip, yöneticiler	Satırlar ve toplam
GET /api/v1/logs/download	Sahip, yöneticiler	En yeni 2 MB düz metin olarak

Üçü için de API anahtarının admin kapsamı olmalı.

İlgili

• Destek al
• Sağlık denetimleri
• Yedekler