Phase 6.1 Stream C — health endpoints on :4841 + LogContextEnricher + Serilog JSON sink + CapabilityInvoker enrichment

Closes Stream C per docs/v2/implementation/phase-6-1-resilience-and-observability.md.

Core.Observability (new namespace):
- DriverHealthReport — pure-function aggregation over DriverHealthSnapshot list.
  Empty fleet = Healthy. Any Faulted = Faulted. Any Unknown/Initializing (no
  Faulted) = NotReady. Any Degraded or Reconnecting (no Faulted, no NotReady)
  = Degraded. Else Healthy. HttpStatus(verdict) maps to the Stream C.1 state
  matrix: Healthy/Degraded → 200, NotReady/Faulted → 503.
- LogContextEnricher — Serilog LogContext wrapper. Push(id, type, capability,
  correlationId) returns an IDisposable scope; inner log calls carry
  DriverInstanceId / DriverType / CapabilityName / CorrelationId structured
  properties automatically. NewCorrelationId = 12-hex-char GUID slice for
  cases where no OPC UA RequestHeader.RequestHandle is in flight.

CapabilityInvoker — now threads LogContextEnricher around every ExecuteAsync /
ExecuteWriteAsync call site. OtOpcUaServer passes driver.DriverType through
so logs correlate to the driver type too. Every capability call emits
structured fields per the Stream C.4 compliance check.

Server.Observability:
- HealthEndpointsHost — standalone HttpListener on http://localhost:4841/
  (loopback avoids Windows URL-ACL elevation; remote probing via reverse
  proxy or explicit netsh urlacl grant). Routes:
    /healthz → 200 when (configDbReachable OR usingStaleConfig); 503 otherwise.
      Body: status, uptimeSeconds, configDbReachable, usingStaleConfig.
    /readyz  → DriverHealthReport.Aggregate + HttpStatus mapping.
      Body: verdict, drivers[], degradedDrivers[], uptimeSeconds.
    anything else → 404.
  Disposal cooperative with the HttpListener shutdown.
