.NET messaging bench¶

이 문서는 규격의 server-driven 모델(§10)을 .NET에서 어떻게 구현했는지와 실행 방법을 적는다. 비교 대상·패턴·단위·판정 규칙은 규격이 소유하고, 이 문서는 .NET 고유의 값만 담는다. 네 언어 문서는 같은 절 번호를 쓴다.

1. 비교 대상¶

구현	request	send/command	사용 API
`grpc-dotnet`	`BenchServiceClient.EchoAsync` unary RPC	`BenchServiceClient.CommandAsync` unary RPC, `Empty` reply	`Grpc.Net.Client`, ASP.NET Core gRPC
`zlink-dotnet`	raw ROUTER `Request(peer).Message(...).Async()`	raw ROUTER `Send(peer).Message(...).Async()`	published `Zlink` binding
`zlink-framework-dotnet`	`RequestToChannel("bench", payload).Async<BenchPayload>()`	`SendToChannel("bench", payload).Async()`	`Zlink.Framework`, `Zlink.Framework.AspNetCore`, `Zlink.Framework.Codecs.Protobuf`

세 구현은 같은 BenchPayload protobuf DTO와 body 앞의 29-byte header(규격 §6)를 쓴다. raw는 framework envelope와 protobuf body를 두 part로 보낸다.

2. 실행 방법¶

# 전체 matrix (3 구현 × 4 패턴 × payload 1024·4096)
./framework/bench/grpc/dotnet/run_local.sh

# 한 셀
PAYLOAD_SIZES=1024 ./framework/bench/grpc/dotnet/run_local.sh \
  --scenario request-window --implementation zlink-framework-dotnet

빌드는 runner가 WithGrpcBench.sln을 Release로 빌드한다(SKIP_BUILD=1이면 생략). binding은 published package, framework는 저장소 소스를 참조한다.

입력	기본값	동작
`PAYLOAD_SIZES`	`1024,4096`	payload 목록. 두 값 밖은 preflight 실패
`DURATION_SECONDS`	`5`	active 시간
`WARMUP`	`1000`	active 전 warmup 호출 수
`REQUEST_WINDOW`	`100`	`request-window`의 합계 in-flight. 다른 값은 preflight 실패
`SEND_CONCURRENCY`	`8`	`send-saturation`의 stream 수. 다른 값은 preflight 실패
`TIMEOUT_SECONDS`	`300`	process·operation 상한
`COMMAND_SETTLE_MS`	`200`	counter가 안정됐다고 보는 최소 quiet 구간
`DRAIN_BOUND_MS`	`30000`	settle 상한
`SKIP_BUILD`	`0`	`1`이면 solution build 생략
`OUTPUT`	`framework/bench/grpc/log/dotnet/with_grpc_dotnet_<stamp>`	run root
`CONFIGURATION`	`Release`	build·`dotnet run` 구성
`--scenario`	`all`	`all`, `request`, 네 패턴 이름
`--implementation`	`all`	`all` 또는 세 구현 이름

측정은 항상 perf 티켓 큐로 낸다(scripts/perf/perf-ticket.sh submit -p 1 -- env SKIP_BUILD=1 bash framework/bench/grpc/dotnet/run_local.sh).

3. 프로세스 구성¶

구현	source A	A 포트(trigger/stats)	target B	B 포트
`grpc-dotnet`	`WithGrpcBench.Client` — `GrpcChannel` 하나, logical stream 수만큼 unary stub	5200/5201	`WithGrpcBench.GrpcServer` — `Echo`·`Command`	gRPC 5202, stats 5203
`zlink-dotnet`	`WithGrpcBench.Client` — 셀에 필요한 raw ROUTER만 생성	5205/5206	`WithGrpcBench.ZLinkRawServer` — request echo ROUTER와 command count ROUTER 분리	request 5207, command 5208, stats 5209
`zlink-framework-dotnet`	`WithGrpcBench.Client` — `IZLinkRouteClient`	5212/5213	`WithGrpcBench.ZLinkServer` — typed request/send handler	RouteMesh 5214, stats 5215

A의 trigger·stats·phase 규칙은 canonical perf runner의 ZLink.Framework.Perf.ServerSupport (BenchHttpApplication)를 ProjectReference로 재사용한다. trigger client는 runner의 curl이며 부하를 만들지 않는다. 셀 순서는 규격 §10.4 그대로이고 셀마다 새 A/B process 쌍을 쓴다. runner는 시작 전과 셀 종료 뒤 5200-5219의 LISTEN 소켓을 확인하고, 있으면 포트를 바꾸지 않고 중단한다.

패턴	`streams.count`	`streams.inFlightPerStream`	.NET 구현
`request-serial`	1	1	순차 Task loop 하나
`request-window`	1	100	하나의 logical window를 공유하는 Task 100개
`request-backpressure`	1	없음	application in-flight 상한 없이 제출, 256회마다 `Task.Yield`
`send-saturation`	8	1	stream마다 Task와 gRPC stub 또는 raw ROUTER 하나

4. 언어별로 다르게 둔 값¶

항목	값
warmup	1000회 (smoke는 100회)
gRPC source	`GrpcChannel` 1개, `SocketsHttpHandler.MaxConnectionsPerServer=1`, `EnableMultipleHttp2Connections=false`
gRPC target	ASP.NET Core gRPC, Kestrel IPv4 loopback, HTTP/2, `AddGrpc()` 기본 구성
.NET SDK / runtime	8.0.130 / 8.0.30 (2026-09-09 측정)
gRPC package	`Grpc.Net.Client`, `Grpc.AspNetCore`, `Grpc.Core.Api` 2.62.0
ZLink binding	published 0.17.6
framework	저장소 소스 ProjectReference(측정한 커밋을 원본에 기록)

5. 결과 위치¶

framework/bench/grpc/log/dotnet/with_grpc_dotnet_<stamp>/
├── with_grpc_dotnet_<stamp>.txt
└── <implementation>-<pattern>-<payload>/
    ├── results.json        # with-grpc-cell-v1: role·trigger·streams·target_stats
    ├── report.txt          # RESULT 라인
    ├── source.log / target.log
    └── target-stats.json

3-run 집계:

python3 framework/bench/grpc/tools/bench_aggregate.py --lang dotnet --judgement-pattern request-window \
  --runs-glob 'framework/bench/grpc/log/dotnet/<run-1>/*' \
  --runs-glob 'framework/bench/grpc/log/dotnet/<run-2>/*' \
  --runs-glob 'framework/bench/grpc/log/dotnet/<run-3>/*' \
  --runs-glob 'framework/bench/grpc/log/c/<c-run>*' \
  --format full

6. 알려진 제약¶

네 패턴 × 세 구현에 unsupported 셀은 없다.
raw 비교는 ROUTER↔ROUTER만 허용한다(RAW_SOCKET=router).
framework A의 RouteMesh listener는 loopback port 0을 쓰고, B의 비교 endpoint는 5214로 고정한다.
request-backpressure의 framework 셀은 admission 거절이 request 오류로 표면화돼(결정 기록 FB-042·FB-047) 오류 셀로 기록되며 처리량 판정에 쓰지 않는다.