מדריך מקיף ל-log4js: ניהול לוגים חכם ב-Node.js

9 במרץ 2026

בניית אפליקציות Node.js מודרניות מחייבת ניהול לוגים מתקדם. log4js, ספריית הלוגינג הפופולרית ביותר בעולם Node.js, מאפשרת שליטה מלאה בכתיבה, אחסון, סיבוב ומחיקת קבצי לוג. במדריך מקיף זה נסקור את כל הפרמטרים, נלמד איך לשלוט בשמות קבצים, תדירות יצירת קבצים חדשים, סינון תוכן ומנגנוני ניקוי אוטומטי.

מבנה הקונפיגורציה הבסיסי

קונפיגורציית log4js בנויה משלושה מרכיבים עיקריים: appenders, categories ו-levels. Appenders קובעים לאן הלוגים נכתבים - קובץ, קונסול, SMTP, GELF או שירותי ענן כמו Loggly ו-Slack. Categories מארגנים קבוצות לוגים שונות ומקשרים אותן ל-appenders ספציפיים עם רמת חומרה מוגדרת. לדוגמה, אפשר להגדיר שקטגוריית database תכתוב לקובץ מפורט ברמת debug, בעוד קטגוריית security תכתוב רק שגיאות לקובץ נפרד. מבנה זה מאפשר גמישות מלאה בניהול לוגים מורכב. הגדרת pm2 ו-clustering מובנית גם כן לתמיכה בסביבות הפקה מתקדמות. כל שינוי קונפיגורציה דורש קריאה מחדש לפונקציית configure, לכן מומלץ להגדיר פעם אחת בתחילת האפליקציה. קובץ JSON חיצוני יכול לשמש לקונפיגורציה דינמית. המשתנה הסביבתי LOG4JS_CONFIG מאפשר טעינה אוטומטית מקובץ חיצוני. ברירת המחדל כוללת appender לקונסול עם צבעים, אך ללא הגדרת level אין פלט כלל. מבנה זה מבטיח בטיחות בספריות צד ג.

שליטה בשמות קבצי הלוג

פרמטר filename קובע את הנתיב המוחלט או היחסי לקובץ הלוג. נתיבים מוחלטים מבטיחים עקביות בסביבות שרת שונות. באפנדר מסוג file, השם נשאר קבוע עד רוטציה. באפנדר dateFile, פרמטר pattern מוסיף תבנית תאריך לשם: .yyyy-MM-dd יוצר קבצים יומיים כמו app.log.2026-01-27. פרמטר alwaysIncludePattern מוסיף את התבנית תמיד, גם לקובץ הנוכחי. שילוב pattern עם filename מאפשר שמות מותאמים אישית כמו logs/app-YYYYMMDD-HH.log. פרמטר keepFileSize מחליט על גודל קובץ חדש ברוטציה יומית. נתיבים עם ספריות דורשים יצירה מוקדמת שלהן באמצעות fs.mkdirSync. שימוש במשתני סביבה כמו process.env.LOG_DIR מאפשר גמישות בין סביבות פיתוח להפקה. מומלץ להפריד בין ספריות לוגים של אפליקציות שונות. תוספות כמו process.pid מוסיפות מזהה תהליך לשם קובץ ב-cluster. שילוב תבניות מורכבות מאפשר ארגון לוגים לפי שירות, גרסה וסביבה.

רוטציה לפי גודל קובץ

אפנדר file תומך ברוטציה אוטומטית לפי גודל באמצעות maxLogSize. הערך ניתן בבתים או כמחרוזת כמו 10M, 1G, 10485760. חריגה מגודל זה יוצרת קובץ חדש ומספר את הקודמים. פרמטר backups קובע כמה קבצים ישנים לשמור - ערך 5 יוצר app.log.1 עד app.log.5. מעבר לכך, קבצים ישנים נמחקים אוטומטית. compress מדחס קבצים ישנים לפורמט .gz לחיסכון מקום. פרמטר compress נשמר רק לקבצי גיבוי, לא לקובץ הפעיל. שילוב עם layout מותאם אישית מאפשר פורמטים קומפקטיים לדחיסה טובה יותר. ביצועי כתיבה נשמרים כי הרוטציה מתבצעת במסנכרן. מומלץ לערכי maxLogSize בין 5MB ל-100MB בהתאם לנפח הלוגים. backups בין 3 ל-10 מתאים לרוב האפליקציות. שימוש ב-cleanup בשרתים עם נפח דיסק מוגבל. ניטור דיסק חיוני למניעת הצפה. כלים כמו logrotate חיצוניים יכולים להשלים את המנגנון הפנימי.

רוטציה לפי תאריך ושעה

