iDoc.dev

한국어

English
简体中文
Español
Français
Português
Deutsch
Italiano
日本語
Русский
العربية

한국어

English
简体中文
Español
Français
Português
Deutsch
Italiano
日本語
Русский
العربية

테마

성능 측정 API ​

[안정성: 2 - 안정]

안정성: 2 안정성: 2 - 안정

소스 코드: lib/perf_hooks.js

이 모듈은 W3C 웹 성능 API의 하위 집합 구현과 Node.js 특정 성능 측정에 대한 추가 API를 제공합니다.

Node.js는 다음 웹 성능 API를 지원합니다.

js
import { performance, PerformanceObserver } from 'node:perf_hooks'

const obs = new PerformanceObserver(items => {
  console.log(items.getEntries()[0].duration)
  performance.clearMarks()
})
obs.observe({ type: 'measure' })
performance.measure('Start to Now')

performance.mark('A')
doSomeLongRunningProcess(() => {
  performance.measure('A to Now', 'A')

  performance.mark('B')
  performance.measure('A to B', 'A', 'B')
})
js
const { PerformanceObserver, performance } = require('node:perf_hooks')

const obs = new PerformanceObserver(items => {
  console.log(items.getEntries()[0].duration)
})
obs.observe({ type: 'measure' })
performance.measure('Start to Now')

performance.mark('A')
;(async function doSomeLongRunningProcess() {
  await new Promise(r => setTimeout(r, 5000))
  performance.measure('A to Now', 'A')

  performance.mark('B')
  performance.measure('A to B', 'A', 'B')
})()

perf_hooks.performance ​

추가된 버전: v8.5.0

현재 Node.js 인스턴스에서 성능 메트릭을 수집하는 데 사용할 수 있는 객체입니다. 브라우저의 window.performance와 유사합니다.

performance.clearMarks([name]) ​

[기록]

버전변경 사항
v19.0.0이 메서드는 performance 객체를 수신자로 하여 호출해야 합니다.
v8.5.0추가됨: v8.5.0

name이 제공되지 않으면 성능 타임라인에서 모든 PerformanceMark 객체가 제거됩니다. name이 제공되면 지정된 이름의 마크만 제거됩니다.

performance.clearMeasures([name]) ​

[기록]

버전변경 사항
v19.0.0이 메서드는 performance 객체를 수신자로 하여 호출해야 합니다.
v16.7.0추가됨: v16.7.0

name이 제공되지 않으면 성능 타임라인에서 모든 PerformanceMeasure 객체가 제거됩니다. name이 제공되면 지정된 이름의 측정만 제거됩니다.

performance.clearResourceTimings([name]) ​

[기록]

버전변경 사항
v19.0.0이 메서드는 performance 객체를 수신자로 하여 호출해야 합니다.
v18.2.0, v16.17.0추가됨: v18.2.0, v16.17.0

name이 제공되지 않으면 리소스 타임라인에서 모든 PerformanceResourceTiming 객체가 제거됩니다. name이 제공되면 지정된 이름의 리소스만 제거됩니다.

performance.eventLoopUtilization([utilization1[, utilization2]]) ​

추가됨: v14.10.0, v12.19.0

eventLoopUtilization() 메서드는 이벤트 루프가 고해상도 밀리초 타이머로 유휴 상태와 활성 상태였던 누적 시간 지속 시간을 포함하는 객체를 반환합니다. utilization 값은 계산된 이벤트 루프 사용률(ELU)입니다.

메인 스레드에서 부트스트래핑이 아직 완료되지 않은 경우 속성의 값은 0입니다. ELU는 부트스트랩이 이벤트 루프 내에서 발생하므로 Worker 스레드에서 즉시 사용할 수 있습니다.

utilization1 및 utilization2는 선택적 매개변수입니다.

utilization1이 전달되면 현재 호출의 active 및 idle 시간 사이의 델타와 해당 utilization 값이 계산되어 반환됩니다(과 유사 process.hrtime()).

utilization1과 utilization2가 모두 전달되면 두 인자 사이의 델타가 계산됩니다. 이는 process.hrtime()과 달리 ELU 계산은 단일 빼기보다 더 복잡하기 때문에 편리한 옵션입니다.

ELU는 CPU 사용률과 유사하지만 CPU 사용량이 아닌 이벤트 루프 통계만 측정합니다. 이벤트 루프의 이벤트 공급자(예: epoll_wait) 외부에서 이벤트 루프가 소요한 시간 백분율을 나타냅니다. 다른 CPU 유휴 시간은 고려되지 않습니다. 다음은 대부분 유휴 상태인 프로세스가 높은 ELU를 갖는 방법의 예입니다.

js
import { eventLoopUtilization } from 'node:perf_hooks'
import { spawnSync } from 'node:child_process'

setImmediate(() => {
  const elu = eventLoopUtilization()
  spawnSync('sleep', ['5'])
  console.log(eventLoopUtilization(elu).utilization)
})
js
'use strict'
const { eventLoopUtilization } = require('node:perf_hooks').performance
const { spawnSync } = require('node:child_process')

setImmediate(() => {
  const elu = eventLoopUtilization()
  spawnSync('sleep', ['5'])
  console.log(eventLoopUtilization(elu).utilization)
})

이 스크립트를 실행하는 동안 CPU는 대부분 유휴 상태이지만 utilization 값은 1입니다. 이는 child_process.spawnSync() 호출이 이벤트 루프의 진행을 차단하기 때문입니다.

eventLoopUtilization()을 이전 호출한 결과 대신 사용자 정의 객체를 전달하면 정의되지 않은 동작이 발생합니다. 반환 값은 이벤트 루프의 올바른 상태를 반영하도록 보장되지 않습니다.

performance.getEntries() ​

[기록]

버전변경 사항
v19.0.0이 메서드는 수신자로 performance 객체를 사용하여 호출해야 합니다.
v16.7.0추가됨: v16.7.0

performanceEntry.startTime을 기준으로 시간순으로 정렬된 PerformanceEntry 객체 목록을 반환합니다. 특정 유형의 성능 항목이나 특정 이름을 가진 성능 항목에만 관심이 있다면, performance.getEntriesByType() 및 performance.getEntriesByName()을 참조하십시오.

performance.getEntriesByName(name[, type]) ​

[기록]

버전변경 사항
v19.0.0이 메서드는 수신자로 performance 객체를 사용하여 호출해야 합니다.
v16.7.0추가됨: v16.7.0

performanceEntry.name이 name과 같고, 선택적으로 performanceEntry.entryType이 type과 같은 PerformanceEntry 객체 목록을 performanceEntry.startTime을 기준으로 시간순으로 정렬하여 반환합니다.

performance.getEntriesByType(type) ​

[기록]

버전변경 사항
v19.0.0이 메서드는 수신자로 performance 객체를 사용하여 호출해야 합니다.
v16.7.0추가됨: v16.7.0

performanceEntry.entryType이 type과 같은 PerformanceEntry 객체 목록을 performanceEntry.startTime을 기준으로 시간순으로 정렬하여 반환합니다.

performance.mark(name[, options]) ​

[기록]

버전변경 사항
v19.0.0이 메서드는 수신자로 performance 객체를 사용하여 호출해야 합니다. name 인수는 더 이상 선택 사항이 아닙니다.
v16.0.0User Timing Level 3 사양을 준수하도록 업데이트되었습니다.
v8.5.0추가됨: v8.5.0
  • name <string>
  • options <Object>
    • detail <any> 마크에 포함할 추가적인 선택적 세부 정보입니다.
    • startTime <number> 마크 시간으로 사용할 선택적 타임스탬프입니다. 기본값: performance.now().

