instrumentation.js

instrumentation.js|ts 文件用于将监控和日志工具集成到您的应用中。这使您可以追踪应用的性能和行为,并在生产环境中调试问题。

要使用该文件,请将其放置在应用的根目录下,或者如果使用了 src 文件夹,则放置在该文件夹内。

配置选项

Instrumentation 目前是一项实验性功能。要使用 instrumentation 文件,您必须在 next.config.js 中显式启用 experimental.instrumentationHook = true;

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

导出项

register (必填)

该文件导出一个 register 函数,该函数在初始化新的 Next.js 服务器实例时仅调用一次register 可以是异步函数。

import { registerOTel } from '@vercel/otel'

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

版本历史

版本变更内容
v14.0.4instrumentation 添加了 Turbopack 支持
v13.2.0作为实验性功能引入了 instrumentation

On this page