- OpcUaApplicationHost starts the health host after the OPC UA server comes up
  and disposes it on shutdown. New OpcUaServerOptions knobs:
  HealthEndpointsEnabled (default true), HealthEndpointsPrefix (default
  http://localhost:4841/).

Program.cs:
- Serilog pipeline adds Enrich.FromLogContext + opt-in JSON file sink via
  `Serilog:WriteJson = true` appsetting. Uses Serilog.Formatting.Compact's
  CompactJsonFormatter (one JSON object per line — SIEMs like Splunk,
  Datadog, Graylog ingest without a regex parser).

Server.Tests:
- Existing 3 OpcUaApplicationHost integration tests now set
  HealthEndpointsEnabled=false to avoid port :4841 collisions under parallel
  execution.
- New HealthEndpointsHostTests (9): /healthz healthy empty fleet; stale-config
  returns 200 with flag; unreachable+no-cache returns 503; /readyz empty/
  Healthy/Faulted/Degraded/Initializing drivers return correct status and
  bodies; unknown path → 404. Uses ephemeral ports via Interlocked counter.

Core.Tests:
- DriverHealthReportTests (8): empty fleet, all-healthy, any-Faulted trumps,
  any-NotReady without Faulted, Degraded without Faulted/NotReady, HttpStatus
  per-verdict theory.
- LogContextEnricherTests (8): all 4 properties attach; scope disposes cleanly;
  NewCorrelationId shape; null/whitespace driverInstanceId throws.
- CapabilityInvokerEnrichmentTests (2): inner logs carry structured
  properties; no context leak outside the call site.

Full solution dotnet test: 1016 passing (baseline 906, +110 for Phase 6.1 so
far across Streams A+B+C). Pre-existing Client.CLI Subscribe flake unchanged.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

src/ZB.MOM.WW.OtOpcUa.Core/Observability/DriverHealthReport.cs

@@ -0,0 +1,86 @@
+using ZB.MOM.WW.OtOpcUa.Core.Abstractions;
+
+namespace ZB.MOM.WW.OtOpcUa.Core.Observability;
+
+/// <summary>
+///     Domain-layer health aggregation for Phase 6.1 Stream C. Pure functions over the driver
+///     fleet — given each driver's <see cref="DriverState"/>, produce a <see cref="ReadinessVerdict"/>
+///     that maps to HTTP status codes at the endpoint layer.
+/// </summary>
+/// <remarks>
+///     State matrix per <c>docs/v2/implementation/phase-6-1-resilience-and-observability.md</c>
+///     §Stream C.1:
+///     <list type="bullet">
+///         <item><see cref="DriverState.Unknown"/> / <see cref="DriverState.Initializing"/>
+///             → /readyz 503 (not yet ready).</item>
+///         <item><see cref="DriverState.Healthy"/> → /readyz 200.</item>
+///         <item><see cref="DriverState.Degraded"/> → /readyz 200 with flagged driver IDs.</item>
+///         <item><see cref="DriverState.Faulted"/> → /readyz 503.</item>
+///     </list>
+///     The overall verdict is computed across the fleet: any Faulted → Faulted; any
+///     Unknown/Initializing → NotReady; any Degraded → Degraded; else Healthy. An empty fleet
+///     is Healthy (nothing to degrade).
+/// </remarks>
+public static class DriverHealthReport
+{
+    /// <summary>Compute the fleet-wide readiness verdict from per-driver states.</summary>
+    public static ReadinessVerdict Aggregate(IReadOnlyList<DriverHealthSnapshot> drivers)
+    {
+        ArgumentNullException.ThrowIfNull(drivers);
+        if (drivers.Count == 0) return ReadinessVerdict.Healthy;
+
+        var anyFaulted = drivers.Any(d => d.State == DriverState.Faulted);
+        if (anyFaulted) return ReadinessVerdict.Faulted;
+
+        var anyInitializing = drivers.Any(d =>
+            d.State == DriverState.Unknown || d.State == DriverState.Initializing);
+        if (anyInitializing) return ReadinessVerdict.NotReady;
+
+        // Reconnecting = driver alive but not serving live data; report as Degraded so /readyz
+        // stays 200 (the fleet can still serve cached / last-good data) while operators see the
+        // affected driver in the body.
+        var anyDegraded = drivers.Any(d =>
+            d.State == DriverState.Degraded || d.State == DriverState.Reconnecting);
+        if (anyDegraded) return ReadinessVerdict.Degraded;
+
+        return ReadinessVerdict.Healthy;
+    }
+
+    /// <summary>
+    ///     Map a <see cref="ReadinessVerdict"/> to the HTTP status the /readyz endpoint should
+    ///     return per the Stream C.1 state matrix.
+    /// </summary>
+    public static int HttpStatus(ReadinessVerdict verdict) => verdict switch
+    {
+        ReadinessVerdict.Healthy => 200,
+        ReadinessVerdict.Degraded => 200,
+        ReadinessVerdict.NotReady => 503,
+        ReadinessVerdict.Faulted => 503,
+        _ => 500,
+    };
+}
+
+/// <summary>Per-driver snapshot fed into <see cref="DriverHealthReport.Aggregate"/>.</summary>
+/// <param name="DriverInstanceId">Driver instance identifier (from <c>IDriver.DriverInstanceId</c>).</param>
+/// <param name="State">Current <see cref="DriverState"/> from <c>IDriver.GetHealth</c>.</param>
+/// <param name="DetailMessage">Optional driver-supplied detail (e.g. "primary PLC unreachable").</param>
+public sealed record DriverHealthSnapshot(
+    string DriverInstanceId,
+    DriverState State,
+    string? DetailMessage = null);
+
+/// <summary>Overall fleet readiness — derived from driver states by <see cref="DriverHealthReport.Aggregate"/>.</summary>
+public enum ReadinessVerdict
+{
+    /// <summary>All drivers Healthy (or fleet is empty).</summary>
+    Healthy,
+
+    /// <summary>At least one driver Degraded; none Faulted / NotReady.</summary>
+    Degraded,
+
+    /// <summary>At least one driver Unknown / Initializing; none Faulted.</summary>
+    NotReady,
+
+    /// <summary>At least one driver Faulted.</summary>
+    Faulted,
+}

src/ZB.MOM.WW.OtOpcUa.Core/Observability/LogContextEnricher.cs

@@ -0,0 +1,53 @@
+using Serilog.Context;
+using ZB.MOM.WW.OtOpcUa.Core.Abstractions;
+
+namespace ZB.MOM.WW.OtOpcUa.Core.Observability;
+
+/// <summary>
+///     Convenience wrapper around Serilog <see cref="LogContext"/> — attaches the set of
+///     structured properties a capability call should carry (DriverInstanceId, DriverType,
+///     CapabilityName, CorrelationId). Callers wrap their call-site body in a <c>using</c>
+///     block; inner <c>Log.Information</c> / <c>Log.Warning</c> calls emit the context
+///     automatically via the Serilog enricher chain.
+/// </summary>
+/// <remarks>
+///     Per <c>docs/v2/implementation/phase-6-1-resilience-and-observability.md</c> §Stream C.2.
+///     The correlation ID should be the OPC UA <c>RequestHeader.RequestHandle</c> when in-flight;
+///     otherwise a short random GUID. Callers supply whichever is available.
+/// </remarks>
+public static class LogContextEnricher
+{
+    /// <summary>Attach the capability-call property set. Dispose the returned scope to pop.</summary>
+    public static IDisposable Push(string driverInstanceId, string driverType, DriverCapability capability, string correlationId)
+    {
+        ArgumentException.ThrowIfNullOrWhiteSpace(driverInstanceId);
+        ArgumentException.ThrowIfNullOrWhiteSpace(driverType);
+        ArgumentException.ThrowIfNullOrWhiteSpace(correlationId);
+
+        var a = LogContext.PushProperty("DriverInstanceId", driverInstanceId);
+        var b = LogContext.PushProperty("DriverType", driverType);
+        var c = LogContext.PushProperty("CapabilityName", capability.ToString());
+        var d = LogContext.PushProperty("CorrelationId", correlationId);
+        return new CompositeScope(a, b, c, d);
+    }
+
+    /// <summary>
+    ///     Generate a short correlation ID when no OPC UA RequestHandle is available.
+    ///     12-hex-char slice of a GUID — long enough for log correlation, short enough to
+    ///     scan visually.
+    /// </summary>
+    public static string NewCorrelationId() => Guid.NewGuid().ToString("N")[..12];
+
+    private sealed class CompositeScope : IDisposable
+    {
+        private readonly IDisposable[] _inner;
+        public CompositeScope(params IDisposable[] inner) => _inner = inner;
+
+        public void Dispose()
+        {
+            // Reverse-order disposal matches Serilog's stack semantics.
+            for (var i = _inner.Length - 1; i >= 0; i--)
+                _inner[i].Dispose();
+        }
+    }
+}

src/ZB.MOM.WW.OtOpcUa.Core/Resilience/CapabilityInvoker.cs

@@ -1,5 +1,6 @@
 using Polly;
 using ZB.MOM.WW.OtOpcUa.Core.Abstractions;
+using ZB.MOM.WW.OtOpcUa.Core.Observability;
 
 namespace ZB.MOM.WW.OtOpcUa.Core.Resilience;
 
@@ -19,6 +20,7 @@ public sealed class CapabilityInvoker
 {
     private readonly DriverResiliencePipelineBuilder _builder;
     private readonly string _driverInstanceId;
+    private readonly string _driverType;
     private readonly Func<DriverResilienceOptions> _optionsAccessor;
 
     /// <summary>
@@ -30,16 +32,19 @@ public sealed class CapabilityInvoker
     ///     Snapshot accessor for the current resilience options. Invoked per call so Admin-edit +
     ///     pipeline-invalidate can take effect without restarting the invoker.
     /// </param>
+    /// <param name="driverType">Driver type name for structured-log enrichment (e.g. <c>"Modbus"</c>).</param>
     public CapabilityInvoker(
         DriverResiliencePipelineBuilder builder,
         string driverInstanceId,
-        Func<DriverResilienceOptions> optionsAccessor)
+        Func<DriverResilienceOptions> optionsAccessor,
+        string driverType = "Unknown")
     {
         ArgumentNullException.ThrowIfNull(builder);
         ArgumentNullException.ThrowIfNull(optionsAccessor);
 
         _builder = builder;
         _driverInstanceId = driverInstanceId;
+        _driverType = driverType;
         _optionsAccessor = optionsAccessor;
     }
 
@@ -54,8 +59,11 @@ public sealed class CapabilityInvoker
         ArgumentNullException.ThrowIfNull(callSite);
 
         var pipeline = ResolvePipeline(capability, hostName);
+        using (LogContextEnricher.Push(_driverInstanceId, _driverType, capability, LogContextEnricher.NewCorrelationId()))
+        {
             return await pipeline.ExecuteAsync(callSite, cancellationToken).ConfigureAwait(false);
         }
+    }
 
     /// <summary>Execute a void-returning capability call, honoring the per-capability pipeline.</summary>
     public async ValueTask ExecuteAsync(
@@ -67,8 +75,11 @@ public sealed class CapabilityInvoker
         ArgumentNullException.ThrowIfNull(callSite);
 
         var pipeline = ResolvePipeline(capability, hostName);
+        using (LogContextEnricher.Push(_driverInstanceId, _driverType, capability, LogContextEnricher.NewCorrelationId()))
+        {
             await pipeline.ExecuteAsync(callSite, cancellationToken).ConfigureAwait(false);
         }
+    }
 
     /// <summary>
     ///     Execute a <see cref="DriverCapability.Write"/> call honoring <see cref="WriteIdempotentAttribute"/>