Performance Timeline에 새로운 PerformanceMark 항목을 만듭니다. PerformanceMark는 performanceEntry.entryType이 항상 'mark'이고 performanceEntry.duration이 항상 0인 PerformanceEntry의 하위 클래스입니다. 성능 마크는 Performance Timeline에서 특정 중요한 순간을 표시하는 데 사용됩니다.

생성된 PerformanceMark 항목은 전역 Performance Timeline에 추가되며 performance.getEntries, performance.getEntriesByName 및 performance.getEntriesByType으로 쿼리할 수 있습니다. 관찰이 수행되면 항목은 performance.clearMarks를 사용하여 전역 Performance Timeline에서 수동으로 지워야 합니다.

performance.markResourceTiming(timingInfo, requestedUrl, initiatorType, global, cacheMode, bodyInfo, responseStatus[, deliveryType]) ​

[기록]

버전변경 사항
v22.2.0bodyInfo, responseStatus, 및 deliveryType 인수가 추가되었습니다.
v18.2.0, v16.17.0다음 버전에서 추가됨: v18.2.0, v16.17.0

이 속성은 Node.js에서 확장된 것입니다. 웹 브라우저에서는 사용할 수 없습니다.

리소스 타임라인에 새로운 PerformanceResourceTiming 항목을 만듭니다. PerformanceResourceTiming은 performanceEntry.entryType이 항상 'resource'인 PerformanceEntry의 하위 클래스입니다. 성능 리소스는 리소스 타임라인의 순간을 표시하는 데 사용됩니다.

생성된 PerformanceMark 항목은 전역 리소스 타임라인에 배치되며 performance.getEntries, performance.getEntriesByName 및 performance.getEntriesByType를 사용하여 쿼리할 수 있습니다. 관찰이 수행되면 항목은 performance.clearResourceTimings를 사용하여 전역 성능 타임라인에서 수동으로 지워야 합니다.

performance.measure(name[, startMarkOrOptions[, endMark]]) ​

[History]

버전변경 사항
v19.0.0이 메서드는 performance 객체를 수신자로 사용하여 호출해야 합니다.
v16.0.0User Timing Level 3 사양을 준수하도록 업데이트되었습니다.
v13.13.0, v12.16.3startMark 및 endMark 매개변수를 선택 사항으로 만듭니다.
v8.5.0추가됨: v8.5.0

  • name <string>

  • startMarkOrOptions <string> | <Object> 선택 사항.

    • detail <any> 측정에 포함할 추가 선택적 세부 정보입니다.
    • duration <number> 시작 시간과 종료 시간 사이의 지속 시간입니다.
    • end <number> | <string> 종료 시간으로 사용할 타임스탬프 또는 이전에 기록된 마크를 식별하는 문자열입니다.
    • start <number> | <string> 시작 시간으로 사용할 타임스탬프 또는 이전에 기록된 마크를 식별하는 문자열입니다.

  • endMark <string> 선택 사항. startMarkOrOptions가 <Object>인 경우 생략해야 합니다.

Performance Timeline에 새로운 PerformanceMeasure 항목을 만듭니다. PerformanceMeasure는 performanceEntry.entryType이 항상 'measure'이고 performanceEntry.duration이 startMark와 endMark 이후 경과된 밀리초 수를 측정하는 PerformanceEntry의 하위 클래스입니다.

startMark 인수는 Performance Timeline의 기존 PerformanceMark를 식별하거나 PerformanceNodeTiming 클래스에서 제공하는 타임스탬프 속성 중 하나를 식별할 수 있습니다. 명명된 startMark가 존재하지 않으면 오류가 발생합니다.

선택적 endMark 인수는 Performance Timeline의 기존 PerformanceMark 또는 PerformanceNodeTiming 클래스에서 제공하는 타임스탬프 속성 중 하나를 식별해야 합니다. 매개변수가 전달되지 않으면 endMark는 performance.now()가 되며, 그렇지 않으면 명명된 endMark가 존재하지 않으면 오류가 발생합니다.

생성된 PerformanceMeasure 항목은 전역 Performance Timeline에 배치되며 performance.getEntries, performance.getEntriesByName 및 performance.getEntriesByType을 사용하여 쿼리할 수 있습니다. 관찰이 수행되면 항목은 performance.clearMeasures를 사용하여 전역 Performance Timeline에서 수동으로 지워야 합니다.

performance.nodeTiming ​

Added in: v8.5.0

이 속성은 Node.js에 의해 확장되었습니다. 웹 브라우저에서는 사용할 수 없습니다.

특정 Node.js 작동 단계에 대한 성능 메트릭을 제공하는 PerformanceNodeTiming 클래스의 인스턴스입니다.

performance.now() ​

[기록]

버전변경 사항
v19.0.0이 메서드는 수신기로 performance 객체를 사용하여 호출해야 합니다.
v8.5.0추가됨: v8.5.0

현재 고해상도 밀리초 타임스탬프를 반환합니다. 여기서 0은 현재 node 프로세스의 시작을 나타냅니다.

performance.setResourceTimingBufferSize(maxSize) ​

[기록]

버전변경 사항
v19.0.0이 메서드는 수신기로 performance 객체를 사용하여 호출해야 합니다.
v18.8.0추가됨: v18.8.0

전역 성능 리소스 타이밍 버퍼 크기를 지정된 "리소스" 유형 성능 항목 객체 수로 설정합니다.

기본적으로 최대 버퍼 크기는 250으로 설정됩니다.

performance.timeOrigin ​

Added in: v8.5.0

timeOrigin은 현재 node 프로세스가 시작된 고해상도 밀리초 타임스탬프를 Unix 시간으로 측정하여 지정합니다.

performance.timerify(fn[, options]) ​

[기록]

버전변경 사항
v16.0.0히스토그램 옵션을 추가했습니다.
v16.0.0순수 JavaScript를 사용하여 비동기 함수를 타이밍할 수 있도록 재구현했습니다.
v8.5.0추가됨: v8.5.0
  • fn <Function>
  • options <Object>
    • histogram <RecordableHistogram> 나노초 단위의 런타임 지속 시간을 기록하는 perf_hooks.createHistogram()을 사용하여 생성된 히스토그램 객체입니다.

이 속성은 Node.js에 의해 확장되었습니다. 웹 브라우저에서는 사용할 수 없습니다.

래핑된 함수의 실행 시간을 측정하는 새 함수 내에서 함수를 래핑합니다. 타이밍 세부 정보에 액세스하려면 PerformanceObserver가 'function' 이벤트 유형을 구독해야 합니다.

js
import { performance, PerformanceObserver } from 'node:perf_hooks'

function someFunction() {
  console.log('hello world')
}

const wrapped = performance.timerify(someFunction)

const obs = new PerformanceObserver(list => {
  console.log(list.getEntries()[0].duration)

  performance.clearMarks()
  performance.clearMeasures()
  obs.disconnect()
})
obs.observe({ entryTypes: ['function'] })

// 성능 타임라인 항목이 생성됩니다.
wrapped()
js
const { performance, PerformanceObserver } = require('node:perf_hooks')

function someFunction() {
  console.log('hello world')
}

const wrapped = performance.timerify(someFunction)

const obs = new PerformanceObserver(list => {
  console.log(list.getEntries()[0].duration)

  performance.clearMarks()
  performance.clearMeasures()
  obs.disconnect()
})
obs.observe({ entryTypes: ['function'] })

// 성능 타임라인 항목이 생성됩니다.
wrapped()

래핑된 함수가 Promise를 반환하면 Promise에 finally 핸들러가 연결되고 finally 핸들러가 호출되면 지속 시간이 보고됩니다.

