ملف instrumentation.js

يستخدم ملف instrumentation.js|ts لدمج أدوات المراقبة والتسجيل في تطبيقك. هذا يسمح لك بتتبع أداء وسلوك التطبيق، وتصحيح المشكلات في بيئة الإنتاج.

لاستخدامه، ضع الملف في الجذر لتطبيقك أو داخل مجلد src إذا كنت تستخدم واحدًا.

خيار التكوين

الأدوات (Instrumentation) حاليًا ميزة تجريبية، لاستخدام ملف instrumentation، يجب عليك الموافقة صراحةً عن طريق تعريف experimental.instrumentationHook = true; في ملف next.config.js الخاص بك:

next.config.js
module.exports = {
  experimental: {
    instrumentationHook: true,
  },
}

التصديرات

register (مطلوب)

يصدر الملف دالة register يتم استدعاؤها مرة واحدة عند بدء مثيل جديد لخادم Next.js. يمكن أن تكون register دالة غير متزامنة (async).

import { registerOTel } from '@vercel/otel'

export function register() {
  registerOTel('next-app')
}
import { registerOTel } from '@vercel/otel'

export function register() {
  registerOTel('next-app')
}

سجل الإصدارات

الإصدارالتغييرات
v14.0.4دعم Turbopack لـ instrumentation
v13.2.0تقديم instrumentation كميزة تجريبية