@@ -95,8 +106,11 @@ public sealed class CapabilityInvoker
                 },
             };
             var pipeline = _builder.GetOrCreate(_driverInstanceId, $"{hostName}::non-idempotent", DriverCapability.Write, noRetryOptions);
+            using (LogContextEnricher.Push(_driverInstanceId, _driverType, DriverCapability.Write, LogContextEnricher.NewCorrelationId()))
+            {
                 return await pipeline.ExecuteAsync(callSite, cancellationToken).ConfigureAwait(false);
             }
+        }
 
         return await ExecuteAsync(DriverCapability.Write, hostName, callSite, cancellationToken).ConfigureAwait(false);
     }

src/ZB.MOM.WW.OtOpcUa.Core/ZB.MOM.WW.OtOpcUa.Core.csproj

@@ -18,6 +18,7 @@
 
     <ItemGroup>
         <PackageReference Include="Polly.Core" Version="8.6.6"/>
+        <PackageReference Include="Serilog" Version="4.3.0"/>
     </ItemGroup>
 
     <ItemGroup>

src/ZB.MOM.WW.OtOpcUa.Server/Observability/HealthEndpointsHost.cs

@@ -0,0 +1,181 @@
+using System.Net;
+using System.Text;
+using System.Text.Json;
+using Microsoft.Extensions.Logging;
+using ZB.MOM.WW.OtOpcUa.Core.Abstractions;
+using ZB.MOM.WW.OtOpcUa.Core.Hosting;
+using ZB.MOM.WW.OtOpcUa.Core.Observability;
+
+namespace ZB.MOM.WW.OtOpcUa.Server.Observability;
+
+/// <summary>
+///     Standalone <see cref="HttpListener"/> host for <c>/healthz</c> and <c>/readyz</c>
+///     separate from the OPC UA binding. Per <c>docs/v2/implementation/phase-6-1-resilience-
+///     and-observability.md</c> §Stream C.1.
+/// </summary>
+/// <remarks>
+///     Binds to <c>http://localhost:4841</c> by default — loopback avoids the Windows URL-ACL
+///     elevation requirement that binding to <c>http://+:4841</c> (wildcard) would impose.
+///     When a deployment needs remote probing, a reverse proxy or explicit netsh urlacl grant
+///     is the expected path; documented in <c>docs/v2/Server-Deployment.md</c> in a follow-up.
+/// </remarks>
+public sealed class HealthEndpointsHost : IAsyncDisposable
+{
+    private readonly string _prefix;
+    private readonly DriverHost _driverHost;
+    private readonly Func<bool> _configDbHealthy;
+    private readonly Func<bool> _usingStaleConfig;
+    private readonly ILogger<HealthEndpointsHost> _logger;
+    private readonly HttpListener _listener = new();
+    private readonly DateTime _startedUtc = DateTime.UtcNow;
+    private CancellationTokenSource? _cts;
+    private Task? _acceptLoop;
+    private bool _disposed;
+
+    public HealthEndpointsHost(
+        DriverHost driverHost,
+        ILogger<HealthEndpointsHost> logger,
+        Func<bool>? configDbHealthy = null,
+        Func<bool>? usingStaleConfig = null,
+        string prefix = "http://localhost:4841/")
+    {
+        _driverHost = driverHost;
+        _logger = logger;
+        _configDbHealthy = configDbHealthy ?? (() => true);
+        _usingStaleConfig = usingStaleConfig ?? (() => false);
+        _prefix = prefix.EndsWith('/') ? prefix : prefix + "/";
+        _listener.Prefixes.Add(_prefix);
+    }
+
+    public void Start()
+    {
+        _listener.Start();
+        _cts = new CancellationTokenSource();
+        _acceptLoop = Task.Run(() => AcceptLoopAsync(_cts.Token));
+        _logger.LogInformation("Health endpoints listening on {Prefix}", _prefix);
+    }
+
+    private async Task AcceptLoopAsync(CancellationToken ct)
+    {
+        while (!ct.IsCancellationRequested)
+        {
+            HttpListenerContext ctx;
+            try
+            {
+                ctx = await _listener.GetContextAsync().ConfigureAwait(false);
+            }
+            catch (HttpListenerException) when (ct.IsCancellationRequested) { break; }
+            catch (ObjectDisposedException) { break; }
+
+            _ = Task.Run(() => HandleAsync(ctx), ct);
+        }
+    }
+
+    private async Task HandleAsync(HttpListenerContext ctx)
+    {
+        try
+        {
+            var path = ctx.Request.Url?.AbsolutePath ?? "/";
+            switch (path)
+            {
+                case "/healthz":
+                    await WriteHealthzAsync(ctx).ConfigureAwait(false);
+                    break;
+                case "/readyz":
+                    await WriteReadyzAsync(ctx).ConfigureAwait(false);
+                    break;
+                default:
+                    ctx.Response.StatusCode = 404;
+                    break;
+            }
+        }
+        catch (Exception ex)
+        {
+            _logger.LogWarning(ex, "Health endpoint handler failure");
+            try { ctx.Response.StatusCode = 500; } catch { /* ignore */ }
+        }
+        finally
+        {
+            try { ctx.Response.Close(); } catch { /* ignore */ }
+        }
+    }
+
+    private async Task WriteHealthzAsync(HttpListenerContext ctx)
+    {
+        var configHealthy = _configDbHealthy();
+        var staleConfig = _usingStaleConfig();
+        // /healthz is 200 when process alive + (config DB reachable OR cache-warm).
+        // Stale-config still serves 200 so the process isn't flagged dead when the DB
+        // blips; the body surfaces the stale flag for operators.
+        var healthy = configHealthy || staleConfig;
+        ctx.Response.StatusCode = healthy ? 200 : 503;
+
+        var body = JsonSerializer.Serialize(new
+        {
+            status = healthy ? "healthy" : "unhealthy",
+            uptimeSeconds = (int)(DateTime.UtcNow - _startedUtc).TotalSeconds,
+            configDbReachable = configHealthy,
+            usingStaleConfig = staleConfig,
+        });
+        await WriteBodyAsync(ctx, body).ConfigureAwait(false);
+    }
+
+    private async Task WriteReadyzAsync(HttpListenerContext ctx)
+    {
+        var snapshots = BuildSnapshots();
+        var verdict = DriverHealthReport.Aggregate(snapshots);
+        ctx.Response.StatusCode = DriverHealthReport.HttpStatus(verdict);
+
+        var body = JsonSerializer.Serialize(new
+        {
+            verdict = verdict.ToString(),
+            uptimeSeconds = (int)(DateTime.UtcNow - _startedUtc).TotalSeconds,
+            drivers = snapshots.Select(d => new
+            {
+                id = d.DriverInstanceId,
+                state = d.State.ToString(),
+                detail = d.DetailMessage,
+            }).ToArray(),
+            degradedDrivers = snapshots
+                .Where(d => d.State == DriverState.Degraded || d.State == DriverState.Reconnecting)
+                .Select(d => d.DriverInstanceId)
+                .ToArray(),
+        });
+        await WriteBodyAsync(ctx, body).ConfigureAwait(false);
+    }
+
+    private IReadOnlyList<DriverHealthSnapshot> BuildSnapshots()
+    {
+        var list = new List<DriverHealthSnapshot>();
+        foreach (var id in _driverHost.RegisteredDriverIds)
+        {
+            var driver = _driverHost.GetDriver(id);
+            if (driver is null) continue;
+            var health = driver.GetHealth();
+            list.Add(new DriverHealthSnapshot(driver.DriverInstanceId, health.State, health.LastError));
+        }
+        return list;
+    }
+
+    private static async Task WriteBodyAsync(HttpListenerContext ctx, string body)
+    {
+        var bytes = Encoding.UTF8.GetBytes(body);
+        ctx.Response.ContentType = "application/json; charset=utf-8";
+        ctx.Response.ContentLength64 = bytes.LongLength;
+        await ctx.Response.OutputStream.WriteAsync(bytes).ConfigureAwait(false);
+    }
+
+    public async ValueTask DisposeAsync()
+    {
+        if (_disposed) return;
+        _disposed = true;
+        _cts?.Cancel();
+        try { _listener.Stop(); } catch { /* ignore */ }
+        if (_acceptLoop is not null)
+        {
+            try { await _acceptLoop.ConfigureAwait(false); } catch { /* ignore */ }
+        }
+        _listener.Close();
+        _cts?.Dispose();
+    }
+}