performance.toJSON() ​

[연혁]

버전변경 사항
v19.0.0이 메서드는 performance 객체를 수신자로 사용하여 호출해야 합니다.
v16.1.0추가됨: v16.1.0

performance 객체의 JSON 표현인 객체입니다. 브라우저의 window.performance.toJSON과 유사합니다.

이벤트: 'resourcetimingbufferfull' ​

추가된 버전: v18.8.0

전역 성능 리소스 타이밍 버퍼가 가득 찼을 때 'resourcetimingbufferfull' 이벤트가 발생합니다. 성능 타임라인 버퍼에 더 많은 항목을 추가하려면 이벤트 리스너에서 performance.setResourceTimingBufferSize()를 사용하여 리소스 타이밍 버퍼 크기를 조정하거나 performance.clearResourceTimings()를 사용하여 버퍼를 지우십시오.

클래스: PerformanceEntry ​

추가된 버전: v8.5.0

이 클래스의 생성자는 사용자에게 직접 노출되지 않습니다.

performanceEntry.duration ​

[연혁]

버전변경 사항
v19.0.0이 속성 getter는 PerformanceEntry 객체를 수신자로 사용하여 호출해야 합니다.
v8.5.0추가됨: v8.5.0

이 항목에 경과된 총 밀리초 수입니다. 이 값은 모든 성능 항목 유형에 대해 의미가 있는 것은 아닙니다.

performanceEntry.entryType ​

[연혁]

버전변경 사항
v19.0.0이 속성 getter는 PerformanceEntry 객체를 수신자로 사용하여 호출해야 합니다.
v8.5.0추가됨: v8.5.0

성능 항목의 유형입니다. 다음 중 하나일 수 있습니다.

  • 'dns' (Node.js 전용)
  • 'function' (Node.js 전용)
  • 'gc' (Node.js 전용)
  • 'http2' (Node.js 전용)
  • 'http' (Node.js 전용)
  • 'mark' (웹에서 사용 가능)
  • 'measure' (웹에서 사용 가능)
  • 'net' (Node.js 전용)
  • 'node' (Node.js 전용)
  • 'resource' (웹에서 사용 가능)

performanceEntry.name ​

[기록]

버전변경 사항
v19.0.0이 속성 getter는 PerformanceEntry 객체를 수신자로 사용하여 호출해야 합니다.
v8.5.0추가됨: v8.5.0

성능 항목의 이름입니다.

performanceEntry.startTime ​

[기록]

버전변경 사항
v19.0.0이 속성 getter는 PerformanceEntry 객체를 수신자로 사용하여 호출해야 합니다.
v8.5.0추가됨: v8.5.0

성능 항목의 시작 시간을 표시하는 고해상도 밀리초 타임스탬프입니다.

클래스: PerformanceMark ​

추가됨: v18.2.0, v16.17.0

Performance.mark() 메서드를 통해 생성된 마크를 노출합니다.

performanceMark.detail ​

[기록]

버전변경 사항
v19.0.0이 속성 getter는 PerformanceMark 객체를 수신자로 사용하여 호출해야 합니다.
v16.0.0추가됨: v16.0.0

Performance.mark() 메서드로 생성 시 지정된 추가 세부 정보입니다.

클래스: PerformanceMeasure ​

추가됨: v18.2.0, v16.17.0

Performance.measure() 메서드를 통해 생성된 측정값을 노출합니다.

이 클래스의 생성자는 사용자에게 직접 노출되지 않습니다.

performanceMeasure.detail ​

[기록]

버전변경 사항
v19.0.0이 속성 getter는 PerformanceMeasure 객체를 수신자로 사용하여 호출해야 합니다.
v16.0.0추가됨: v16.0.0

Performance.measure() 메서드로 생성 시 지정된 추가 세부 정보입니다.

클래스: PerformanceNodeEntry ​

추가됨: v19.0.0

이 클래스는 Node.js에서 확장되었습니다. 웹 브라우저에서는 사용할 수 없습니다.

상세한 Node.js 타이밍 데이터를 제공합니다.

이 클래스의 생성자는 사용자에게 직접 노출되지 않습니다.

performanceNodeEntry.detail ​

[기록]

버전변경 사항
v19.0.0이 속성 getter는 PerformanceNodeEntry 객체를 수신자로 사용하여 호출해야 합니다.
v16.0.0추가됨: v16.0.0

entryType에 특정한 추가 세부 정보입니다.

performanceNodeEntry.flags ​

[기록]

버전변경 사항
v16.0.0런타임에서 더 이상 사용되지 않습니다. 이제 entryType이 'gc'일 때 detail 속성으로 이동되었습니다.
v13.9.0, v12.17.0추가됨: v13.9.0, v12.17.0

[안정성: 0 - 사용 중단됨]

안정성: 0 안정성: 0 - 사용 중단됨: 대신 performanceNodeEntry.detail을 사용하세요.

performanceEntry.entryType이 'gc'와 같으면, performance.flags 속성은 가비지 컬렉션 작업에 대한 추가 정보를 포함합니다. 값은 다음 중 하나일 수 있습니다.

  • perf_hooks.constants.NODE_PERFORMANCE_GC_FLAGS_NO
  • perf_hooks.constants.NODE_PERFORMANCE_GC_FLAGS_CONSTRUCT_RETAINED
  • perf_hooks.constants.NODE_PERFORMANCE_GC_FLAGS_FORCED
  • perf_hooks.constants.NODE_PERFORMANCE_GC_FLAGS_SYNCHRONOUS_PHANTOM_PROCESSING
  • perf_hooks.constants.NODE_PERFORMANCE_GC_FLAGS_ALL_AVAILABLE_GARBAGE
  • perf_hooks.constants.NODE_PERFORMANCE_GC_FLAGS_ALL_EXTERNAL_MEMORY
  • perf_hooks.constants.NODE_PERFORMANCE_GC_FLAGS_SCHEDULE_IDLE

performanceNodeEntry.kind ​

[기록]

버전변경 사항
v16.0.0런타임에서 더 이상 사용되지 않습니다. 이제 entryType이 'gc'일 때 detail 속성으로 이동되었습니다.
v8.5.0추가됨: v8.5.0

[안정성: 0 - 사용 중단됨]

안정성: 0 안정성: 0 - 사용 중단됨: 대신 performanceNodeEntry.detail을 사용하세요.

performanceEntry.entryType이 'gc'와 같으면 performance.kind 속성은 발생한 가비지 컬렉션 작업의 유형을 식별합니다. 값은 다음 중 하나일 수 있습니다.

  • perf_hooks.constants.NODE_PERFORMANCE_GC_MAJOR
  • perf_hooks.constants.NODE_PERFORMANCE_GC_MINOR
  • perf_hooks.constants.NODE_PERFORMANCE_GC_INCREMENTAL
  • perf_hooks.constants.NODE_PERFORMANCE_GC_WEAKCB

가비지 컬렉션 ('gc') 세부 정보 ​

