test(loadharness): target-scale load harness for WP-4 / register #25 + row 50

Standalone console harness under tests/ZB.MOM.WW.ScadaBridge.LoadHarness plus a scaled-down Category=Performance smoke [Fact] in PerformanceTests. Deliberately an Exe rather than an xunit suite: the Performance trait enables a filter but does not exclude by default, so a 20-minute test would run on every 'dotnet test' of the slnx. What is real: per-site ActorSystem + LocalDb SQLite file, the real DCL (DataConnectionManagerActor/DataConnectionActor over a SimulatedDataConnection registered through the documented DataConnectionFactory.RegisterAdapter seam), real InstanceActors fed real TagValueUpdates, the real SiteStreamManager, real StreamRelayActor + production-capacity bounded DropOldest channel, real StoreAndForwardService/Storage, real SiteHealthCollector + CentralHealthAggregator. Only the socket hops are stood in for. Measures: end-to-end tag update latency (the emit instant rides TagValueUpdate.Timestamp verbatim to the subscriber), instance ramp, memory growth/CPU over a steady-state window, health report and debug view latency under load, S&F concurrent buffering + drain throughput, and slow-subscriber isolation.
2026-08-15 02:23:04 -04:00
parent 986e6e7ad5
commit 20f6b0b969
17 changed files with 2419 additions and 0 deletions
@@ -0,0 +1,53 @@
+using System.Text.Json;
+using ZB.MOM.WW.ScadaBridge.LoadHarness;
+
+// Target-scale load harness (Phase-8 WP-4 / deferred-work register #25 + row 50).
+//
+// Full-scale protocol run (the WP-4 numbers):
+//   dotnet run -c Release --project tests/ZB.MOM.WW.ScadaBridge.LoadHarness -- \
+//     --sustain-minutes 20 --results loadharness-results.json
+//
+// Full 1-hour version, unchanged in every other respect:
+//   ... -- --sustain-minutes 60 --results loadharness-results-1h.json
+//
+// Scaled-down smoke (what the CI [Fact] runs):
+//   ... -- --sites 2 --instances-per-site 10 --tags-per-instance 5 \
+//          --settle-minutes 0.1 --sustain-minutes 0.2 --sample-seconds 2 \
+//          --sf-drain-messages 200 --slow-subscriber-events 2000
+
+var config = HarnessConfig.Parse(args);
+
+Console.WriteLine("ScadaBridge target-scale load harness");
+Console.WriteLine($"  sites                {config.Sites}");
+Console.WriteLine($"  instances/site       {config.InstancesPerSite}");
+Console.WriteLine($"  tags/instance        {config.TagsPerInstance}");
+Console.WriteLine($"  total subscriptions  {config.TotalSubscriptions:N0}");
+Console.WriteLine($"  nominal update rate  {config.NominalUpdatesPerSecond:N0}/s");
+Console.WriteLine($"  settle / sustain     {config.SettleDuration.TotalMinutes:F1} / {config.SustainDuration.TotalMinutes:F1} min");
+Console.WriteLine();
+
+using var cancellation = new CancellationTokenSource();
+Console.CancelKeyPress += (_, e) =>
+{
+    e.Cancel = true;
+    cancellation.Cancel();
+};
+
+try
+{
+    var result = await HarnessRun.ExecuteAsync(config, Console.WriteLine, cancellation.Token);
+
+    var json = JsonSerializer.Serialize(result, new JsonSerializerOptions { WriteIndented = true });
+    await File.WriteAllTextAsync(config.ResultsPath, json, cancellation.Token);
+
+    Console.WriteLine();
+    Console.WriteLine(ResultsFormatter.Format(result));
+    Console.WriteLine();
+    Console.WriteLine($"JSON metrics written to {Path.GetFullPath(config.ResultsPath)}");
+    return 0;
+}
+catch (OperationCanceledException)
+{
+    Console.Error.WriteLine("Run cancelled.");
+    return 130;
+}