instrumentation.js

Die Datei instrumentation.js|ts wird verwendet, um Monitoring- und Logging-Tools in Ihre Anwendung zu integrieren. Dies ermöglicht es Ihnen, die Leistung und das Verhalten Ihrer Anwendung zu verfolgen sowie Probleme in der Produktion zu debuggen.

Um sie zu verwenden, platzieren Sie die Datei im Stammverzeichnis Ihrer Anwendung oder in einem src-Ordner, falls Sie einen verwenden.

Konfigurationsoption

Instrumentation ist derzeit ein experimentelles Feature. Um die instrumentation-Datei zu verwenden, müssen Sie sich explizit dafür entscheiden, indem Sie experimental.instrumentationHook = true; in Ihrer next.config.js definieren:

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

Exporte

register (erforderlich)

Die Datei exportiert eine register-Funktion, die einmalig aufgerufen wird, wenn eine neue Next.js-Serverinstanz initialisiert wird. register kann eine asynchrone Funktion sein.

import { registerOTel } from '@vercel/otel'

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

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

Versionsverlauf

VersionÄnderungen
v14.0.4Turbopack-Unterstützung für instrumentation
v13.2.0instrumentation als experimentelles Feature eingeführt