performanceEntry.type이 'gc'와 같으면 performanceNodeEntry.detail 속성은 두 개의 속성을 가진 <Object>입니다.

  • kind <number> 다음 중 하나입니다.

    • perf_hooks.constants.NODE_PERFORMANCE_GC_MAJOR
    • perf_hooks.constants.NODE_PERFORMANCE_GC_MINOR
    • perf_hooks.constants.NODE_PERFORMANCE_GC_INCREMENTAL
    • perf_hooks.constants.NODE_PERFORMANCE_GC_WEAKCB

  • flags <number> 다음 중 하나입니다.

    • perf_hooks.constants.NODE_PERFORMANCE_GC_FLAGS_NO
    • perf_hooks.constants.NODE_PERFORMANCE_GC_FLAGS_CONSTRUCT_RETAINED
    • perf_hooks.constants.NODE_PERFORMANCE_GC_FLAGS_FORCED
    • perf_hooks.constants.NODE_PERFORMANCE_GC_FLAGS_SYNCHRONOUS_PHANTOM_PROCESSING
    • perf_hooks.constants.NODE_PERFORMANCE_GC_FLAGS_ALL_AVAILABLE_GARBAGE
    • perf_hooks.constants.NODE_PERFORMANCE_GC_FLAGS_ALL_EXTERNAL_MEMORY
    • perf_hooks.constants.NODE_PERFORMANCE_GC_FLAGS_SCHEDULE_IDLE

HTTP ('http') 세부 정보 ​

performanceEntry.type이 'http'와 같으면 performanceNodeEntry.detail 속성은 추가 정보를 포함하는 <Object>입니다.

performanceEntry.name이 HttpClient와 같으면 detail에는 req, res 속성이 포함됩니다. 그리고 req 속성은 method, url, headers를 포함하는 <Object>이고, res 속성은 statusCode, statusMessage, headers를 포함하는 <Object>입니다.

performanceEntry.name이 HttpRequest와 같으면 detail에는 req, res 속성이 포함됩니다. 그리고 req 속성은 method, url, headers를 포함하는 <Object>이고, res 속성은 statusCode, statusMessage, headers를 포함하는 <Object>입니다.

이는 추가적인 메모리 오버헤드를 발생시킬 수 있으며, 기본적으로 프로덕션 환경에서 켜둔 채로 사용하지 않고 진단 목적으로만 사용해야 합니다.

HTTP/2 ('http2') 세부 정보 ​

performanceEntry.type이 'http2'와 같으면 performanceNodeEntry.detail 속성은 추가적인 성능 정보를 포함하는 <Object>가 됩니다.

performanceEntry.name이 Http2Stream과 같으면 detail은 다음 속성을 포함합니다.

  • bytesRead <number> 이 Http2Stream에 대해 수신된 DATA 프레임 바이트 수입니다.
  • bytesWritten <number> 이 Http2Stream에 대해 전송된 DATA 프레임 바이트 수입니다.
  • id <number> 연결된 Http2Stream의 식별자입니다.
  • timeToFirstByte <number> PerformanceEntry startTime과 첫 번째 DATA 프레임 수신 사이의 경과 시간(밀리초)입니다.
  • timeToFirstByteSent <number> PerformanceEntry startTime과 첫 번째 DATA 프레임 전송 사이의 경과 시간(밀리초)입니다.
  • timeToFirstHeader <number> PerformanceEntry startTime과 첫 번째 헤더 수신 사이의 경과 시간(밀리초)입니다.

performanceEntry.name이 Http2Session과 같으면 detail은 다음 속성을 포함합니다.

  • bytesRead <number> 이 Http2Session에 대해 수신된 바이트 수입니다.
  • bytesWritten <number> 이 Http2Session에 대해 전송된 바이트 수입니다.
  • framesReceived <number> Http2Session이 수신한 HTTP/2 프레임 수입니다.
  • framesSent <number> Http2Session이 전송한 HTTP/2 프레임 수입니다.
  • maxConcurrentStreams <number> Http2Session의 수명 동안 동시에 열려 있던 최대 스트림 수입니다.
  • pingRTT <number> PING 프레임 전송과 해당 승인 수신 사이의 경과 시간(밀리초)입니다. PING 프레임이 Http2Session에서 전송된 경우에만 존재합니다.
  • streamAverageDuration <number> 모든 Http2Stream 인스턴스의 평균 지속 시간(밀리초)입니다.
  • streamCount <number> Http2Session에서 처리된 Http2Stream 인스턴스 수입니다.
  • type <string> Http2Session 유형을 식별하기 위한 'server' 또는 'client'입니다.

Timerify ('function') 세부 정보 ​

performanceEntry.type이 'function'과 같으면 performanceNodeEntry.detail 속성은 타이밍이 지정된 함수에 대한 입력 인수를 나열하는 <Array>가 됩니다.

Net ('net') 세부 정보 ​

performanceEntry.type이 'net'과 같으면 performanceNodeEntry.detail 속성은 추가 정보가 포함된 <Object>가 됩니다.

performanceEntry.name이 connect와 같으면 detail에는 host, port 속성이 포함됩니다.

DNS ('dns') 세부 정보 ​

performanceEntry.type이 'dns'와 같으면 performanceNodeEntry.detail 속성은 추가 정보가 포함된 <Object>가 됩니다.

performanceEntry.name이 lookup과 같으면 detail에는 hostname, family, hints, verbatim, addresses 속성이 포함됩니다.

performanceEntry.name이 lookupService와 같으면 detail에는 host, port, hostname, service 속성이 포함됩니다.

performanceEntry.name이 queryxxx 또는 getHostByAddr과 같으면 detail에는 host, ttl, result 속성이 포함됩니다. result의 값은 queryxxx 또는 getHostByAddr의 결과와 동일합니다.

클래스: PerformanceNodeTiming ​

추가된 버전: v8.5.0

이 속성은 Node.js의 확장입니다. 웹 브라우저에서는 사용할 수 없습니다.

Node.js 자체에 대한 타이밍 세부 정보를 제공합니다. 이 클래스의 생성자는 사용자에게 노출되지 않습니다.

performanceNodeTiming.bootstrapComplete ​

추가된 버전: v8.5.0

Node.js 프로세스가 부트스트래핑을 완료한 고해상도 밀리초 타임스탬프입니다. 부트스트래핑이 아직 완료되지 않은 경우 속성 값은 -1입니다.

performanceNodeTiming.environment ​

추가된 버전: v8.5.0

Node.js 환경이 초기화된 고해상도 밀리초 타임스탬프입니다.

performanceNodeTiming.idleTime ​

추가된 버전: v14.10.0, v12.19.0

이벤트 루프의 이벤트 제공자(예: epoll_wait) 내에서 이벤트 루프가 유휴 상태였던 시간의 고해상도 밀리초 타임스탬프입니다. 이는 CPU 사용률을 고려하지 않습니다. 이벤트 루프가 아직 시작되지 않은 경우(예: 메인 스크립트의 첫 번째 틱에서) 속성 값은 0입니다.

performanceNodeTiming.loopExit ​

추가된 버전: v8.5.0

Node.js 이벤트 루프가 종료된 고해상도 밀리초 타임스탬프입니다. 이벤트 루프가 아직 종료되지 않은 경우 속성 값은 -1입니다. 'exit' 이벤트의 핸들러에서만 -1이 아닌 값을 가질 수 있습니다.

performanceNodeTiming.loopStart ​

추가된 버전: v8.5.0

Node.js 이벤트 루프가 시작된 고해상도 밀리초 타임스탬프입니다. 이벤트 루프가 아직 시작되지 않은 경우(예: 메인 스크립트의 첫 번째 틱에서) 속성 값은 -1입니다.

performanceNodeTiming.nodeStart ​

추가된 버전: v8.5.0

Node.js 프로세스가 초기화된 고해상도 밀리초 타임스탬프입니다.

performanceNodeTiming.uvMetricsInfo ​

추가된 버전: v22.8.0, v20.18.0

  • 반환: <Object>
    • loopCount <number> 이벤트 루프 반복 횟수입니다.
    • events <number> 이벤트 핸들러에서 처리된 이벤트 수입니다.
    • eventsWaiting <number> 이벤트 제공자가 호출되었을 때 처리 대기 중인 이벤트 수입니다.

