Log และที่เก็บไฟล์

อ่าน log

1. เปิด Settings > Logs (การตั้งค่า > Logs) เจ้าของและแอดมินเท่านั้นที่เห็น
2. เลือก Level (ระดับ): Every line (ทุกบรรทัด), Warnings and errors (คำเตือนและข้อผิดพลาด) หรือ Errors only (เฉพาะข้อผิดพลาด)
3. พิมพ์ใน Text (ข้อความ) เพื่อเก็บเฉพาะบรรทัดที่มีคำเหล่านั้น ไม่สนตัวพิมพ์เล็กใหญ่
4. ตั้ง From (จาก) และ To (ถึง) เพื่อจำกัดช่วงวัน To รวมวันนั้นด้วย กด Apply (ใช้)
5. เปลี่ยนหน้าด้วย Newer (ใหม่กว่า) และ Older (เก่ากว่า) หน้าละ 100 บรรทัด เรียงใหม่สุดก่อน จะเห็นเฉพาะบรรทัดที่ตรงเงื่อนไข

แชร์ log

1. ที่ Settings > Logs กด Download (ดาวน์โหลด) จะได้บรรทัดล่าสุดไม่เกิน 2 MB เป็นไฟล์ข้อความ
2. แนบไฟล์ในที่ที่คุณขอความช่วยเหลือ ดู ขอความช่วยเหลือ

คีย์ โทเค็น และรหัสผ่านถูกปิดเป็น [hidden] ให้แล้ว แต่ควรอ่านไฟล์อีกรอบก่อนโพสต์ ชื่อรายการ โฟลเดอร์ และที่อยู่เซิร์ฟเวอร์ของคุณยังมองเห็นอยู่

ไฟล์ถูกเก็บไว้ที่ไหน

Settings > This app > Storage (การตั้งค่า > แอปนี้ > ที่เก็บไฟล์) แสดงแต่ละพาธตามที่ HolyArrs มองเห็น พร้อมพื้นที่ว่างของดิสก์ ใน Docker พาธเหล่านี้คือพาธภายใน container

พาธ	เก็บอะไร
โฟลเดอร์คอนฟิก	ข้อมูลทั้งหมดของ HolyArrs
holyarrs.db	ฐานข้อมูลหลัก
holyarrs-events.db	ฐานข้อมูลประวัติ
โฟลเดอร์ Backup ภาพ และ log	อยู่ในโฟลเดอร์คอนฟิก
โฟลเดอร์คลัง โฟลเดอร์บันทึกของตัวดาวน์โหลด	สื่อและงานดาวน์โหลดของคุณ

“free space unknown” หมายถึงระบบไม่ได้บอกค่ามา

ไฟล์ log คือ logs/holyarrs.log ในโฟลเดอร์คอนฟิก เมื่อถึง 5 MB จะย้ายไปเป็น logs/holyarrs.log.1 ขนาด log จึงอยู่ราว 10 MB docker logs holyarrs แสดงผลเดียวกัน

ถ้าไม่ทำงาน

อาการ: ไม่เห็นหน้า Logs สาเหตุ: เฉพาะเจ้าของและแอดมินที่เห็น วิธีแก้: ขอให้คนใดคนหนึ่งช่วย

อาการ: พาธดูไม่ถูก สาเหตุ: ใน Docker หน้า Storage แสดงพาธของ container วิธีแก้: เทียบกับการแมป volume ของคุณ ดู โฟลเดอร์

สำหรับผู้เชี่ยวชาญ

ระดับถูกเดาอย่างไร

ระดับมาจากคำในบรรทัด “failed”, “crashed” และ “error” ถือเป็นข้อผิดพลาด “could not”, “refused” และ “timed out” ถือเป็นคำเตือน

อะไรถูกปิดบัง

ทุกบรรทัดถูกปิดบังตอนเขียน และอีกครั้งตอนอ่านหรือดาวน์โหลด:

• ทุกคีย์ โทเค็น รหัสผ่าน และลิงก์ webhook ที่บันทึกไว้ รวมถึงรูปแบบที่ escape ในลิงก์และรูปแบบ base64
• ค่าเก่า เมื่อความลับเปลี่ยนหรือถูกเอาออก ไฟล์ log ทั้งสองจะถูกเขียนใหม่โดยปิดบังค่านั้นก่อนทิ้งค่าเก่า
• ชื่อและรหัสผ่านในลิงก์: http://user:pass@host กลายเป็น http://[hidden]@host
• พารามิเตอร์ในลิงก์ เช่น apikey=, token=, passkey=, password=
• คู่ที่มีชื่อเป็นความลับ: API key, token, password, secret, cookie, authorization, setup code ค่าที่อยู่ในเครื่องหมายคำพูดจะถูกปิดบังถึงเครื่องหมายปิด
• Bearer และ basic token, API key ของ HolyArrs (hak_...), รหัสตั้งค่าตอนเปิดใช้ครั้งแรก และสตริงยาวที่หน้าตาเหมือนโทเค็น

ตัวขึ้นบรรทัดใหม่และรหัสสีของเทอร์มินัลในค่าจะแสดงแบบ escape ค่าจึงปลอมบรรทัดใหม่ไม่ได้ ค่าที่บันทึกไว้ยาว 4 หรือ 5 ตัวอักษรจะถูกปิดบังเฉพาะเมื่อเป็นคำทั้งคำ และไม่ปิดเมื่อเป็นคำทั่วไปอย่าง admin หรือ test

API

เส้นทาง	ใคร	ทำอะไร
GET /api/v1/app/storage	Change settings	พาธพร้อมพื้นที่ว่าง
GET /api/v1/logs?level=&q=&from=&to=&offset=&limit=	เจ้าของ แอดมิน	บรรทัดและจำนวนรวม
GET /api/v1/logs/download	เจ้าของ แอดมิน	2 MB ล่าสุดเป็นข้อความธรรมดา

API key ต้องมีขอบเขต admin ทั้งสามเส้นทาง

หน้าที่เกี่ยวข้อง

• ขอความช่วยเหลือ
• การตรวจสุขภาพ
• Backup