src/ZB.MOM.WW.OtOpcUa.Server/OpcUa/OpcUaApplicationHost.cs

@@ -4,6 +4,7 @@ using Opc.Ua.Configuration;
 using ZB.MOM.WW.OtOpcUa.Core.Hosting;
 using ZB.MOM.WW.OtOpcUa.Core.OpcUa;
 using ZB.MOM.WW.OtOpcUa.Core.Resilience;
+using ZB.MOM.WW.OtOpcUa.Server.Observability;
 using ZB.MOM.WW.OtOpcUa.Server.Security;
 
 namespace ZB.MOM.WW.OtOpcUa.Server.OpcUa;
@@ -26,6 +27,7 @@ public sealed class OpcUaApplicationHost : IAsyncDisposable
     private readonly ILogger<OpcUaApplicationHost> _logger;
     private ApplicationInstance? _application;
     private OtOpcUaServer? _server;
+    private HealthEndpointsHost? _healthHost;
     private bool _disposed;
 
     public OpcUaApplicationHost(OpcUaServerOptions options, DriverHost driverHost,
@@ -68,6 +70,17 @@ public sealed class OpcUaApplicationHost : IAsyncDisposable
         _logger.LogInformation("OPC UA server started — endpoint={Endpoint} driverCount={Count}",
             _options.EndpointUrl, _server.DriverNodeManagers.Count);
 
+        // Phase 6.1 Stream C: health endpoints on :4841 (loopback by default — see
+        // HealthEndpointsHost remarks for the Windows URL-ACL tradeoff).
+        if (_options.HealthEndpointsEnabled)
+        {
+            _healthHost = new HealthEndpointsHost(
+                _driverHost,
+                _loggerFactory.CreateLogger<HealthEndpointsHost>(),
+                prefix: _options.HealthEndpointsPrefix);
+            _healthHost.Start();
+        }
+
         // Drive each driver's discovery through its node manager. The node manager IS the
         // IAddressSpaceBuilder; GenericDriverNodeManager captures alarm-condition sinks into
         // its internal map and wires OnAlarmEvent → sink routing.
@@ -221,6 +234,12 @@ public sealed class OpcUaApplicationHost : IAsyncDisposable
         {
             _logger.LogWarning(ex, "OPC UA server stop threw during dispose");
         }
+
+        if (_healthHost is not null)
+        {
+            try { await _healthHost.DisposeAsync().ConfigureAwait(false); }
+            catch (Exception ex) { _logger.LogWarning(ex, "Health endpoints host dispose threw"); }
+        }
         await Task.CompletedTask;
     }
 }