이것은 uv_metrics_info 함수에 대한 래퍼입니다. 현재 이벤트 루프 메트릭 세트를 반환합니다.

현재 루프 반복 중에 예약된 모든 작업이 완료되기 전에 메트릭을 수집하는 것을 방지하기 위해 setImmediate를 사용하여 실행이 예약된 함수 내에서 이 속성을 사용하는 것이 좋습니다.

js
const { performance } = require('node:perf_hooks')

setImmediate(() => {
  console.log(performance.nodeTiming.uvMetricsInfo)
})
js
import { performance } from 'node:perf_hooks'

setImmediate(() => {
  console.log(performance.nodeTiming.uvMetricsInfo)
})

performanceNodeTiming.v8Start ​

추가된 버전: v8.5.0

V8 플랫폼이 초기화된 시점의 고해상도 밀리초 타임스탬프입니다.

클래스: PerformanceResourceTiming ​

추가된 버전: v18.2.0, v16.17.0

애플리케이션 리소스 로드에 대한 자세한 네트워크 타이밍 데이터를 제공합니다.

이 클래스의 생성자는 사용자에게 직접 노출되지 않습니다.

performanceResourceTiming.workerStart ​

[기록]

버전변경 사항
v19.0.0이 속성 getter는 PerformanceResourceTiming 객체를 수신자로 하여 호출해야 합니다.
v18.2.0, v16.17.0추가된 버전: v18.2.0, v16.17.0

fetch 요청을 발송하기 직전의 고해상도 밀리초 타임스탬프입니다. 리소스가 worker에 의해 가로채지지 않은 경우 속성은 항상 0을 반환합니다.

performanceResourceTiming.redirectStart ​

[기록]

버전변경 사항
v19.0.0이 속성 getter는 PerformanceResourceTiming 객체를 수신자로 하여 호출해야 합니다.
v18.2.0, v16.17.0추가된 버전: v18.2.0, v16.17.0

리디렉션을 시작하는 페치의 시작 시간을 나타내는 고해상도 밀리초 타임스탬프입니다.

performanceResourceTiming.redirectEnd ​

[기록]

버전변경 사항
v19.0.0이 속성 getter는 PerformanceResourceTiming 객체를 수신자로 하여 호출해야 합니다.
v18.2.0, v16.17.0추가된 버전: v18.2.0, v16.17.0

마지막 리디렉션의 응답의 마지막 바이트를 받은 직후에 생성되는 고해상도 밀리초 타임스탬프입니다.

performanceResourceTiming.fetchStart ​

[기록]

버전변경 사항
v19.0.0이 속성 getter는 PerformanceResourceTiming 객체를 수신자로 사용하여 호출해야 합니다.
v18.2.0, v16.17.0추가됨: v18.2.0, v16.17.0

Node.js가 리소스 가져오기를 시작하기 직전의 고해상도 밀리초 타임스탬프입니다.

performanceResourceTiming.domainLookupStart ​

[기록]

버전변경 사항
v19.0.0이 속성 getter는 PerformanceResourceTiming 객체를 수신자로 사용하여 호출해야 합니다.
v18.2.0, v16.17.0추가됨: v18.2.0, v16.17.0

Node.js가 리소스에 대한 도메인 이름 조회를 시작하기 직전의 고해상도 밀리초 타임스탬프입니다.

performanceResourceTiming.domainLookupEnd ​

[기록]

버전변경 사항
v19.0.0이 속성 getter는 PerformanceResourceTiming 객체를 수신자로 사용하여 호출해야 합니다.
v18.2.0, v16.17.0추가됨: v18.2.0, v16.17.0

Node.js가 리소스에 대한 도메인 이름 조회를 완료한 직후의 시간을 나타내는 고해상도 밀리초 타임스탬프입니다.

performanceResourceTiming.connectStart ​

[기록]

버전변경 사항
v19.0.0이 속성 getter는 PerformanceResourceTiming 객체를 수신자로 사용하여 호출해야 합니다.
v18.2.0, v16.17.0추가됨: v18.2.0, v16.17.0

Node.js가 리소스를 검색하기 위해 서버와의 연결을 설정하기 직전의 시간을 나타내는 고해상도 밀리초 타임스탬프입니다.

performanceResourceTiming.connectEnd ​

[History]

VersionChanges
v19.0.0이 속성 getter는 PerformanceResourceTiming 객체를 수신자로 사용하여 호출해야 합니다.
v18.2.0, v16.17.0추가됨: v18.2.0, v16.17.0

Node.js가 리소스를 검색하기 위해 서버에 대한 연결 설정을 완료한 직후의 시간을 나타내는 고해상도 밀리초 타임스탬프입니다.

performanceResourceTiming.secureConnectionStart ​

[History]

VersionChanges
v19.0.0이 속성 getter는 PerformanceResourceTiming 객체를 수신자로 사용하여 호출해야 합니다.
v18.2.0, v16.17.0추가됨: v18.2.0, v16.17.0

Node.js가 현재 연결을 보호하기 위한 핸드셰이크 프로세스를 시작하기 직전의 시간을 나타내는 고해상도 밀리초 타임스탬프입니다.

performanceResourceTiming.requestStart ​

[History]

VersionChanges
v19.0.0이 속성 getter는 PerformanceResourceTiming 객체를 수신자로 사용하여 호출해야 합니다.
v18.2.0, v16.17.0추가됨: v18.2.0, v16.17.0

Node.js가 서버에서 응답의 첫 번째 바이트를 받기 직전의 시간을 나타내는 고해상도 밀리초 타임스탬프입니다.

performanceResourceTiming.responseEnd ​

[History]

VersionChanges
v19.0.0이 속성 getter는 PerformanceResourceTiming 객체를 수신자로 사용하여 호출해야 합니다.
v18.2.0, v16.17.0추가됨: v18.2.0, v16.17.0

Node.js가 리소스의 마지막 바이트를 받은 직후 또는 전송 연결이 닫히기 직전의 시간 중 먼저 오는 시간을 나타내는 고해상도 밀리초 타임스탬프입니다.

performanceResourceTiming.transferSize ​

[기록]

버전변경 사항
v19.0.0이 속성 getter는 PerformanceResourceTiming 객체를 수신자로 사용하여 호출해야 합니다.
v18.2.0, v16.17.0추가됨: v18.2.0, v16.17.0

가져온 리소스의 크기(옥텟 단위)를 나타내는 숫자입니다. 크기에는 응답 헤더 필드와 응답 페이로드 본문이 포함됩니다.

performanceResourceTiming.encodedBodySize ​

[기록]

버전변경 사항
v19.0.0이 속성 getter는 PerformanceResourceTiming 객체를 수신자로 사용하여 호출해야 합니다.
v18.2.0, v16.17.0추가됨: v18.2.0, v16.17.0

콘텐츠 코딩을 제거하기 전, 가져오기(HTTP 또는 캐시)에서 받은 페이로드 본문의 크기(옥텟 단위)를 나타내는 숫자입니다.

performanceResourceTiming.decodedBodySize ​

[기록]

버전변경 사항
v19.0.0이 속성 getter는 PerformanceResourceTiming 객체를 수신자로 사용하여 호출해야 합니다.
v18.2.0, v16.17.0추가됨: v18.2.0, v16.17.0

콘텐츠 코딩을 제거한 후, 가져오기(HTTP 또는 캐시)에서 받은 메시지 본문의 크기(옥텟 단위)를 나타내는 숫자입니다.

performanceResourceTiming.toJSON() ​

[기록]

버전변경 사항
v19.0.0이 메서드는 PerformanceResourceTiming 객체를 수신자로 사용하여 호출해야 합니다.
v18.2.0, v16.17.0추가됨: v18.2.0, v16.17.0

