instrumentation.js
instrumentation.js|ts
ファイルは、アプリケーションにモニタリングツールやロギングツールを統合するために使用されます。これにより、アプリケーションのパフォーマンスや動作を追跡し、本番環境での問題をデバッグできます。
使用するには、このファイルをアプリケーションのルートディレクトリ、または src
フォルダ を使用している場合はその中に配置します。
設定オプション
インストルメンテーションは現在実験的な機能です。instrumentation
ファイルを使用するには、next.config.js
で experimental.instrumentationHook = true;
を明示的に設定する必要があります:
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.4 | instrumentation の Turbopack サポートを追加 |
v13.2.0 | 実験的機能として instrumentation を導入 |