Nhật ký và nơi lưu trữ

Đọc nhật ký

1. Mở Settings > Logs (Cài đặt > Nhật ký). Chủ sở hữu và quản trị viên thấy trang này.
2. Chọn một Level (mức): Every line (mọi dòng), Warnings and errors (lưu ý và lỗi) hoặc Errors only (chỉ lỗi).
3. Nhập vào Text (văn bản) để giữ các dòng có những từ đó. Không phân biệt hoa thường.
4. Đặt From (từ) và To (đến) để giới hạn các ngày; ngày To được tính. Nhấn Apply (áp dụng).
5. Chuyển trang bằng Newer (mới hơn) và Older (cũ hơn), mỗi lần 100 dòng, mới nhất trước. Bạn sẽ chỉ thấy các dòng khớp.

Chia sẻ nhật ký

1. Trên Settings > Logs, nhấn Download (tải xuống). Bạn nhận các dòng mới nhất, tối đa 2 MB, dưới dạng tệp văn bản.
2. Đính kèm nó ở nơi bạn nhờ giúp đỡ. Xem Nhận hỗ trợ.

Khóa, token và mật khẩu đã được che thành [hidden]. Dù vậy, hãy đọc tệp một lần trước khi đăng: tên các mục, thư mục và địa chỉ máy chủ của bạn vẫn hiện ra.

Nơi lưu các tệp

Settings > This app > Storage (Cài đặt > Ứng dụng này > Lưu trữ) liệt kê từng đường dẫn như HolyArrs thấy, kèm dung lượng trống trên ổ đĩa của nó. Trong Docker, đây là các đường dẫn bên trong container.

Đường dẫn	Chứa
Thư mục cấu hình	Toàn bộ dữ liệu của HolyArrs
holyarrs.db	Cơ sở dữ liệu chính
holyarrs-events.db	Cơ sở dữ liệu Lịch sử
Thư mục sao lưu, ảnh bìa, nhật ký	Bên trong thư mục cấu hình
Các thư mục Thư viện, thư mục lưu của trình tải xuống	Media và các lượt tải xuống của bạn

“free space unknown” nghĩa là hệ thống không cho biết.

Tệp nhật ký là logs/holyarrs.log trong thư mục cấu hình. Khi đạt 5 MB, nó chuyển sang logs/holyarrs.log.1, nên nhật ký luôn ở quanh mức 10 MB. docker logs holyarrs hiện cùng nội dung đó.

Nếu không hoạt động

Triệu chứng: không thấy trang Nhật ký. Nguyên nhân: chỉ chủ sở hữu và quản trị viên thấy nó. Cách khắc phục: nhờ một trong số họ.

Triệu chứng: một đường dẫn trông sai. Nguyên nhân: trong Docker, Lưu trữ hiện các đường dẫn trong container. Cách khắc phục: so với các ánh xạ volume của bạn. Xem Thư mục.

Dành cho người dùng nâng cao

Cách đoán mức của dòng nhật ký

Mức được suy ra từ các từ trong dòng. “failed”, “crashed” và “error” đánh dấu lỗi. “could not”, “refused” và “timed out” đánh dấu lưu ý.

Những gì được che

Mỗi dòng được che lúc ghi, và che lại lúc đọc hoặc tải xuống:

• Mọi khóa, token, mật khẩu và liên kết webhook đã lưu, kể cả dạng đã escape trong liên kết và dạng base64.
• Giá trị cũ. Khi một bí mật bị đổi hoặc xóa, cả hai tệp nhật ký được ghi lại với nó đã che, trước khi giá trị cũ bị bỏ.
• Tên và mật khẩu trong liên kết: http://user:pass@host thành http://[hidden]@host.
• Tham số liên kết như apikey=, token=, passkey=, password=.
• Các cặp có tên bí mật: API key, token, password, secret, cookie, authorization, setup code. Giá trị trong ngoặc kép được che đến dấu ngoặc đóng.
• Token bearer và basic, khóa API của HolyArrs (hak_...), mã thiết lập lần chạy đầu tiên và các chuỗi dài giống token.

Ngắt dòng và mã màu terminal bên trong giá trị được hiện dạng escape, nên một giá trị không thể giả một dòng mới. Giá trị đã lưu dài 4 hoặc 5 ký tự chỉ được che khi đứng riêng thành một từ, và không bao giờ che khi đó là từ thông dụng như admin hay test.

API

Route	Ai dùng	Làm gì
GET /api/v1/app/storage	Change settings	Các đường dẫn kèm dung lượng trống
GET /api/v1/logs?level=&q=&from=&to=&offset=&limit=	Chủ sở hữu, quản trị viên	Các dòng và tổng số
GET /api/v1/logs/download	Chủ sở hữu, quản trị viên	2 MB mới nhất dưới dạng văn bản thuần

Khóa API cần phạm vi admin cho cả ba.

Liên quan

• Nhận hỗ trợ
• Kiểm tra tình trạng
• Sao lưu