Files
clean-architecture-frontend…/tests/scale/traffic/amplification-metrics.ts
T

35 lines
1.3 KiB
TypeScript

/**
* Spec §34. Operational amplification metrics.
*
* - request amplification = physical requests / logical interactions
* - retry amplification = total physical attempts / initial requests
* - telemetry amplification = telemetry sends / logical failures or events
*/
function ratio(numerator: number, denominator: number, name: string): number {
if (!Number.isFinite(denominator) || denominator <= 0) {
throw new RangeError(`${name} denominator must be positive: ${denominator}`);
}
if (!Number.isFinite(numerator) || numerator < 0) {
throw new RangeError(`${name} numerator must be non-negative: ${numerator}`);
}
return Math.round((numerator / denominator) * 1e9) / 1e9;
}
export function requestAmplification(
input: Readonly<{ interactions: number; physicalRequests: number }>,
): number {
return ratio(input.physicalRequests, input.interactions, "request amplification");
}
export function retryAmplification(
input: Readonly<{ initialRequests: number; totalRequests: number }>,
): number {
return ratio(input.totalRequests, input.initialRequests, "retry amplification");
}
export function telemetryAmplification(
input: Readonly<{ logicalEvents: number; telemetrySends: number }>,
): number {
return ratio(input.telemetrySends, input.logicalEvents, "telemetry amplification");
}