instrumentation.js

instrumentation.js|ts ファイルは、監視およびログツールをアプリケーションに統合するために使用されます。これにより、アプリケーションのパフォーマンスと動作を追跡し、production での問題を debugging することができます。

それを使用するには、ファイルをアプリケーションの root に配置するか、src folder を使用している場合はその内部に配置してください。

Config Option

Instrumentation は現在、実験的な機能であり、instrumentationファイルを使用するには、next.config.jsでexperimental.instrumentationHook = true;と明示的にオプトインを定義する必要があります。

module.exports = {
  experimental: {
    instrumentationHook: true,
  },
}

Exports

register (必須)

そのファイルは、新しい Next.js server インスタンスが開始されると一度だけ呼び出されるregister関数を export します。 registerは async 関数である可能性があります。

import { registerOTel } from '@vercel/otel'

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

import { registerOTel } from '@vercel/otel'

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

Version History