src/ZB.MOM.WW.OtOpcUa.Server/OpcUa/OpcUaServerOptions.cs

@@ -58,6 +58,20 @@ public sealed class OpcUaServerOptions
     /// </summary>
     public bool AutoAcceptUntrustedClientCertificates { get; init; } = true;
 
+    /// <summary>
+    ///     Whether to start the Phase 6.1 Stream C <c>/healthz</c> + <c>/readyz</c> HTTP listener.
+    ///     Defaults to <c>true</c>; set false in embedded deployments that don't need HTTP
+    ///     (e.g. tests that only exercise the OPC UA surface).
+    /// </summary>
+    public bool HealthEndpointsEnabled { get; init; } = true;
+
+    /// <summary>
+    ///     URL prefix the health endpoints bind to. Default <c>http://localhost:4841/</c> — loopback
+    ///     avoids Windows URL-ACL elevation. Production deployments that need remote probing should
+    ///     either reverse-proxy or use <c>http://+:4841/</c> with netsh urlacl granted.
+    /// </summary>
+    public string HealthEndpointsPrefix { get; init; } = "http://localhost:4841/";
+
     /// <summary>
     ///     Security profile advertised on the endpoint. Default <see cref="OpcUaSecurityProfile.None"/>
     ///     preserves the PR 17 endpoint shape; set to <see cref="OpcUaSecurityProfile.Basic256Sha256SignAndEncrypt"/>

src/ZB.MOM.WW.OtOpcUa.Server/OpcUa/OtOpcUaServer.cs

@@ -57,7 +57,7 @@ public sealed class OtOpcUaServer : StandardServer
             // per-type tiers into DriverTypeRegistry. Read ResilienceConfig JSON from the
             // DriverInstance row in a follow-up PR; for now every driver gets Tier A defaults.
             var options = new DriverResilienceOptions { Tier = DriverTier.A };
-            var invoker = new CapabilityInvoker(_pipelineBuilder, driver.DriverInstanceId, () => options);
+            var invoker = new CapabilityInvoker(_pipelineBuilder, driver.DriverInstanceId, () => options, driver.DriverType);
             var manager = new DriverNodeManager(server, configuration, driver, invoker, logger);
             _driverNodeManagers.Add(manager);
         }

src/ZB.MOM.WW.OtOpcUa.Server/Program.cs

@@ -4,6 +4,7 @@ using Microsoft.Extensions.DependencyInjection;
 using Microsoft.Extensions.Hosting;
 using Microsoft.Extensions.Logging;
 using Serilog;
+using Serilog.Formatting.Compact;
 using ZB.MOM.WW.OtOpcUa.Configuration;
 using ZB.MOM.WW.OtOpcUa.Configuration.LocalCache;
 using ZB.MOM.WW.OtOpcUa.Core.Hosting;
@@ -13,11 +14,25 @@ using ZB.MOM.WW.OtOpcUa.Server.Security;
 
 var builder = Host.CreateApplicationBuilder(args);
 
-Log.Logger = new LoggerConfiguration()
+// Per Phase 6.1 Stream C.3: SIEMs (Splunk, Datadog) ingest the JSON file without a
+// regex parser. Plain-text rolling file stays on by default for human readability;
+// JSON file is opt-in via appsetting `Serilog:WriteJson = true`.
+var writeJson = builder.Configuration.GetValue<bool>("Serilog:WriteJson");
+var loggerBuilder = new LoggerConfiguration()
     .ReadFrom.Configuration(builder.Configuration)
+    .Enrich.FromLogContext()
     .WriteTo.Console()
-    .WriteTo.File("logs/otopcua-.log", rollingInterval: RollingInterval.Day)
-    .CreateLogger();
+    .WriteTo.File("logs/otopcua-.log", rollingInterval: RollingInterval.Day);
+
+if (writeJson)
+{
+    loggerBuilder = loggerBuilder.WriteTo.File(
+        new CompactJsonFormatter(),
+        "logs/otopcua-.json.log",
+        rollingInterval: RollingInterval.Day);
+}
+
+Log.Logger = loggerBuilder.CreateLogger();
 
 builder.Services.AddSerilog();
 builder.Services.AddWindowsService(o => o.ServiceName = "OtOpcUa");

src/ZB.MOM.WW.OtOpcUa.Server/ZB.MOM.WW.OtOpcUa.Server.csproj

@@ -21,6 +21,7 @@
         <PackageReference Include="Serilog.Settings.Configuration" Version="9.0.0"/>
         <PackageReference Include="Serilog.Sinks.Console" Version="6.0.0"/>
         <PackageReference Include="Serilog.Sinks.File" Version="7.0.0"/>
+        <PackageReference Include="Serilog.Formatting.Compact" Version="3.0.0"/>
         <PackageReference Include="OPCFoundation.NetStandard.Opc.Ua.Server" Version="1.5.374.126"/>
         <PackageReference Include="OPCFoundation.NetStandard.Opc.Ua.Configuration" Version="1.5.374.126"/>
         <PackageReference Include="Novell.Directory.Ldap.NETStandard" Version="3.6.0"/>

tests/ZB.MOM.WW.OtOpcUa.Core.Tests/Observability/CapabilityInvokerEnrichmentTests.cs

