35 lines
1.3 KiB
TypeScript
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");
|
|
}
|