instrumentation.js

Файл instrumentation.js|ts используется для интеграции инструментов мониторинга и логирования в ваше приложение. Это позволяет отслеживать производительность и поведение приложения, а также отлаживать проблемы в продакшене.

Для использования разместите файл в корне вашего приложения или внутри папки src, если она используется.

Настройка

Инструментирование в настоящее время является экспериментальной функцией. Чтобы использовать файл instrumentation, необходимо явно включить его, указав experimental.instrumentationHook = true; в вашем next.config.js:

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

Экспорты

register (обязательный)

Файл экспортирует функцию register, которая вызывается один раз при инициализации нового экземпляра сервера Next.js. Функция register может быть асинхронной.

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.0instrumentation добавлен как экспериментальная функция