@@ -0,0 +1,72 @@
+using Serilog;
+using Serilog.Core;
+using Serilog.Events;
+using Shouldly;
+using Xunit;
+using ZB.MOM.WW.OtOpcUa.Core.Abstractions;
+using ZB.MOM.WW.OtOpcUa.Core.Resilience;
+
+namespace ZB.MOM.WW.OtOpcUa.Core.Tests.Observability;
+
+[Trait("Category", "Integration")]
+public sealed class CapabilityInvokerEnrichmentTests
+{
+    [Fact]
+    public async Task InvokerExecute_LogsInsideCallSite_CarryStructuredProperties()
+    {
+        var sink = new InMemorySink();
+        var logger = new LoggerConfiguration()
+            .Enrich.FromLogContext()
+            .WriteTo.Sink(sink)
+            .CreateLogger();
+
+        var invoker = new CapabilityInvoker(
+            new DriverResiliencePipelineBuilder(),
+            driverInstanceId: "drv-live",
+            optionsAccessor: () => new DriverResilienceOptions { Tier = DriverTier.A },
+            driverType: "Modbus");
+
+        await invoker.ExecuteAsync(
+            DriverCapability.Read,
+            "plc-1",
+            ct =>
+            {
+                logger.Information("inside call site");
+                return ValueTask.FromResult(42);
+            },
+            CancellationToken.None);
+
+        var evt = sink.Events.ShouldHaveSingleItem();
+        evt.Properties["DriverInstanceId"].ToString().ShouldBe("\"drv-live\"");
+        evt.Properties["DriverType"].ToString().ShouldBe("\"Modbus\"");
+        evt.Properties["CapabilityName"].ToString().ShouldBe("\"Read\"");
+        evt.Properties.ShouldContainKey("CorrelationId");
+    }
+
+    [Fact]
+    public async Task InvokerExecute_DoesNotLeak_ContextOutsideCallSite()
+    {
+        var sink = new InMemorySink();
+        var logger = new LoggerConfiguration()
+            .Enrich.FromLogContext()
+            .WriteTo.Sink(sink)
+            .CreateLogger();
+
+        var invoker = new CapabilityInvoker(
+            new DriverResiliencePipelineBuilder(),
+            driverInstanceId: "drv-a",
+            optionsAccessor: () => new DriverResilienceOptions { Tier = DriverTier.A });
+
+        await invoker.ExecuteAsync(DriverCapability.Read, "host", _ => ValueTask.FromResult(1), CancellationToken.None);
+        logger.Information("outside");
+
+        var outside = sink.Events.ShouldHaveSingleItem();
+        outside.Properties.ContainsKey("DriverInstanceId").ShouldBeFalse();
+    }
+
+    private sealed class InMemorySink : ILogEventSink
+    {
+        public List<LogEvent> Events { get; } = [];
+        public void Emit(LogEvent logEvent) => Events.Add(logEvent);
+    }
+}

tests/ZB.MOM.WW.OtOpcUa.Core.Tests/Observability/DriverHealthReportTests.cs

@@ -0,0 +1,70 @@
+using Shouldly;
+using Xunit;
+using ZB.MOM.WW.OtOpcUa.Core.Abstractions;
+using ZB.MOM.WW.OtOpcUa.Core.Observability;
+
+namespace ZB.MOM.WW.OtOpcUa.Core.Tests.Observability;
+
+[Trait("Category", "Unit")]
+public sealed class DriverHealthReportTests
+{
+    [Fact]
+    public void EmptyFleet_IsHealthy()
+    {
+        DriverHealthReport.Aggregate([]).ShouldBe(ReadinessVerdict.Healthy);
+    }
+
+    [Fact]
+    public void AllHealthy_Fleet_IsHealthy()
+    {
+        var verdict = DriverHealthReport.Aggregate([
+            new DriverHealthSnapshot("a", DriverState.Healthy),
+            new DriverHealthSnapshot("b", DriverState.Healthy),
+        ]);
+        verdict.ShouldBe(ReadinessVerdict.Healthy);
+    }
+
+    [Fact]
+    public void AnyFaulted_TrumpsEverything()
+    {
+        var verdict = DriverHealthReport.Aggregate([
+            new DriverHealthSnapshot("a", DriverState.Healthy),
+            new DriverHealthSnapshot("b", DriverState.Degraded),
+            new DriverHealthSnapshot("c", DriverState.Faulted),
+            new DriverHealthSnapshot("d", DriverState.Initializing),
+        ]);
+        verdict.ShouldBe(ReadinessVerdict.Faulted);
+    }
+
+    [Theory]
+    [InlineData(DriverState.Unknown)]
+    [InlineData(DriverState.Initializing)]
+    public void Any_NotReady_WithoutFaulted_IsNotReady(DriverState initializingState)
+    {
+        var verdict = DriverHealthReport.Aggregate([
+            new DriverHealthSnapshot("a", DriverState.Healthy),
+            new DriverHealthSnapshot("b", initializingState),
+        ]);
+        verdict.ShouldBe(ReadinessVerdict.NotReady);
+    }
+
+    [Fact]
+    public void Any_Degraded_WithoutFaultedOrNotReady_IsDegraded()
+    {
+        var verdict = DriverHealthReport.Aggregate([
+            new DriverHealthSnapshot("a", DriverState.Healthy),
+            new DriverHealthSnapshot("b", DriverState.Degraded),
+        ]);
+        verdict.ShouldBe(ReadinessVerdict.Degraded);
+    }
+
+    [Theory]
+    [InlineData(ReadinessVerdict.Healthy, 200)]
+    [InlineData(ReadinessVerdict.Degraded, 200)]
+    [InlineData(ReadinessVerdict.NotReady, 503)]
+    [InlineData(ReadinessVerdict.Faulted, 503)]
+    public void HttpStatus_MatchesStateMatrix(ReadinessVerdict verdict, int expected)
+    {
+        DriverHealthReport.HttpStatus(verdict).ShouldBe(expected);
+    }
+}

tests/ZB.MOM.WW.OtOpcUa.Core.Tests/Observability/LogContextEnricherTests.cs

