@tripo3d/lens / server / SsrPerfCollector

Class: SsrPerfCollector

Defined in: src/server/collector.ts:30

SSR 性能采集器（框架无关），一个实例对应一次渲染。计时统一用 hrtime。两种用法： 实例直挂（推荐，框架有 per-request 载体如 h3 event.context，规避 hook 边界打断 ALS）； 或 ALS 兜底（无载体时 run() 入 ALS，链路内用 ambient API，无上下文静默忽略）。

Constructors

Constructor

new SsrPerfCollector(renderId, options?): SsrPerfCollector;

Defined in: src/server/collector.ts:40

Parameters

Parameter	Type
renderId	string
options?	SsrPerfCollectorOptions

Returns

SsrPerfCollector

Methods

currentRenderId()

currentRenderId(): string;

Defined in: src/server/collector.ts:51

当前渲染 id

Returns

string

---

offsetMsSinceStart()

offsetMsSinceStart(ns): number;

Defined in: src/server/collector.ts:56

某 hrtime 时刻相对渲染开始的 ms 偏移（供拦截器构建 waterfall），负值兜 0

Parameters

Parameter	Type
ns	bigint

Returns

number

---

markPhase()

markPhase(phase): void;

Defined in: src/server/collector.ts:62

记录某阶段相对渲染开始的 ms（空名忽略；重复以最后一次为准）

Parameters

Parameter	Type
phase	string

Returns

void

---

recordRequest()

recordRequest(timing): void;

Defined in: src/server/collector.ts:68

登记一条出站请求计时（不在渲染链路的后台任务由调用方决定是否调用，不强行归属）

Parameters

Parameter	Type
timing	SsrRequestTiming

Returns

void

---

snapshot()

snapshot(): SsrPerfSnapshot;

Defined in: src/server/collector.ts:73

产出快照：≤ maxRequests 时保序全量，超出则保留最慢 keepSlowest 条并标 truncated；requestTotalMs 为耗时之和（不受截断影响）

Returns

SsrPerfSnapshot