PerformanceResourceTiming 객체의 JSON 표현인 object를 반환합니다.

클래스: PerformanceObserver ​

추가된 버전: v8.5.0

PerformanceObserver.supportedEntryTypes ​

추가된 버전: v16.0.0

지원되는 유형을 가져옵니다.

new PerformanceObserver(callback) ​

[기록]

버전변경 사항
v18.0.0callback 인수에 유효하지 않은 콜백을 전달하면 이제 ERR_INVALID_CALLBACK 대신 ERR_INVALID_ARG_TYPE이 발생합니다.
v8.5.0추가됨: v8.5.0

PerformanceObserver 객체는 새로운 PerformanceEntry 인스턴스가 성능 타임라인에 추가되었을 때 알림을 제공합니다.

js
import { performance, PerformanceObserver } from 'node:perf_hooks'

const obs = new PerformanceObserver((list, observer) => {
  console.log(list.getEntries())

  performance.clearMarks()
  performance.clearMeasures()
  observer.disconnect()
})
obs.observe({ entryTypes: ['mark'], buffered: true })

performance.mark('test')
js
const { performance, PerformanceObserver } = require('node:perf_hooks')

const obs = new PerformanceObserver((list, observer) => {
  console.log(list.getEntries())

  performance.clearMarks()
  performance.clearMeasures()
  observer.disconnect()
})
obs.observe({ entryTypes: ['mark'], buffered: true })

performance.mark('test')

PerformanceObserver 인스턴스는 자체적인 성능 오버헤드를 추가하므로 인스턴스를 알림에 무기한 구독하도록 두어서는 안 됩니다. 사용자는 더 이상 필요하지 않으면 옵저버의 연결을 해제해야 합니다.

callback은 새로운 PerformanceEntry 인스턴스에 대해 PerformanceObserver가 알림을 받을 때 호출됩니다. 콜백은 PerformanceObserverEntryList 인스턴스와 PerformanceObserver에 대한 참조를 받습니다.

performanceObserver.disconnect() ​

추가됨: v8.5.0

모든 알림에서 PerformanceObserver 인스턴스의 연결을 해제합니다.

performanceObserver.observe(options) ​

[기록]

버전변경 사항
v16.7.0Performance Timeline Level 2에 맞게 업데이트되었습니다. buffered 옵션이 다시 추가되었습니다.
v16.0.0User Timing Level 3에 맞게 업데이트되었습니다. buffered 옵션이 제거되었습니다.
v8.5.0추가됨: v8.5.0
  • options <Object>
    • type <string> 단일 <PerformanceEntry> 유형입니다. entryTypes가 이미 지정된 경우 제공해서는 안 됩니다.
    • entryTypes <string[]> 관찰자가 관심 있는 <PerformanceEntry> 인스턴스 유형을 식별하는 문자열 배열입니다. 제공되지 않으면 오류가 발생합니다.
    • buffered <boolean> true이면, 관찰자 콜백은 전역 PerformanceEntry 버퍼링된 항목 목록과 함께 호출됩니다. false이면, 해당 시점 이후에 생성된 PerformanceEntry만 관찰자 콜백으로 전송됩니다. 기본값: false.

<PerformanceObserver> 인스턴스를 options.entryTypes 또는 options.type로 식별된 새로운 <PerformanceEntry> 인스턴스 알림에 구독합니다.

js
import { performance, PerformanceObserver } from 'node:perf_hooks'

const obs = new PerformanceObserver((list, observer) => {
  // 비동기적으로 한 번 호출됩니다. `list`는 세 개의 항목을 포함합니다.
})
obs.observe({ type: 'mark' })

for (let n = 0; n < 3; n++) performance.mark(`test${n}`)
js
const { performance, PerformanceObserver } = require('node:perf_hooks')

const obs = new PerformanceObserver((list, observer) => {
  // 비동기적으로 한 번 호출됩니다. `list`는 세 개의 항목을 포함합니다.
})
obs.observe({ type: 'mark' })

for (let n = 0; n < 3; n++) performance.mark(`test${n}`)

performanceObserver.takeRecords() ​

추가된 버전: v16.0.0

  • 반환 값: <PerformanceEntry[]> 성능 관찰자에 저장된 현재 항목 목록을 비웁니다.

클래스: PerformanceObserverEntryList ​

추가된 버전: v8.5.0

PerformanceObserverEntryList 클래스는 PerformanceObserver에 전달된 PerformanceEntry 인스턴스에 대한 액세스를 제공하는 데 사용됩니다. 이 클래스의 생성자는 사용자에게 공개되지 않습니다.

performanceObserverEntryList.getEntries() ​

추가된 버전: v8.5.0

performanceEntry.startTime과 관련하여 시간 순서대로 PerformanceEntry 객체 목록을 반환합니다.

js
import { performance, PerformanceObserver } from 'node:perf_hooks'

const obs = new PerformanceObserver((perfObserverList, observer) => {
  console.log(perfObserverList.getEntries())
  /**
   * [
   *   PerformanceEntry {
   *     name: 'test',
   *     entryType: 'mark',
   *     startTime: 81.465639,
   *     duration: 0,
   *     detail: null
   *   },
   *   PerformanceEntry {
   *     name: 'meow',
   *     entryType: 'mark',
   *     startTime: 81.860064,
   *     duration: 0,
   *     detail: null
   *   }
   * ]
   */

  performance.clearMarks()
  performance.clearMeasures()
  observer.disconnect()
})
obs.observe({ type: 'mark' })

performance.mark('test')
performance.mark('meow')
js
const { performance, PerformanceObserver } = require('node:perf_hooks')

const obs = new PerformanceObserver((perfObserverList, observer) => {
  console.log(perfObserverList.getEntries())
  /**
   * [
   *   PerformanceEntry {
   *     name: 'test',
   *     entryType: 'mark',
   *     startTime: 81.465639,
   *     duration: 0,
   *     detail: null
   *   },
   *   PerformanceEntry {
   *     name: 'meow',
   *     entryType: 'mark',
   *     startTime: 81.860064,
   *     duration: 0,
   *     detail: null
   *   }
   * ]
   */

  performance.clearMarks()
  performance.clearMeasures()
  observer.disconnect()
})
obs.observe({ type: 'mark' })

performance.mark('test')
performance.mark('meow')

performanceObserverEntryList.getEntriesByName(name[, type]) ​

추가된 버전: v8.5.0

performanceEntry.name이 name과 같고, 선택적으로 performanceEntry.entryType이 type과 같은 PerformanceEntry 객체의 목록을 performanceEntry.startTime에 대해 시간 순서대로 반환합니다.

js
import { performance, PerformanceObserver } from 'node:perf_hooks'

const obs = new PerformanceObserver((perfObserverList, observer) => {
  console.log(perfObserverList.getEntriesByName('meow'))
  /**
   * [
   *   PerformanceEntry {
   *     name: 'meow',
   *     entryType: 'mark',
   *     startTime: 98.545991,
   *     duration: 0,
   *     detail: null
   *   }
   * ]
   */
  console.log(perfObserverList.getEntriesByName('nope')) // []

  console.log(perfObserverList.getEntriesByName('test', 'mark'))
  /**
   * [
   *   PerformanceEntry {
   *     name: 'test',
   *     entryType: 'mark',
   *     startTime: 63.518931,
   *     duration: 0,
   *     detail: null
   *   }
   * ]
   */
  console.log(perfObserverList.getEntriesByName('test', 'measure')) // []

  performance.clearMarks()
  performance.clearMeasures()
  observer.disconnect()
})
obs.observe({ entryTypes: ['mark', 'measure'] })

