跳至主要内容

TraceConfig 对象

  • recording_mode 字符串（可选） - 可以是 record-until-full、record-continuously、record-as-much-as-possible 或 trace-to-console。默认为 record-until-full。
  • trace_buffer_size_in_kb 数字（可选） - 跟踪记录缓冲区的最大大小（以 KB 为单位）。默认为 100MB。
  • trace_buffer_size_in_events 数字（可选） - 跟踪记录缓冲区的最大大小（以事件为单位）。
  • enable_argument_filter 布尔值（可选） - 如果为真，则根据手动审核过的特定事件列表过滤事件数据，以确保不包含任何 PII。有关详细信息，请参阅Chromium 中的实现。
  • included_categories 字符串数组（可选） - 要包含的跟踪类别的列表。可以使用类别名称末尾的 * 包含类似通配符的模式。有关类别列表，请参阅跟踪类别。
  • excluded_categories 字符串数组（可选） - 要排除的跟踪类别的列表。可以使用类别名称末尾的 * 包含类似通配符的模式。有关类别列表，请参阅跟踪类别。
  • included_process_ids 数字数组（可选） - 要包含在跟踪中的进程 ID 列表。如果未指定，则跟踪所有进程。
  • histogram_names 字符串数组（可选） - 要与跟踪一起报告的直方图名称列表。
  • memory_dump_config Record<string, any>（可选） - 如果启用了 disabled-by-default-memory-infra 类别，则包含用于数据收集的可选其他配置。有关更多信息，请参阅Chromium 内存基础设施文档。

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

{
  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: ['*']
}