تسجيل البيانات (logging)

الخيارات

جلب البيانات (Fetching)

يمكنك تكوين مستوى التسجيل وما إذا كان سيتم تسجيل عنوان URL الكامل في وحدة التحكم عند تشغيل Next.js في وضع التطوير.

حاليًا، logging ينطبق فقط على جلب البيانات باستخدام واجهة fetch API. ولا ينطبق بعد على السجلات الأخرى داخل Next.js.

next.config.js
module.exports = {
  logging: {
    fetches: {
      fullUrl: true,
    },
  },
}

أي طلبات fetch التي يتم استعادتها من ذاكرة التخزين المؤقت لـ HSR للمكونات الخادمية لا يتم تسجيلها افتراضيًا. ومع ذلك، يمكن تمكين ذلك عن طريق تعيين logging.fetches.hmrRefreshes إلى true.

next.config.js
module.exports = {
  logging: {
    fetches: {
      hmrRefreshes: true,
    },
  },
}

الطلبات الواردة (Incoming Requests)

افتراضيًا، سيتم تسجيل جميع الطلبات الواردة في وحدة التحكم أثناء التطوير. يمكنك استخدام خيار incomingRequests لتحديد الطلبات التي تريد تجاهلها. نظرًا لأن هذا يتم تسجيله فقط في وضع التطوير، فإن هذا الخيار لا يؤثر على إصدارات الإنتاج.

next.config.js
module.exports = {
  logging: {
    incomingRequests: {
      ignore: [/\api\/v1\/health/],
    },
  },
}

أو يمكنك تعطيل تسجيل الطلبات الواردة عن طريق تعيين incomingRequests إلى false.

next.config.js
module.exports = {
  logging: {
    incomingRequests: false,
  },
}

تعطيل التسجيل (Disabling Logging)

بالإضافة إلى ذلك، يمكنك تعطيل تسجيل التطوير عن طريق تعيين logging إلى false.

next.config.js
module.exports = {
  logging: false,
}