performance.mark('test')
performance.mark('meow')
js
const { performance, PerformanceObserver } = require('node:perf_hooks')

const obs = new PerformanceObserver((perfObserverList, observer) => {
  console.log(perfObserverList.getEntriesByName('meow'))
  /**
   * [
   *   PerformanceEntry {
   *     name: 'meow',
   *     entryType: 'mark',
   *     startTime: 98.545991,
   *     duration: 0,
   *     detail: null
   *   }
   * ]
   */
  console.log(perfObserverList.getEntriesByName('nope')) // []

  console.log(perfObserverList.getEntriesByName('test', 'mark'))
  /**
   * [
   *   PerformanceEntry {
   *     name: 'test',
   *     entryType: 'mark',
   *     startTime: 63.518931,
   *     duration: 0,
   *     detail: null
   *   }
   * ]
   */
  console.log(perfObserverList.getEntriesByName('test', 'measure')) // []

  performance.clearMarks()
  performance.clearMeasures()
  observer.disconnect()
})
obs.observe({ entryTypes: ['mark', 'measure'] })

performance.mark('test')
performance.mark('meow')

performanceObserverEntryList.getEntriesByType(type) ​

v8.5.0에 추가됨

performanceEntry.entryType이 type과 같은 PerformanceEntry 객체 목록을 performanceEntry.startTime을 기준으로 시간 순서대로 반환합니다.

js
import { performance, PerformanceObserver } from 'node:perf_hooks'

const obs = new PerformanceObserver((perfObserverList, observer) => {
  console.log(perfObserverList.getEntriesByType('mark'))
  /**
   * [
   *   PerformanceEntry {
   *     name: 'test',
   *     entryType: 'mark',
   *     startTime: 55.897834,
   *     duration: 0,
   *     detail: null
   *   },
   *   PerformanceEntry {
   *     name: 'meow',
   *     entryType: 'mark',
   *     startTime: 56.350146,
   *     duration: 0,
   *     detail: null
   *   }
   * ]
   */
  performance.clearMarks()
  performance.clearMeasures()
  observer.disconnect()
})
obs.observe({ type: 'mark' })

performance.mark('test')
performance.mark('meow')
js
const { performance, PerformanceObserver } = require('node:perf_hooks')

const obs = new PerformanceObserver((perfObserverList, observer) => {
  console.log(perfObserverList.getEntriesByType('mark'))
  /**
   * [
   *   PerformanceEntry {
   *     name: 'test',
   *     entryType: 'mark',
   *     startTime: 55.897834,
   *     duration: 0,
   *     detail: null
   *   },
   *   PerformanceEntry {
   *     name: 'meow',
   *     entryType: 'mark',
   *     startTime: 56.350146,
   *     duration: 0,
   *     detail: null
   *   }
   * ]
   */
  performance.clearMarks()
  performance.clearMeasures()
  observer.disconnect()
})
obs.observe({ type: 'mark' })

performance.mark('test')
performance.mark('meow')

perf_hooks.createHistogram([options]) ​

v15.9.0, v14.18.0에 추가됨

  • options <Object>

    • lowest <number> | <bigint> 가장 낮은 식별 가능한 값입니다. 0보다 큰 정수 값이어야 합니다. 기본값: 1.
    • highest <number> | <bigint> 기록 가능한 가장 높은 값입니다. lowest의 두 배 이상인 정수 값이어야 합니다. 기본값: Number.MAX_SAFE_INTEGER.
    • figures <number> 정확도 자릿수입니다. 1과 5 사이의 숫자여야 합니다. 기본값: 3.

  • 반환: <RecordableHistogram>

<RecordableHistogram>을 반환합니다.

perf_hooks.monitorEventLoopDelay([options]) ​

Added in: v11.10.0

이 속성은 Node.js에서 확장한 것입니다. 웹 브라우저에서는 사용할 수 없습니다.

시간 경과에 따른 이벤트 루프 지연을 샘플링하고 보고하는 IntervalHistogram 객체를 생성합니다. 지연은 나노초 단위로 보고됩니다.

타이머 실행이 libuv 이벤트 루프의 수명 주기에 구체적으로 연결되어 있기 때문에 타이머를 사용하여 대략적인 이벤트 루프 지연을 감지하는 것이 작동합니다. 즉, 루프 지연은 타이머 실행 지연을 유발하고, 이러한 지연은 이 API에서 구체적으로 감지하려는 것입니다.

js
import { monitorEventLoopDelay } from 'node:perf_hooks'

const h = monitorEventLoopDelay({ resolution: 20 })
h.enable()
// Do something.
h.disable()
console.log(h.min)
console.log(h.max)
console.log(h.mean)
console.log(h.stddev)
console.log(h.percentiles)
console.log(h.percentile(50))
console.log(h.percentile(99))
js
const { monitorEventLoopDelay } = require('node:perf_hooks')
const h = monitorEventLoopDelay({ resolution: 20 })
h.enable()
// Do something.
h.disable()
console.log(h.min)
console.log(h.max)
console.log(h.mean)
console.log(h.stddev)
console.log(h.percentiles)
console.log(h.percentile(50))
console.log(h.percentile(99))

Class: Histogram ​

Added in: v11.10.0

histogram.count ​

Added in: v17.4.0, v16.14.0

히스토그램에 기록된 샘플 수입니다.

histogram.countBigInt ​

Added in: v17.4.0, v16.14.0

히스토그램에 기록된 샘플 수입니다.

histogram.exceeds ​

Added in: v11.10.0

이벤트 루프 지연이 최대 1시간 이벤트 루프 지연 임계값을 초과한 횟수입니다.

histogram.exceedsBigInt ​

Added in: v17.4.0, v16.14.0

이벤트 루프 지연이 최대 1시간 이벤트 루프 지연 임계값을 초과한 횟수입니다.

histogram.max ​

Added in: v11.10.0

기록된 최대 이벤트 루프 지연 시간입니다.

histogram.maxBigInt ​

Added in: v17.4.0, v16.14.0

기록된 최대 이벤트 루프 지연 시간입니다.

histogram.mean ​

Added in: v11.10.0

기록된 이벤트 루프 지연의 평균입니다.

histogram.min ​

Added in: v11.10.0

기록된 최소 이벤트 루프 지연 시간입니다.

histogram.minBigInt ​

Added in: v17.4.0, v16.14.0

기록된 최소 이벤트 루프 지연 시간입니다.

histogram.percentile(percentile) ​

Added in: v11.10.0

  • percentile <number> (0, 100] 범위의 백분위수 값입니다.
  • 반환 값: <number>

주어진 백분위수의 값을 반환합니다.

histogram.percentileBigInt(percentile) ​

Added in: v17.4.0, v16.14.0

  • percentile <number> (0, 100] 범위의 백분위수 값입니다.
  • 반환 값: <bigint>

주어진 백분위수의 값을 반환합니다.

histogram.percentiles ​

추가된 버전: v11.10.0

누적 백분위수 분포를 자세히 설명하는 Map 객체를 반환합니다.

histogram.percentilesBigInt ​

추가된 버전: v17.4.0, v16.14.0

누적 백분위수 분포를 자세히 설명하는 Map 객체를 반환합니다.

histogram.reset() ​

추가된 버전: v11.10.0

수집된 히스토그램 데이터를 재설정합니다.

histogram.stddev ​

추가된 버전: v11.10.0

기록된 이벤트 루프 지연의 표준 편차입니다.

클래스: IntervalHistogram extends Histogram ​

주어진 간격으로 주기적으로 업데이트되는 Histogram입니다.

histogram.disable() ​

