מזהה שגיאות בלוגים

מה הכלי עושה

הכלי קורא לוג שורה אחר שורה ומזהה את השגיאות שעוצרות או שוברות שירותי self-hosted בתדירות הגבוהה ביותר: Docker (פורט שכבר תפוס, ה-daemon או ה-socket שלו, Image למעבד אחר, פקודה חסרה, Image שאי אפשר למשוך, טווחי רשת שנגמרו), ‏PostgreSQL ו-MariaDB / MySQL (התחברות, roles, חיבורים, נתונים מגרסה אחרת, שני שרתים על אותה תיקיית נתונים), ‏nginx ו-Caddy (upstream שדחה, לא ענה בזמן או לא נמצא, שגיאות הגדרות), תעודות (אימות ACME, מגבלות קצב, תעודה שפגה או לא מוכרת), ‏Node.js ו-Python (מודולים חסרים, מגבלת ה-heap, timeouts של Gunicorn) ו-Linux עצמו (ה-OOM killer, דיסק מלא, פורט בשימוש, חיבור שנדחה, שם שלא מתורגם, מערכת קבצים לקריאה בלבד, מגבלת קבצים פתוחים, הרשאות). לכל שגיאה יש הסבר, מה לעשות קודם, התיעוד הרשמי, וה-wizard או הכלי באתר שממשיכים ממנה.

איך זה עובד

1. הדביקו את הלוג או בחרו קובץ, עד 8 MiB. הוא נקרא בעמוד הזה ב-worker ברקע, כך שהעמוד נשאר זמין גם בלוג ארוך; שום דבר לא נשלח, לא נשמר ולא מגיע ל-analytics.
2. קודם הלוג ממוסך: כתובות IP (חוץ מ-0.0.0.0, ‏loopback ו-netmasks), כתובות אימייל, tokens ומפתחות, סיסמאות ב-URL וערכים של משתנים ששמם נראה כמו סוד. כל מה שמוצג, מועתק, יורד או מועבר לסוכן מגיע מהלוג הממוסך.
3. כל שורה מושווית לרשימה קבועה של שגיאות מוכרות, שנכתבו כתבניות שלא יכולות להיתקע על שורה ארוכה או זדונית. ההתאמה הראשונה, הספציפית ביותר, מסבירה את השורה: שורה של nginx שאומרת שפורט בשימוש מוסברת כפורט בשימוש.
4. התוצאה מקבצת את השורות לפי שגיאה, עם מספרי השורות, כדי שתמצאו אותן במקור. אותו לוג נותן תמיד אותה תוצאה.

דוגמה

הלוג של stack קטן ב-Compose: מסד הנתונים דוחה את הסיסמה של האפליקציה, האפליקציה מנסה localhost במקום את שירות מסד הנתונים, ואז נגמר לה ה-heap, ו-nginx עונה 502.

db-1     | 2026-10-12 08:14:03.512 UTC [1] LOG:  database system is ready to accept connections
db-1     | 2026-10-12 08:14:09.877 UTC [68] FATAL:  password authentication failed for user "app"
app-1    | Error: connect ECONNREFUSED 127.0.0.1:5432
app-1    |     at TCPConnectWrap.afterConnect [as oncomplete] (node:net:1611:16)
app-1    | notify: sending alert to [email protected]
app-1    | FATAL ERROR: Reached heap limit Allocation failed - JavaScript heap out of memory
proxy-1  | 2026/10/12 08:15:01 [error] 29#29: *1 connect() failed (111: Connection refused) while connecting to upstream, client: 203.0.113.7, server: example.com, request: "GET / HTTP/1.1", upstream: "http://172.18.0.4:3000/", host: "example.com"

מה הכלי מוצא (ממוסך):

מגבלות

