@tripo3d/lens / index / RemoteTraceConfig

Interface: RemoteTraceConfig

Defined in: src/types.ts:175

CDN 远程配置 JSON schema（v2 终态；v1 文件 fail-open 兼容解析）

Properties

Property	Type	Description	Defined in
breadcrumb?	object	面包屑缓冲：操作链长度上限 max（默认 10）；error 事件附加用	src/types.ts:177
breadcrumb.max?	number	-	src/types.ts:177
control?	object	上报控制：performance 采样率 / poll 轮询间隔 / tech·custom 坐标级采样	src/types.ts:179
control.custom?	CoordSamplingRule	行为域坐标级采样	src/types.ts:182
control.performance?	string	性能整体采样率（'1'-'10' 映射 0.1-1.0）	src/types.ts:184
control.poll?	string	聚合上报池轮询间隔 ms（flushInterval 远程化；非法值回内置默认）	src/types.ts:186
control.tech?	CoordSamplingRule	技术域（error/performance）坐标级采样（单条）	src/types.ts:188
error?	object	错误监控控制：errorLevels 远端分级规则 + filter 远端前置过滤	src/types.ts:192
error.errorLevels?	Partial<Record<ErrorEventType, ErrorLevelRule[]>>	远端分级规则，按错误类型枚举（ErrorEventType）分组	src/types.ts:195
error.filter?	ErrorFilterConfig	远端前置过滤（控量前置门闸消费，命中即整条错误丢弃；不进 L4 采样）	src/types.ts:197
identity?	object	identity 上报控制：rate 默认 '10' 全量，远程下调仅作止血	src/types.ts:201
identity.rate?	string	-	src/types.ts:201
killSwitch	boolean	全局熔断；为 true 时 SDK 完全不上报（L4 入口统一闸断），用于线上紧急止血	src/types.ts:203
performanceConfig?	object	性能监控控制；schema 字段名 performance，类型侧避让事件类型命名	src/types.ts:205
performanceConfig.resourceTime?	Partial<Record<ResourceGroup, string[]>>	慢资源黑名单：资源类型组 → URL 正则字符串数组，命中即排除不上报	src/types.ts:208
performanceConfig.slowResourceMs?	number	慢资源阈值 ms：远端优先于插件本地 options（缺省回本地 options / 内置默认 1000）	src/types.ts:210
performanceConfig.stalePageRefresh?	StalePageRefreshConfig	长时间后台恢复刷新；非法或关闭时不装配副作用逻辑	src/types.ts:212
track?	object	track 上报控制	src/types.ts:216
track.rate?	string	采样率 '1'-'10'	src/types.ts:219
track.trackGray?	number	track 对登录用户的比例开关（分桶内核承载，[0,1]）	src/types.ts:221
track.userId?	string[]	定向采集白名单：'*' 匹配全部，其余为指定 user_id	src/types.ts:223
utmSource	string[]	utm_source 白名单（值统一小写）；源 JSON 位于 utm.utmSource 节，解析归一到此字段	src/types.ts:227
version	number	schema 版本；SDK 端只信任已识别的版本	src/types.ts:229