跳至主要内容

TraceConfig 对象

  • recording_mode string (可选) - 可以是 record-until-full、record-continuously、record-as-much-as-possible 或 trace-to-console。默认为 record-until-full。
  • trace_buffer_size_in_kb number (可选) - 跟踪记录缓冲区的最大大小（单位：千字节）。默认为 100MB。
  • trace_buffer_size_in_events number (可选) - 跟踪记录缓冲区中的最大事件数。
  • enable_argument_filter boolean (可选) - 如果为 true，则根据已手动审查以不包含任何 PII 的特定事件列表过滤事件数据。有关详细信息，请参见 Chromium 中的实现。
  • included_categories string[] (可选) - 要包含的跟踪类别列表。可以在类别名称末尾使用 * 来包含类似 glob 的模式。有关类别列表，请参见 跟踪类别。
  • excluded_categories string[] (可选) - 要排除的跟踪类别列表。可以在类别名称末尾使用 * 来包含类似 glob 的模式。有关类别列表，请参见 跟踪类别。
  • included_process_ids number[] (可选) - 要包含在跟踪中的进程 ID 列表。如果未指定，则跟踪所有进程。
  • histogram_names string[] (可选) - 要与跟踪一起报告的 histogram 名称列表。
  • memory_dump_config Record<string, any> (可选) - 如果启用了 disabled-by-default-memory-infra 类别，则此项包含用于数据收集的可选附加配置。有关更多信息，请参见 Chromium memory-infra 文档。

一个 TraceConfig 示例，它大致与 Chrome DevTools 记录的匹配

{
  recording_mode: 'record-until-full',
  included_categories: [
    'devtools.timeline',
    'disabled-by-default-devtools.timeline',
    'disabled-by-default-devtools.timeline.frame',
    'disabled-by-default-devtools.timeline.stack',
    'v8.execute',
    'blink.console',
    'blink.user_timing',
    'latencyInfo',
    'disabled-by-default-v8.cpu_profiler',
    'disabled-by-default-v8.cpu_profiler.hires'
  ],
  excluded_categories: ['*']
}