instrumentation.js

Le fichier instrumentation.js|ts est utilisé pour intégrer des outils de surveillance et de journalisation dans votre application. Cela vous permet de suivre les performances et le comportement de votre application, ainsi que de déboguer des problèmes en production.

Pour l'utiliser, placez le fichier à la racine de votre application ou dans un dossier src si vous en utilisez un.

Option de configuration

L'instrumentation est actuellement une fonctionnalité expérimentale. Pour utiliser le fichier instrumentation, vous devez explicitement l'activer en définissant experimental.instrumentationHook = true; dans votre next.config.js :

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

Exports

register (requis)

Le fichier exporte une fonction register qui est appelée une fois lorsqu'une nouvelle instance du serveur Next.js est initialisée. register peut être une fonction asynchrone.

import { registerOTel } from '@vercel/otel'

export function register() {
  registerOTel('next-app')
}
import { registerOTel } from '@vercel/otel'

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

Historique des versions

VersionModifications
v14.0.4Prise en charge de Turbopack pour instrumentation
v13.2.0instrumentation introduite comme fonctionnalité expérimentale