instrumentation.js

instrumentation.js|ts ファイルは、アプリケーションにモニタリングツールやロギングツールを統合するために使用されます。これにより、アプリケーションのパフォーマンスや動作を追跡し、本番環境での問題をデバッグできます。

使用するには、このファイルをアプリケーションのルートディレクトリ、または src フォルダ を使用している場合はその中に配置します。

設定オプション

インストルメンテーションは現在実験的な機能です。instrumentation ファイルを使用するには、next.config.jsexperimental.instrumentationHook = true; を明示的に設定する必要があります:

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

エクスポート

register (必須)

このファイルは、新しい Next.js サーバーインスタンスが起動する際に1回だけ呼び出される register 関数をエクスポートします。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.4instrumentation の Turbopack サポートを追加
v13.2.0実験的機能として instrumentation を導入