88268ea3a6
Coordinator ruling (I6): until ServiceLevel consumes IOpcUaEndpointState (F-C1), the probe must not sit on the Active tier of a fused node, because Traefik routes the AdminUI on /health/active. Driver-only nodes keep it on Ready + Active; admin-only nodes do not register it. Pinned per role. Refs #733 Claude-Session: https://claude.ai/code/session_01Ub9hGmYLQvn9XETzw7CMsT
48 lines
2.3 KiB
C#
48 lines
2.3 KiB
C#
using Microsoft.Extensions.Diagnostics.HealthChecks;
|
|
using ZB.MOM.WW.OtOpcUa.Host.OpcUa;
|
|
|
|
namespace ZB.MOM.WW.OtOpcUa.Host.Health;
|
|
|
|
/// <summary>
|
|
/// Ready-tier probe (plus Active on a driver-only node) for the node's OPC UA endpoint (R03:2.1): Healthy only while the SDK is
|
|
/// listening. A driver node whose SDK failed to start is otherwise indistinguishable from a healthy
|
|
/// one over HTTP — the configdb and akka probes are both green — while every OPC UA client gets
|
|
/// connection-refused.
|
|
/// </summary>
|
|
/// <remarks>
|
|
/// Registered on driver-role nodes only (<see cref="HealthEndpoints.AddOtOpcUaHealth"/>); an
|
|
/// admin-only node serves no OPC UA endpoint and must not be degraded by one it never starts. On a fused
|
|
/// admin+driver node it is Ready-only until ServiceLevel consumes the fact (F-C1), because the Active tier
|
|
/// is what Traefik routes the AdminUI on.
|
|
/// </remarks>
|
|
public sealed class OpcUaEndpointHealthCheck : IHealthCheck
|
|
{
|
|
/// <summary>The registration name, as it appears in the health JSON.</summary>
|
|
public const string Name = "opcua-endpoint";
|
|
|
|
private readonly IOpcUaEndpointState _state;
|
|
|
|
/// <summary>Initializes a new instance of the <see cref="OpcUaEndpointHealthCheck"/> class.</summary>
|
|
/// <param name="state">The endpoint lifecycle fact the hosted service maintains.</param>
|
|
public OpcUaEndpointHealthCheck(IOpcUaEndpointState state)
|
|
{
|
|
ArgumentNullException.ThrowIfNull(state);
|
|
_state = state;
|
|
}
|
|
|
|
/// <inheritdoc />
|
|
public Task<HealthCheckResult> CheckHealthAsync(HealthCheckContext context, CancellationToken cancellationToken = default)
|
|
{
|
|
var data = new Dictionary<string, object> { ["status"] = _state.Status.ToString() };
|
|
var result = _state.Status switch
|
|
{
|
|
OpcUaEndpointStatus.Started => HealthCheckResult.Healthy("OPC UA endpoint is listening", data),
|
|
OpcUaEndpointStatus.NotStarted => HealthCheckResult.Unhealthy("OPC UA endpoint has not started yet", data: data),
|
|
OpcUaEndpointStatus.Stopped => HealthCheckResult.Unhealthy("OPC UA endpoint is stopped", data: data),
|
|
_ => HealthCheckResult.Unhealthy(
|
|
"OPC UA SDK failed to start: " + (_state.FailureReason ?? "no reason recorded"), data: data),
|
|
};
|
|
return Task.FromResult(result);
|
|
}
|
|
}
|