추가된 버전: v11.10.0

업데이트 간격 타이머를 비활성화합니다. 타이머가 중지되었으면 true를 반환하고, 이미 중지되었으면 false를 반환합니다.

histogram.enable() ​

추가된 버전: v11.10.0

업데이트 간격 타이머를 활성화합니다. 타이머가 시작되었으면 true를 반환하고, 이미 시작되었으면 false를 반환합니다.

IntervalHistogram 복제 ​

<IntervalHistogram> 인스턴스는 <MessagePort>를 통해 복제할 수 있습니다. 수신 측에서 히스토그램은 enable() 및 disable() 메서드를 구현하지 않는 일반 <Histogram> 객체로 복제됩니다.

클래스: RecordableHistogram extends Histogram ​

추가된 버전: v15.9.0, v14.18.0

histogram.add(other) ​

추가된 버전: v17.4.0, v16.14.0

other의 값을 이 히스토그램에 추가합니다.

histogram.record(val) ​

추가된 버전: v15.9.0, v14.18.0

histogram.recordDelta() ​

추가된 버전: v15.9.0, v14.18.0

recordDelta()에 대한 이전 호출 이후 경과된 시간(나노초)을 계산하고 해당 양을 히스토그램에 기록합니다.

예시 ​

비동기 작업의 지속 시간 측정 ​

다음 예제에서는 Async Hooks 및 Performance API를 사용하여 콜백 실행에 걸린 시간을 포함하여 Timeout 작업의 실제 지속 시간을 측정합니다.

js
import { createHook } from 'node:async_hooks'
import { performance, PerformanceObserver } from 'node:perf_hooks'

const set = new Set()
const hook = createHook({
  init(id, type) {
    if (type === 'Timeout') {
      performance.mark(`Timeout-${id}-Init`)
      set.add(id)
    }
  },
  destroy(id) {
    if (set.has(id)) {
      set.delete(id)
      performance.mark(`Timeout-${id}-Destroy`)
      performance.measure(`Timeout-${id}`, `Timeout-${id}-Init`, `Timeout-${id}-Destroy`)
    }
  },
})
hook.enable()

const obs = new PerformanceObserver((list, observer) => {
  console.log(list.getEntries()[0])
  performance.clearMarks()
  performance.clearMeasures()
  observer.disconnect()
})
obs.observe({ entryTypes: ['measure'], buffered: true })

setTimeout(() => {}, 1000)
js
'use strict'
const async_hooks = require('node:async_hooks')
const { performance, PerformanceObserver } = require('node:perf_hooks')

const set = new Set()
const hook = async_hooks.createHook({
  init(id, type) {
    if (type === 'Timeout') {
      performance.mark(`Timeout-${id}-Init`)
      set.add(id)
    }
  },
  destroy(id) {
    if (set.has(id)) {
      set.delete(id)
      performance.mark(`Timeout-${id}-Destroy`)
      performance.measure(`Timeout-${id}`, `Timeout-${id}-Init`, `Timeout-${id}-Destroy`)
    }
  },
})
hook.enable()

const obs = new PerformanceObserver((list, observer) => {
  console.log(list.getEntries()[0])
  performance.clearMarks()
  performance.clearMeasures()
  observer.disconnect()
})
obs.observe({ entryTypes: ['measure'], buffered: true })

setTimeout(() => {}, 1000)

종속성 로드에 걸리는 시간 측정 ​

다음 예제에서는 종속성을 로드하기 위한 require() 작업의 지속 시간을 측정합니다.

js
import { performance, PerformanceObserver } from 'node:perf_hooks'

// 관찰자 활성화
const obs = new PerformanceObserver(list => {
  const entries = list.getEntries()
  entries.forEach(entry => {
    console.log(`import('${entry[0]}')`, entry.duration)
  })
  performance.clearMarks()
  performance.clearMeasures()
  obs.disconnect()
})
obs.observe({ entryTypes: ['function'], buffered: true })

const timedImport = performance.timerify(async module => {
  return await import(module)
})

await timedImport('some-module')
js
'use strict'
const { performance, PerformanceObserver } = require('node:perf_hooks')
const mod = require('node:module')

// require 함수에 몽키 패치
mod.Module.prototype.require = performance.timerify(mod.Module.prototype.require)
require = performance.timerify(require)

// 관찰자 활성화
const obs = new PerformanceObserver(list => {
  const entries = list.getEntries()
  entries.forEach(entry => {
    console.log(`require('${entry[0]}')`, entry.duration)
  })
  performance.clearMarks()
  performance.clearMeasures()
  obs.disconnect()
})
obs.observe({ entryTypes: ['function'], buffered: true })

require('some-module')

HTTP 왕복에 걸리는 시간 측정 ​

다음 예제는 HTTP 클라이언트(OutgoingMessage)와 HTTP 요청(IncomingMessage)에 의해 소비된 시간을 추적하는 데 사용됩니다. HTTP 클라이언트의 경우, 요청을 시작하고 응답을 받는 사이의 시간 간격을 의미하며, HTTP 요청의 경우, 요청을 받고 응답을 보내는 사이의 시간 간격을 의미합니다.

js
import { PerformanceObserver } from 'node:perf_hooks'
import { createServer, get } from 'node:http'

const obs = new PerformanceObserver(items => {
  items.getEntries().forEach(item => {
    console.log(item)
  })
})

obs.observe({ entryTypes: ['http'] })

const PORT = 8080

createServer((req, res) => {
  res.end('ok')
}).listen(PORT, () => {
  get(`http://127.0.0.1:${PORT}`)
})
js
'use strict'
const { PerformanceObserver } = require('node:perf_hooks')
const http = require('node:http')

const obs = new PerformanceObserver(items => {
  items.getEntries().forEach(item => {
    console.log(item)
  })
})

obs.observe({ entryTypes: ['http'] })

const PORT = 8080

http
  .createServer((req, res) => {
    res.end('ok')
  })
  .listen(PORT, () => {
    http.get(`http://127.0.0.1:${PORT}`)
  })

net.connect (TCP만 해당) 성공 시 소요 시간 측정 ​

js
import { PerformanceObserver } from 'node:perf_hooks'
import { connect, createServer } from 'node:net'

const obs = new PerformanceObserver(items => {
  items.getEntries().forEach(item => {
    console.log(item)
  })
})
obs.observe({ entryTypes: ['net'] })
const PORT = 8080
createServer(socket => {
  socket.destroy()
}).listen(PORT, () => {
  connect(PORT)
})
js
'use strict'
const { PerformanceObserver } = require('node:perf_hooks')
const net = require('node:net')
const obs = new PerformanceObserver(items => {
  items.getEntries().forEach(item => {
    console.log(item)
  })
})
obs.observe({ entryTypes: ['net'] })
const PORT = 8080
net
  .createServer(socket => {
    socket.destroy()
  })
  .listen(PORT, () => {
    net.connect(PORT)
  })

요청 성공 시 DNS 소요 시간 측정 ​

js
import { PerformanceObserver } from 'node:perf_hooks'
import { lookup, promises } from 'node:dns'

const obs = new PerformanceObserver(items => {
  items.getEntries().forEach(item => {
    console.log(item)
  })
})
obs.observe({ entryTypes: ['dns'] })
lookup('localhost', () => {})
promises.resolve('localhost')
js
'use strict'
const { PerformanceObserver } = require('node:perf_hooks')
const dns = require('node:dns')
const obs = new PerformanceObserver(items => {
  items.getEntries().forEach(item => {
    console.log(item)
  })
})
obs.observe({ entryTypes: ['dns'] })
dns.lookup('localhost', () => {})
dns.promises.resolve('localhost')