Log dan penyimpanan

Baca log

1. Buka Settings > Logs (pengaturan > log). Pemilik dan admin bisa melihatnya.
2. Pilih Level (tingkat): Every line (setiap baris), Warnings and errors (peringatan dan kesalahan) atau Errors only (hanya kesalahan).
3. Ketik di Text (teks) untuk menyisakan baris yang memuat kata itu. Huruf besar atau kecil tidak berpengaruh.
4. Isi From (dari) dan To (sampai) untuk membatasi harinya; To ikut dihitung. Klik Apply (terapkan).
5. Pindah halaman dengan Newer (lebih baru) dan Older (lebih lama), 100 baris sekali tampil, yang terbaru di atas. Kamu akan melihat baris yang cocok saja.

Bagikan log

1. Di Settings > Logs, klik Download (unduh). Kamu mendapat baris terbaru, sampai 2 MB, sebagai file teks.
2. Lampirkan di tempat kamu meminta bantuan. Lihat Minta dukungan.

Kunci, token, dan kata sandi sudah disamarkan sebagai [hidden]. Tetap baca filenya sekali sebelum diposting: nama judul, folder, dan alamat server kamu tetap terlihat.

Tempat file disimpan

Settings > This app > Storage (pengaturan > aplikasi ini > penyimpanan) menampilkan setiap path seperti yang dilihat HolyArrs, beserta ruang kosong di disknya. Di Docker, ini adalah path di dalam container.

Path	Isinya
Folder konfigurasi	Semua data HolyArrs
holyarrs.db	Database utama
holyarrs-events.db	Database riwayat
Folder backup, artwork, log	Di dalam folder konfigurasi
Folder pustaka, folder simpan downloader	Media dan unduhan kamu

“free space unknown” berarti sistem tidak memberi tahu.

File lognya adalah logs/holyarrs.log di folder konfigurasi. Saat mencapai 5 MB, file itu dipindah ke logs/holyarrs.log.1, jadi log tetap sekitar 10 MB. docker logs holyarrs menampilkan keluaran yang sama.

Kalau tidak berhasil

Gejala: halaman Logs tidak ada. Penyebab: hanya pemilik dan admin yang bisa melihatnya. Solusi: minta salah satu dari mereka.

Gejala: sebuah path terlihat salah. Penyebab: di Docker, Storage menampilkan path container. Solusi: bandingkan dengan pemetaan volume kamu. Lihat Folder.

Untuk yang mahir

Cara tingkat log ditebak

Tingkatnya ditentukan dari kata-kata di baris itu. “failed”, “crashed”, dan “error” menandai kesalahan. “could not”, “refused”, dan “timed out” menandai peringatan.

Apa yang disamarkan

Setiap baris disamarkan saat ditulis, dan lagi saat dibaca atau diunduh:

• Semua kunci, token, kata sandi, dan tautan webhook yang tersimpan, termasuk bentuk yang di-escape di tautan dan bentuk base64.
• Nilai lama. Saat sebuah rahasia diubah atau dihapus, kedua file log ditulis ulang dengan rahasia itu disamarkan sebelum nilai lamanya dibuang.
• Nama dan kata sandi di tautan: http://user:pass@host menjadi http://[hidden]@host.
• Parameter tautan seperti apikey=, token=, passkey=, password=.
• Pasangan dengan nama rahasia: kunci API, token, kata sandi, secret, cookie, authorization, kode penyiapan. Nilai yang diapit tanda kutip disamarkan sampai tanda kutip penutup.
• Token bearer dan basic, kunci API HolyArrs (hak_...), kode penyiapan pertama kali dijalankan, dan string panjang yang mirip token.

Pemisah baris dan kode warna terminal di dalam nilai ditampilkan dalam bentuk escape, jadi sebuah nilai tidak bisa memalsukan baris baru. Nilai tersimpan sepanjang 4 atau 5 karakter hanya disamarkan sebagai kata utuh, dan tidak pernah kalau berupa kata umum seperti admin atau test.

API

Rute	Siapa	Fungsi
GET /api/v1/app/storage	Change settings	Path beserta ruang kosong
GET /api/v1/logs?level=&q=&from=&to=&offset=&limit=	Pemilik, admin	Baris dan totalnya
GET /api/v1/logs/download	Pemilik, admin	2 MB terbaru sebagai teks biasa

Kunci API butuh scope admin untuk ketiganya.

Terkait

• Minta dukungan
• Pemeriksaan kondisi
• Backup