אפנדר dateFile יוצר קבצים חדשים על בסיס תבנית זמן ב-pattern. תבנית .yyyy-MM-dd יוצרת קובץ יומי חדש. .yyyy-MM-dd-HH כל שעה, .yyyy-MM-dd-HH-mm כל דקה. alwaysIncludePattern מונע שינוי שם הקובץ הנוכחי באמצע יום. פרמטר daysToKeep קובע כמה ימים לשמור קבצים - 7 ימחק קבצים ישנים מ-8 ימים. compress מדחס קבצים ישנים. keepFileSize שומר גודל קובץ קבוע בין רוטציות. שילוב pattern מורכב מאפשר רוטציה שבועית (.yyyy-ww). תבנית Z מוסיפה אזור זמן. מושלם לאפליקציות גלובליות עם שרתים מרובים. ביצועים טובים יותר מרוטציה לפי גודל באפליקציות עם נפח לוג קבוע. אחסון צפוי מאפשר תכנון דיסק. ניקוי אוטומטי מונע הצפה. שילוב עם cron jobs חיצוניים לארכוב ארוך טווח. מומלץ לשרתים עם לוגים יומיים קבועים.

סינון תוכן לפי רמות וקטגוריות

רמות הלוג (trace, debug, info, warn, error, fatal) מסוננות בקטגוריות. הגדרת level: 'info' בקטגוריה כותבת רק info ומעלה. קטגוריות מאפשרות לוגרים נפרדים: getLogger('database'), getLogger('auth'). כל קטגוריה מקושרת ל-appenders משלה עם level עצמאי. שימוש ב-replaceErrors מאפשר החלפת stack traces. פרמטר enableCallStack מוסיף מידע קריאה. maskKeys מסתיר מידע רגיש כמו סיסמאות. levels מותאמים אישית מוגדרים במבנה levels. שילוב עם Express middleware ללוג ביקושים אוטומטי. pm2InstanceVar מבדיל בין instances ב-cluster. קטגוריית default חלה על לוגרים ללא שם. ניהול מרכזי מונע כפילויות. מומלץ להפריד לפי מודולים עיקריים. ניטור בזמן אמת דורש console appender נפרד.

מנגנוני ניקוי ומחיקה אוטומטית

באפנדר file, backups קובע מספר קבצי גיבוי - עודף נמחק. compress חוסך 70% נפח ב-.gz. dateFile משתמש ב-daysToKeep למחיקת קבצים ישנים. פרמטר maxBackups מגביל גיבויים כפולים. שילוב עם fs.watchSync לניטור שינויים. ביצועי ניקוי אסינכרוניים מונעים עיכוב כתיבה. מומלץ להגדיר ניקוי יומי בשעות שקטות. שימוש ב-setInterval לבדיקת גיל קבצים. שילוב עם דיסק quota למניעת הצפה. לוגים קריטיים דורשים ארכוב חיצוני. כלים כמו ELK stack משלימים ניקוי פנימי. ניטור נפח דיסק חיוני. הגדרת alerts על גודל קריטי. אסטרטגיות שונות לסביבות שונות. פיתוח: daysToKeep=1, הפקה: 30 ימים.

אפנדרים מתקדמים ושירותי ענן

מעבר לקובץ וקונסול, log4js תומך ב-SMTP למייל שגיאות, GELF ל-Graylog, Loggly, Logstash UDP/HTTP. RabbitMQ ו-Redis לשילוב תורים. Hipchat ו-Slack להתראות. InfluxDB למטריקות. mailgun לשליחת מייל מתקדם. כל אפנדר עם פרמטרים ייחודיים. layout מותאם לכל פלט. שילוב OpenTelemetry ל-trace context. JSON layout ל-ELK stack. מודולריות מאפשרת אפנדרים מותאמים אישית. npm modules רבים זמינים. ביצועים מיטביים עם async appenders. מומלץ לשלב 2-3 אפנדרים מקסימום. קונסול לפיתוח, קובץ להפקה, ענן לניטור. תמיכה מלאה ב-TypeScript.

שילוב עם כלי ניטור מודרניים

OpenTelemetry integration מוסיף traceId ו-spanId לכל לוג. JSON layout מאפשר parsing אוטומטי ב-Prometheus, Grafana. שילוב PM2 ל-cluster logging. Express middleware ללוג HTTP requests. Custom layout ל-metadata נוסף. maskKeys מסתיר PII. שילוב Winston bridge ל migration קל. performance monitoring עם timing. error stack parsing. correlation IDs ל-microservices. structured logging ל-query מהיר. כלים כמו Datadog, New Relic תומכים ישירות. ELK stack דורש json layout. Grafana Loki ללוגים יעילים. מומלץ structured format מודרני. legacy text רק לקונסול.