Load generators
Отдельные subpath exports для нагрузочных сценариев.
runHttp1Load()runWebSocketLoad()@swarmmachina/benchkit/load/http1@swarmmachina/benchkit/load/websocket@swarmmachina/benchkit v0.3.1
Benchmark / load generation
Набор инструментов для воспроизводимых Node.js-бенчмарков без runtime-зависимостей: HTTP/1.1 и WebSocket load generators, latency histograms, CPU, ELU, память и regression guards.
Используйте для измерений сервиса и контроля регрессий. Генератор работает в worker threads; целевой сервис запускайте отдельно, чтобы его показатели не смешивались с процессом генератора.
npm install --save-dev @swarmmachina/benchkitimport { runHttp1Load } from '@swarmmachina/benchkit/load/http1'
const result = await runHttp1Load({
name: 'health',
url: 'http://127.0.0.1:3000/health',
connections: 100,
pipelining: 10,
workers: 4,
warmupMs: 2_000,
durationMs: 10_000
})
console.log({
rps: result.requests.averagePerSecond,
p95Ms: result.latencyMs.p95Ms,
p99Ms: result.latencyMs.p99Ms,
errors: result.errors.total,
dropped: result.transport.rateDropped
})| Среда | Статус | Примечание |
|---|---|---|
| Node.js ^22.13.0 / 24.x | Поддерживается | Native ESM и worker threads; Node.js 26 не входит в engines. |
| HTTP / HTTPS | HTTP/1.1 | Close-delimited responses и HTTP upgrades отклоняются. |
| WebSocket target | Echo / request-response | Каждый ответ завершает старейшее in-flight сообщение; unsolicited messages считаются protocol errors. |
| SSH orchestration | Опционально | Нужны ssh, tar, key-based authentication и прямой доступ к load port. |
Отдельные subpath exports для нагрузочных сценариев.
runHttp1Load()runWebSocketLoad()@swarmmachina/benchkit/load/http1@swarmmachina/benchkit/load/websocketИзмерения, статистика и артефакты результатов.
./measurement./statistics./profiling./reporting./resultsGuards и lifecycle локальных и удалённых targets.
./regression./baseline./control./target./target-provider./orchestrationПолные сигнатуры, типы и примеры находятся в README и TypeScript declarations исходного репозитория.
Результат зависит от сервиса, генератора и среды выполнения. Сохраняйте все три части контекста.
CPU и RSS генератора включают постороннюю работу в вызывающем процессе. Используйте отдельный процесс или хост для target.
При нехватке connections × pipelining или connections × maxInFlight новые arrivals отбрасываются и учитываются в rateDropped.
HTTP generator поддерживает Content-Length, chunked, interim 1xx, HEAD, 204 и 304. WebSocket endpoint должен работать как echo/request-response.
Смотрите loadGenerator CPU, worker ELU и память вместе с errors и scheduling lag. Высокий RPS без этих данных не доказывает запас сервиса.
Для echo endpoint используйте отдельный WebSocket generator. maxInFlight ограничивает число ожидающих ответа сообщений на одно соединение.
import { runWebSocketLoad } from '@swarmmachina/benchkit/load/websocket'
const result = await runWebSocketLoad({
url: 'ws://127.0.0.1:3000/echo',
message: '{"type":"ping"}',
connections: 100,
maxInFlight: 4,
workers: 4,
warmupMs: 2_000,
durationMs: 10_000
})
console.log(result.messages.averagePerSecond, result.latencyMs.p99Ms)