• הכלי מזהה הודעות מוכרות, לא סיבות: שורה אחת יכולה להיות סימפטום של שגיאה שתוכנה אחרת רשמה קודם. קראו את השורות שמסביב לכל התאמה.
• רק השגיאות שברשימה מזוהות; הודעה שגרסה חדשה ניסחה אחרת עלולה להתפספס עד שהרשימה תתעדכן. זו לא מערכת לניתוח לוגים או לניטור.
• המיסוך מזהה פורמטים נפוצים של כתובות וסודות ויכול לפספס אחרים (שם מארח, מזהה לקוח, סוד בפורמט חריג). קראו את הלוג הממוסך לפני שאתם משתפים אותו.
• שום דבר לא נשלח למודל AI או לשרת: ההסברים הם טקסטים קבועים, זהים לכולם.

מקורות

1. Docker Docs: Port publishing and mapping
2. ss(8), Linux manual page
3. Docker Docs: Linux post-installation steps (manage Docker as a non-root user)
4. Docker Docs: Troubleshooting the Docker daemon
5. Docker Docs: Multi-platform builds
6. Dockerfile reference: CMD
7. Dockerfile reference: ENTRYPOINT
8. Docker Docs: docker image pull
9. Docker Docs: docker login
10. Docker Docs: dockerd, daemon configuration file
11. Docker Docs: Prune unused Docker objects
12. PostgreSQL Docs: Authentication problems
13. PostgreSQL Docs: The pg_hba.conf file
14. Docker Official Image: postgres
15. PostgreSQL Docs: Database roles
16. PostgreSQL Docs: Upgrading a PostgreSQL cluster
17. PostgreSQL Docs: Connections and authentication (max_connections)
18. PostgreSQL Docs: Starting the database server (client connection problems)
19. Docker Docs: Control startup and shutdown order in Compose
20. MySQL 8.4 Reference Manual: Troubleshooting problems connecting to MySQL
21. Docker Official Image: mariadb
22. MySQL 8.4 Reference Manual: Can't connect to [local] MySQL server
23. MySQL 8.4 Reference Manual: Running multiple MySQL instances on one machine
24. nginx: ngx_http_proxy_module
25. Docker Docs: Networking in Compose
26. nginx: ngx_http_upstream_module
27. Caddy Docs: Command line (caddy validate, caddy adapt)
28. Caddy Docs: The Caddyfile
29. Let's Encrypt: Rate limits
30. Let's Encrypt: Challenge types
31. Let's Encrypt: Certificate Authority Authorization (CAA)
32. Caddy Docs: Automatic HTTPS
33. Certbot User Guide
34. OpenSSL: openssl-s_client
35. update-ca-certificates(8), Debian manual page
36. Node.js: NODE_EXTRA_CA_CERTS
37. Node.js: Modules, loading from node_modules folders
38. npm Docs: npm ci
39. Node.js: --max-old-space-size
40. Docker Docs: Resource constraints, memory
41. Python Docs: ModuleNotFoundError
42. pip User Guide: Requirements files
43. Gunicorn Docs: Settings, timeout
44. Linux kernel: Control Group v2, memory
45. df(1), Linux manual page
46. errno(3), Linux manual page
47. Node.js: Common system errors
48. Node.js: DNS, implementation considerations
49. resolv.conf(5), Linux manual page
50. mount(8), Linux manual page
51. Docker Docs: Bind mounts
52. getrlimit(2), Linux manual page
53. Docker Docs: docker container run, --ulimit
54. nginx: Command-line parameters (nginx -t)

קשורים

• קונטיינר שמופעל מחדש שוב ושוב: מוצאים את הסיבה לפי קוד היציאה
• ‏502 Bad Gateway מאחורי reverse proxy: מוצאים איפה נשבר המסלול לקונטיינר
• דיסק מלא בשרת Docker: מוצאים מה ממלא אותו ומפנים מקום בבטחה
• הרשאות volume ב-Docker

הצעד הבא

קונטיינר שמופעל מחדש שוב ושוב: מוצאים את הסיבה לפי קוד היציאה