feat(runtime): publish DriverHealthChanged via DriverInstanceActor

- IDriverHealthPublisher in Core.Abstractions + NullDriverHealthPublisher no-op for tests/dev-stub paths. - AkkaDriverHealthPublisher in Runtime forwards to the cluster-wide `driver-health` DPS topic. - DriverInstanceActor instrumented to publish snapshots on every observable state change + a periodic 30s heartbeat so the AdminUI snapshot store warms up for newly-joined SignalR clients. - Sliding 5-minute Faulted-count tracked per actor via Queue<DateTime>. - DriverHostActor.SpawnChild threads clusterId (_localNode.Value) and the health publisher down to every DriverInstanceActor child. - ServiceCollectionExtensions.AddOtOpcUaRuntime registers AkkaDriverHealthPublisher as IDriverHealthPublisher singleton.
2026-05-28 10:22:44 -04:00
parent 29370fde3c
commit 4203b84d51
5 changed files with 205 additions and 10 deletions
@@ -0,0 +1,37 @@
+using Akka.Actor;
+using Akka.Cluster.Tools.PublishSubscribe;
+using ZB.MOM.WW.OtOpcUa.Commons.Messages.Drivers;
+using ZB.MOM.WW.OtOpcUa.Core.Abstractions;
+
+namespace ZB.MOM.WW.OtOpcUa.Runtime.Drivers;
+
+/// <summary>
+///     Forwards <see cref="DriverHealth"/> transitions to the cluster-wide
+///     <c>driver-health</c> DistributedPubSub topic. Consumed by the AdminUI
+///     <c>DriverStatusSignalRBridge</c>.
+/// </summary>
+public sealed class AkkaDriverHealthPublisher : IDriverHealthPublisher
+{
+    /// <summary>The DistributedPubSub topic name for driver-health snapshots.</summary>
+    public const string TopicName = "driver-health";
+
+    private readonly ActorSystem _system;
+
+    /// <summary>Initializes a new instance of <see cref="AkkaDriverHealthPublisher"/>.</summary>
+    /// <param name="system">The Akka actor system used to resolve the DPS mediator.</param>
+    public AkkaDriverHealthPublisher(ActorSystem system) => _system = system;
+
+    /// <inheritdoc />
+    public void Publish(string clusterId, string driverInstanceId, DriverHealth health, int errorCount5Min)
+    {
+        var msg = new DriverHealthChanged(
+            clusterId,
+            driverInstanceId,
+            health.State.ToString(),
+            health.LastSuccessfulRead,
+            health.LastError,
+            errorCount5Min,
+            DateTime.UtcNow);
+        DistributedPubSub.Get(_system).Mediator.Tell(new Publish(TopicName, msg));
+    }
+}