@@ -0,0 +1,78 @@
+using Serilog;
+using Serilog.Core;
+using Serilog.Events;
+using Shouldly;
+using Xunit;
+using ZB.MOM.WW.OtOpcUa.Core.Abstractions;
+using ZB.MOM.WW.OtOpcUa.Core.Observability;
+
+namespace ZB.MOM.WW.OtOpcUa.Core.Tests.Observability;
+
+[Trait("Category", "Unit")]
+public sealed class LogContextEnricherTests
+{
+    [Fact]
+    public void Scope_Attaches_AllFour_Properties()
+    {
+        var captured = new InMemorySink();
+        var logger = new LoggerConfiguration()
+            .Enrich.FromLogContext()
+            .WriteTo.Sink(captured)
+            .CreateLogger();
+
+        using (LogContextEnricher.Push("drv-1", "Modbus", DriverCapability.Read, "abc123"))
+        {
+            logger.Information("test message");
+        }
+
+        var evt = captured.Events.ShouldHaveSingleItem();
+        evt.Properties["DriverInstanceId"].ToString().ShouldBe("\"drv-1\"");
+        evt.Properties["DriverType"].ToString().ShouldBe("\"Modbus\"");
+        evt.Properties["CapabilityName"].ToString().ShouldBe("\"Read\"");
+        evt.Properties["CorrelationId"].ToString().ShouldBe("\"abc123\"");
+    }
+
+    [Fact]
+    public void Scope_Dispose_Pops_Properties()
+    {
+        var captured = new InMemorySink();
+        var logger = new LoggerConfiguration()
+            .Enrich.FromLogContext()
+            .WriteTo.Sink(captured)
+            .CreateLogger();
+
+        using (LogContextEnricher.Push("drv-1", "Modbus", DriverCapability.Read, "abc123"))
+        {
+            logger.Information("inside");
+        }
+        logger.Information("outside");
+
+        captured.Events.Count.ShouldBe(2);
+        captured.Events[0].Properties.ContainsKey("DriverInstanceId").ShouldBeTrue();
+        captured.Events[1].Properties.ContainsKey("DriverInstanceId").ShouldBeFalse();
+    }
+
+    [Fact]
+    public void NewCorrelationId_Returns_12_Hex_Chars()
+    {
+        var id = LogContextEnricher.NewCorrelationId();
+        id.Length.ShouldBe(12);
+        id.ShouldMatch("^[0-9a-f]{12}$");
+    }
+
+    [Theory]
+    [InlineData(null)]
+    [InlineData("")]
+    [InlineData("   ")]
+    public void Push_Throws_OnMissingDriverInstanceId(string? id)
+    {
+        Should.Throw<ArgumentException>(() =>
+            LogContextEnricher.Push(id!, "Modbus", DriverCapability.Read, "c"));
+    }
+
+    private sealed class InMemorySink : ILogEventSink
+    {
+        public List<LogEvent> Events { get; } = [];
+        public void Emit(LogEvent logEvent) => Events.Add(logEvent);
+    }
+}

tests/ZB.MOM.WW.OtOpcUa.Server.Tests/HealthEndpointsHostTests.cs

