לוגים ואחסון

לקרוא את הלוג

1. פתח Settings > Logs (הגדרות > לוגים). הבעלים והמנהלים רואים אותו.
2. בחר Level (רמה): Every line (כל שורה), Warnings and errors (אזהרות ושגיאות) או Errors only (שגיאות בלבד).
3. הקלד ב-Text (טקסט) כדי להשאיר שורות עם המילים האלה. אותיות גדולות וקטנות לא משנות.
4. הגדר From (מתאריך) ו-To (עד תאריך) כדי להגביל את הימים; To כלול. לחץ על Apply (החל).
5. עבור בין עמודים עם Newer (חדשים) ו-Older (ישנים), 100 שורות בכל פעם, החדשות ראשונות. אתה אמור לראות רק שורות תואמות.

לשתף את הלוג

1. ב-Settings > Logs, לחץ על Download (הורדה). אתה מקבל את השורות החדשות ביותר, עד 2 MB, כקובץ טקסט.
2. צרף אותו במקום שבו אתה מבקש עזרה. ראה לקבל תמיכה.

מפתחות, tokens וסיסמאות כבר מוסתרים כ-[hidden]. בכל זאת קרא את הקובץ פעם אחת לפני שאתה מפרסם: שמות של כותרים, תיקיות וכתובת השרת שלך נשארים גלויים.

איפה הקבצים נשמרים

Settings > This app > Storage (הגדרות > האפליקציה הזו > אחסון) מציג כל נתיב כפי ש-HolyArrs רואה אותו, עם המקום הפנוי בדיסק שלו. ב-Docker אלה נתיבים בתוך הקונטיינר.

נתיב	מה יש בו
תיקיית הגדרות	כל הנתונים של HolyArrs
holyarrs.db	מסד הנתונים הראשי
holyarrs-events.db	מסד נתוני ההיסטוריה
תיקיות גיבויים, תמונות ולוגים	בתוך תיקיית ההגדרות
תיקיות ספרייה, תיקיית השמירה של המוריד	המדיה וההורדות שלך

“free space unknown” (מקום פנוי לא ידוע) אומר שהמערכת לא דיווחה.

קובץ הלוג הוא logs/holyarrs.log בתיקיית ההגדרות. ב-5 MB הוא עובר ל-logs/holyarrs.log.1, כך שהלוגים נשארים סביב 10 MB. docker logs holyarrs מציג את אותו פלט.

אם זה לא עובד

תסמין: דף הלוגים חסר. סיבה: רק הבעלים והמנהלים רואים אותו. פתרון: בקש מאחד מהם.

תסמין: נתיב נראה לא נכון. סיבה: ב-Docker, Storage מציג נתיבים של הקונטיינר. פתרון: השווה עם מיפויי הווליומים שלך. ראה תיקיות.

למומחים

איך מנחשים את הרמה

הרמה נקבעת לפי מילים בשורה. “failed”, “crashed” ו-“error” מסמנות שגיאות. “could not”, “refused” ו-“timed out” מסמנות אזהרות.

מה מוסתר

כל שורה מוסתרת כשהיא נכתבת, ושוב כשהיא נקראת או מורדת:

• כל מפתח, token, סיסמה וקישור webhook שנשמרו, גם בצורות שעברו קידוד לקישור וצורות base64.
• ערכים ישנים. כשערך סודי משתנה או מוסר, שני קבצי הלוג נכתבים מחדש עם הסתרה לפני שהערך הישן נזרק.
• שמות וסיסמאות בקישורים: http://user:pass@host הופך ל-http://[hidden]@host.
• פרמטרים בקישור כמו apikey=, token=, passkey=, password=.
• זוגות עם שם סודי: API key, token, password, secret, cookie, authorization, setup code. ערכים במירכאות מוסתרים עד המירכאה הסוגרת.
• Bearer ו-basic tokens, מפתחות API של HolyArrs (hak_...), קוד ההגדרה של ההפעלה הראשונה ומחרוזות ארוכות שנראות כמו tokens.

מעברי שורה וקודי צבע של טרמינל בתוך ערכים מוצגים בצורת 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 צריכים את ההיקף admin לשלושתם.

קשור

• לקבל תמיכה
• בדיקות תקינות
• גיבויים