Log-களும் சேமிப்பும்

Log-ஐப் படித்தல்

1. Settings > Logs (அமைப்புகள் > Log-கள்) திறக்கவும். உரிமையாளரும் admin-களும் இதைப் பார்க்கலாம்.
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. உதவி கேட்கும் இடத்தில் அதை இணைக்கவும். ஆதரவைப் பெறுதல் பார்க்கவும்.

விசைகள், token-கள், கடவுச்சொற்கள் ஏற்கெனவே [hidden] என்று மறைக்கப்பட்டுள்ளன. அப்படியிருந்தும், பதிவிடும் முன் கோப்பை ஒரு முறை படிக்கவும்: தலைப்புகளின் பெயர்கள், அடைவுகள், உங்கள் server முகவரி தெரியும்.

கோப்புகள் எங்கே வைக்கப்படுகின்றன

Settings > This app > Storage (அமைப்புகள் > இந்தப் பயன்பாடு > சேமிப்பு) ஒவ்வொரு பாதையையும் HolyArrs பார்க்கும் விதத்தில், அதன் வட்டில் உள்ள காலி இடத்துடன் பட்டியலிடும். Docker-இல் இவை container-க்குள் உள்ள பாதைகள்.

பாதை	எதை வைத்திருக்கிறது
கட்டமைவு அடைவு	HolyArrs-இன் எல்லாத் தரவும்
holyarrs.db	முதன்மை தரவுத்தளம்
holyarrs-events.db	வரலாற்றுத் தரவுத்தளம்
Backup, artwork, log அடைவுகள்	கட்டமைவு அடைவுக்குள்
நூலக அடைவுகள், பதிவிறக்கியின் சேமிப்பு அடைவு	உங்கள் மீடியாவும் பதிவிறக்கங்களும்

“free space unknown” (காலி இடம் தெரியவில்லை) என்றால் கணினி அதைச் சொல்லவில்லை என்று பொருள்.

log கோப்பு கட்டமைவு அடைவில் logs/holyarrs.log ஆக உள்ளது. 5 MB ஆனதும் அது logs/holyarrs.log.1 என்று மாறும், அதனால் log-கள் சுமார் 10 MB-க்குள் இருக்கும். docker logs holyarrs அதே வெளியீட்டைக் காட்டும்.

இது வேலை செய்யவில்லை என்றால்

அறிகுறி: Logs பக்கம் இல்லை. காரணம்: உரிமையாளரும் admin-களும் மட்டுமே இதைப் பார்க்க முடியும். தீர்வு: அவர்களில் ஒருவரிடம் கேட்கவும்.

அறிகுறி: ஒரு பாதை தவறாகத் தெரிகிறது. காரணம்: Docker-இல் Storage container பாதைகளைக் காட்டும். தீர்வு: உங்கள் volume பொருத்தங்களுடன் ஒப்பிடவும். அடைவுகள் பார்க்கவும்.

நிபுணர்களுக்கு

மட்டங்கள் எப்படிக் கணிக்கப்படுகின்றன

மட்டம் வரியில் உள்ள சொற்களிலிருந்து வருகிறது. “failed”, “crashed”, “error” ஆகியவை பிழைகளைக் குறிக்கும். “could not”, “refused”, “timed out” ஆகியவை எச்சரிக்கைகளைக் குறிக்கும்.

எவை மறைக்கப்படுகின்றன

ஒவ்வொரு வரியும் எழுதப்படும்போதும், படிக்கும்போதும் அல்லது பதிவிறக்கும்போதும் மறைக்கப்படும்:

• சேமித்த ஒவ்வொரு விசை, token, கடவுச்சொல், 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-கள், HolyArrs API விசைகள் (hak_...), முதல் இயக்க setup code, நீண்ட token போன்ற சரங்கள்.

மதிப்புகளுக்குள் உள்ள வரி முறிப்புகளும் terminal நிறக் குறியீடுகளும் escape செய்யப்பட்டுக் காட்டப்படும், அதனால் ஒரு மதிப்பு புதிய வரியைப் போலி செய்ய முடியாது. 4 அல்லது 5 எழுத்துகள் உள்ள சேமித்த மதிப்புகள் முழுச் சொல்லாக இருந்தால் மட்டுமே மறைக்கப்படும்; admin அல்லது test போன்ற பொதுவான சொல்லாக இருந்தால் ஒருபோதும் மறைக்கப்படாது.

API

Route	யாருக்கு	என்ன
GET /api/v1/app/storage	Change settings	காலி இடத்துடன் பாதைகள்
GET /api/v1/logs?level=&q=&from=&to=&offset=&limit=	உரிமையாளர், admin-கள்	வரிகளும் மொத்த எண்ணிக்கையும்
GET /api/v1/logs/download	உரிமையாளர், admin-கள்	புதிய 2 MB, எளிய உரையாக

மூன்றுக்கும் API விசைகளுக்கு admin scope வேண்டும்.

தொடர்புடையவை

• ஆதரவைப் பெறுதல்
• நலச் சோதனைகள்
• Backup-கள்