@@ -0,0 +1,177 @@
+using System.Net.Http;
+using System.Text.Json;
+using Microsoft.Extensions.Logging.Abstractions;
+using Shouldly;
+using Xunit;
+using ZB.MOM.WW.OtOpcUa.Core.Abstractions;
+using ZB.MOM.WW.OtOpcUa.Core.Hosting;
+using ZB.MOM.WW.OtOpcUa.Server.Observability;
+
+namespace ZB.MOM.WW.OtOpcUa.Server.Tests;
+
+[Trait("Category", "Integration")]
+public sealed class HealthEndpointsHostTests : IAsyncLifetime
+{
+    private static int _portCounter = 48500 + Random.Shared.Next(0, 99);
+    private readonly int _port = Interlocked.Increment(ref _portCounter);
+    private string Prefix => $"http://localhost:{_port}/";
+    private readonly DriverHost _driverHost = new();
+    private HealthEndpointsHost _host = null!;
+    private HttpClient _client = null!;
+
+    public ValueTask InitializeAsync()
+    {
+        _client = new HttpClient { BaseAddress = new Uri(Prefix) };
+        return ValueTask.CompletedTask;
+    }
+
+    public async ValueTask DisposeAsync()
+    {
+        _client.Dispose();
+        if (_host is not null) await _host.DisposeAsync();
+    }
+
+    private HealthEndpointsHost Start(Func<bool>? configDbHealthy = null, Func<bool>? usingStaleConfig = null)
+    {
+        _host = new HealthEndpointsHost(
+            _driverHost,
+            NullLogger<HealthEndpointsHost>.Instance,
+            configDbHealthy,
+            usingStaleConfig,
+            prefix: Prefix);
+        _host.Start();
+        return _host;
+    }
+
+    [Fact]
+    public async Task Healthz_ReturnsHealthy_EmptyFleet()
+    {
+        Start();
+
+        var response = await _client.GetAsync("/healthz");
+
+        response.IsSuccessStatusCode.ShouldBeTrue();
+        var body = JsonDocument.Parse(await response.Content.ReadAsStringAsync()).RootElement;
+        body.GetProperty("status").GetString().ShouldBe("healthy");
+        body.GetProperty("configDbReachable").GetBoolean().ShouldBeTrue();
+        body.GetProperty("usingStaleConfig").GetBoolean().ShouldBeFalse();
+    }
+
+    [Fact]
+    public async Task Healthz_StaleConfig_Returns200_WithFlag()
+    {
+        Start(configDbHealthy: () => false, usingStaleConfig: () => true);
+
+        var response = await _client.GetAsync("/healthz");
+
+        response.StatusCode.ShouldBe(System.Net.HttpStatusCode.OK);
+        var body = JsonDocument.Parse(await response.Content.ReadAsStringAsync()).RootElement;
+        body.GetProperty("configDbReachable").GetBoolean().ShouldBeFalse();
+        body.GetProperty("usingStaleConfig").GetBoolean().ShouldBeTrue();
+    }
+
+    [Fact]
+    public async Task Healthz_UnreachableConfig_And_NoCache_Returns503()
+    {
+        Start(configDbHealthy: () => false, usingStaleConfig: () => false);
+
+        var response = await _client.GetAsync("/healthz");
+
+        response.StatusCode.ShouldBe(System.Net.HttpStatusCode.ServiceUnavailable);
+    }
+
+    [Fact]
+    public async Task Readyz_EmptyFleet_Is200_Healthy()
+    {
+        Start();
+
+        var response = await _client.GetAsync("/readyz");
+
+        response.StatusCode.ShouldBe(System.Net.HttpStatusCode.OK);
+        var body = JsonDocument.Parse(await response.Content.ReadAsStringAsync()).RootElement;
+        body.GetProperty("verdict").GetString().ShouldBe("Healthy");
+    }
+
+    [Fact]
+    public async Task Readyz_WithHealthyDriver_Is200()
+    {
+        await _driverHost.RegisterAsync(new StubDriver("drv-1", DriverState.Healthy), "{}", CancellationToken.None);
+        Start();
+
+        var response = await _client.GetAsync("/readyz");
+
+        response.StatusCode.ShouldBe(System.Net.HttpStatusCode.OK);
+        var body = JsonDocument.Parse(await response.Content.ReadAsStringAsync()).RootElement;
+        body.GetProperty("verdict").GetString().ShouldBe("Healthy");
+        body.GetProperty("drivers").GetArrayLength().ShouldBe(1);
+    }
+
+    [Fact]
+    public async Task Readyz_WithFaultedDriver_Is503()
+    {
+        await _driverHost.RegisterAsync(new StubDriver("dead", DriverState.Faulted), "{}", CancellationToken.None);
+        await _driverHost.RegisterAsync(new StubDriver("alive", DriverState.Healthy), "{}", CancellationToken.None);
+        Start();
+
+        var response = await _client.GetAsync("/readyz");
+
+        response.StatusCode.ShouldBe(System.Net.HttpStatusCode.ServiceUnavailable);
+        var body = JsonDocument.Parse(await response.Content.ReadAsStringAsync()).RootElement;
+        body.GetProperty("verdict").GetString().ShouldBe("Faulted");
+    }
+
+    [Fact]
+    public async Task Readyz_WithDegradedDriver_Is200_WithDegradedList()
+    {
+        await _driverHost.RegisterAsync(new StubDriver("drv-ok", DriverState.Healthy), "{}", CancellationToken.None);
+        await _driverHost.RegisterAsync(new StubDriver("drv-deg", DriverState.Degraded), "{}", CancellationToken.None);
+        Start();
+
+        var response = await _client.GetAsync("/readyz");
+
+        response.StatusCode.ShouldBe(System.Net.HttpStatusCode.OK);
+        var body = JsonDocument.Parse(await response.Content.ReadAsStringAsync()).RootElement;
+        body.GetProperty("verdict").GetString().ShouldBe("Degraded");
+        body.GetProperty("degradedDrivers").GetArrayLength().ShouldBe(1);
+        body.GetProperty("degradedDrivers")[0].GetString().ShouldBe("drv-deg");
+    }
+
+    [Fact]
+    public async Task Readyz_WithInitializingDriver_Is503()
+    {
+        await _driverHost.RegisterAsync(new StubDriver("init", DriverState.Initializing), "{}", CancellationToken.None);
+        Start();
+
+        var response = await _client.GetAsync("/readyz");
+
+        response.StatusCode.ShouldBe(System.Net.HttpStatusCode.ServiceUnavailable);
+    }
+
+    [Fact]
+    public async Task Unknown_Path_Returns404()
+    {
+        Start();
+
+        var response = await _client.GetAsync("/foo");
+
+        response.StatusCode.ShouldBe(System.Net.HttpStatusCode.NotFound);
+    }
+
+    private sealed class StubDriver : IDriver
+    {
+        private readonly DriverState _state;
+        public StubDriver(string id, DriverState state)
+        {
+            DriverInstanceId = id;
+            _state = state;
+        }
+        public string DriverInstanceId { get; }
+        public string DriverType => "Stub";
+        public Task InitializeAsync(string _, CancellationToken ct) => Task.CompletedTask;
+        public Task ReinitializeAsync(string _, CancellationToken ct) => Task.CompletedTask;
+        public Task ShutdownAsync(CancellationToken ct) => Task.CompletedTask;
+        public DriverHealth GetHealth() => new(_state, null, null);
+        public long GetMemoryFootprint() => 0;
+        public Task FlushOptionalCachesAsync(CancellationToken ct) => Task.CompletedTask;
+    }
+}

tests/ZB.MOM.WW.OtOpcUa.Server.Tests/HistoryReadIntegrationTests.cs

@@ -46,7 +46,7 @@ public sealed class HistoryReadIntegrationTests : IAsyncLifetime
             ApplicationName = "OtOpcUaHistoryTest",
             ApplicationUri = "urn:OtOpcUa:Server:HistoryTest",
             PkiStoreRoot = _pkiRoot,
-            AutoAcceptUntrustedClientCertificates = true,
+            AutoAcceptUntrustedClientCertificates = true, HealthEndpointsEnabled = false,
         };
 
         _server = new OpcUaApplicationHost(options, _driverHost, new DenyAllUserAuthenticator(),

tests/ZB.MOM.WW.OtOpcUa.Server.Tests/MultipleDriverInstancesIntegrationTests.cs

@@ -49,7 +49,7 @@ public sealed class MultipleDriverInstancesIntegrationTests : IAsyncLifetime
             ApplicationName = "OtOpcUaMultiDriverTest",
             ApplicationUri = "urn:OtOpcUa:Server:MultiDriverTest",
             PkiStoreRoot = _pkiRoot,
-            AutoAcceptUntrustedClientCertificates = true,
+            AutoAcceptUntrustedClientCertificates = true, HealthEndpointsEnabled = false,
         };
 
         _server = new OpcUaApplicationHost(options, _driverHost, new DenyAllUserAuthenticator(),

tests/ZB.MOM.WW.OtOpcUa.Server.Tests/OpcUaServerIntegrationTests.cs

@@ -36,7 +36,7 @@ public sealed class OpcUaServerIntegrationTests : IAsyncLifetime
             ApplicationName = "OtOpcUaTest",
             ApplicationUri = "urn:OtOpcUa:Server:Test",
             PkiStoreRoot = _pkiRoot,
-            AutoAcceptUntrustedClientCertificates = true,
+            AutoAcceptUntrustedClientCertificates = true, HealthEndpointsEnabled = false,
         };
 
         _server = new OpcUaApplicationHost(options, _driverHost, new DenyAllUserAuthenticator(),