跳到主要內容

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 布林值 (選填) - 若為 true，則根據已手動審查過、不包含任何 PII 的特定事件列表來篩選事件資料。詳情請參閱 Chromium 中的實作。
  • included_categories 字串陣列 (選填) - 要包含的追蹤類別列表。可以使用 glob 類型的模式，在類別名稱結尾使用 *。如需類別列表，請參閱追蹤類別。
  • excluded_categories 字串陣列 (選填) - 要排除的追蹤類別列表。可以使用 glob 類型的模式，在類別名稱結尾使用 *。如需類別列表，請參閱追蹤類別。
  • included_process_ids 數字陣列 (選填) - 要包含在追蹤中的程序 ID 列表。若未指定，則追蹤所有程序。
  • histogram_names 字串陣列 (選填) - 要與追蹤一起報告的 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: ['*']
}