instrumentation.js

instrumentation.js|ts 파일은 애플리케이션에 모니터링 및 로깅 도구를 통합하는 데 사용됩니다. 이를 통해 애플리케이션의 성능과 동작을 추적하고, 프로덕션에서 문제를 디버그할 수 있습니다.

이를 사용하려면 애플리케이션의 루트에 파일을 배치하거나, src 폴더를 사용하는 경우 src 폴더 안에 배치하십시오.

Config Option

Instrumentation은 현재 실험적 기능으로, instrumentation 파일을 사용하려면 next.config.js에서 experimental.instrumentationHook = true;을 정의하여 명시적으로 옵트인해야 합니다:

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

Exports

register (required)

이 파일은 새로운 Next.js 서버 인스턴스가 시작될 때 한 번 호출되는 register 함수를 내보냅니다. register는 비동기 함수일 수 있습니다.

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

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

Version History