Plusb Preco 3740161caa Remove remain sentences

2015-08-25 09:39:45 +09:00

5.6 KiB

Raw Blame History

content-tracing

content-trace 모듈은 Chromium 컨텐츠 모듈단에서 생성된 데이터를 수집하고 추적하는데 사용됩니다. 이 모듈은 웹 인터페이스를 포함하고 있지 않으며 크롬 브라우저에서 chrome://tracing/ 페이지를 열어 생성된 파일을 로드하면 결과를 볼 수 있습니다.

var tracing = require('content-tracing');
tracing.startRecording('*', tracing.DEFAULT_OPTIONS, function() {
  console.log('Tracing started');

  setTimeout(function() {
    tracing.stopRecording('', function(path) {
      console.log('Tracing data recorded to ' + path);
    });
  }, 5000);
});

tracing.getCategories(callback)

callback Function

카테고리 그룹 세트를 가져옵니다. 카테고리 그룹은 도달된 코드 경로를 변경할 수 있습니다.

모든 child 프로세스가 getCategories 요청을 받으면 callback이 호출되며 인자에 카테고리 그룹의 배열이 전달됩니다.

tracing.startRecording(categoryFilter, traceOptions, callback)

categoryFilter String
traceOptions String
callback Function

모든 프로세스에서 레코딩을 시작합니다.

레코딩은 지역적으로 즉시 실행됩니다. 그리고 비동기로 child 프로세스는 곧 EnableRecording 요청을 받게 됩니다. 모든 child 프로세스가 startRecording 요청을 받으면 callback이 호출됩니다.

categoryFilter는 어떤 카테고리 그룹이 트레이싱 되어야 하는지 필터링할 수 있습니다. 필터는 - 접두사를 통해 특정 카테고리 그룹을 제외할 수 있습니다. 카테고리 패턴은 같은 리스트 내에서 포함과 제외를 함께 사용할 수 없습니다.

예제:

test_MyTest*,
test_MyTest*,test_OtherStuff,
"-excluded_category1,-excluded_category2

traceOptions은 어떤 종류의 트레이싱을 사용할 수 있는지 지정하고 콤마로 리스트를 구분합니다.

사용할 수 있는 옵션은 다음과 같습니다:

record-until-full
record-continuously
trace-to-console
enable-sampling
enable-systrace

첫번째부터 3번째까지의 옵션은 추적 레코딩 모드입니다. 이에 따라 상호 배타적입니다. 만약 레코딩 모드가 한 개 이상 지정되면 마지막 지정한 모드만 사용됩니다. 어떤 모드도 설정되지 않았다면 record-until-full 모드가 기본으로 사용됩니다.

추적 옵션은 traceOptions이 파싱되어 적용되기 전까지 다음과 같은 기본값이 사용됩니다.

record-until-full이 기본 모드, enable-sampling과 enable-systrace옵션은 포함되지 않음

tracing.stopRecording(resultFilePath, callback)

resultFilePath String
callback Function

모든 프로세스에서 레코딩을 중지합니다.

Child 프로세스는 일반적으로 추적 데이터와 희귀한 플러시 그리고 추적 데이터를 메인 프로세스로 보내는 작업에 대해 캐싱 합니다. 이러한 일을 하는 이유는 IPC를 통해 추적 데이터를 보내는 작업은 매우 비싼 연산을 동반하기 때문입니다. 우리는 추적에 의한 런타임 오버헤드를 피하는 것을 지향합니다. 그래서 트레이싱이 끝나면 모든 child 프로세스에 보류된 추적 데이터를 플러시 할 것인지 물어봅니다.

모든 child 프로세스가 stopRecording 요청을 받으면 callback에 추적 데이터를 포함한 파일을 전달됩니다.

추적 데이터는 resultFilePath 해당 경로가 비어있는 경우에 한 해 해당 경로에 작성되거나 임시 파일에 작성됩니다. 실제 파일 경로는 null이 아닌 이상 callback을 통해 전달됩니다.

tracing.startMonitoring(categoryFilter, traceOptions, callback)

categoryFilter String
traceOptions String
callback Function

모든 프로세스에서 모니터링을 시작합니다.

모니터링은 지역적으로 즉시 시작됩니다. 그리고 이내 자식 프로세스들이 startMonitoring 비동기 요청을 받습니다.

모든 자식 프로세스가 startMonitoring 요청을 받으면 callback이 호출됩니다.

tracing.stopMonitoring(callback);

callback Function

모든 프로세스에서 모니터링을 중단합니다.

모든 자식 프로세스가 stopMonitoring 요청을 받으면 callback이 호출됩니다.

tracing.captureMonitoringSnapshot(resultFilePath, callback)

resultFilePath String
callback Function

현재 모니터링 추적 데이터를 가져옵니다.

Child processes typically are caching trace data and only rarely flush and send trace data back to the main process. That is because it may be an expensive operation to send the trace data over IPC, and we would like to avoid unneeded runtime overhead of tracing. So, to end tracing, we must asynchronously ask all child processes to flush any pending trace data.

Once all child processes have acked to the captureMonitoringSnapshot request, the callback will be invoked with a file that contains the traced data.

tracing.getTraceBufferUsage(callback)

callback Function

Get the maximum across processes of trace buffer percent full state. When the TraceBufferUsage value is determined, the callback is called.

tracing.setWatchEvent(categoryName, eventName, callback)

categoryName String
eventName String
callback Function

callback will will be called every time the given event occurs on any process.

tracing.cancelWatchEvent()

Watch 이벤트를 중단합니다. 만약 추적이 활성화되어 있다면 이 함수는 watch 이벤트 콜백과 race가 일어날 것입니다.

5.6 KiB Raw Blame History