Joseph Doherty
9cff87fe85
Remove project bookkeeping citations from shipped code comments across the solution: hyphenated task IDs (WP-14, StoreAndForward-025), milestone/task/ issue refs (M3, Task 4, Audit Log #23, #21), Bundle X task-bundle labels, and C/D/K/S/T phase labels. Comment text only — no code logic, string/log literals, or XML-doc structure changed. Genuine descriptions are preserved (only the citation is stripped), and technical lookalikes are retained (UTF-8, SHA-256, T00:00:00, M365, UTC-5, pre-C4/pre-C5 schema versions). Flagged by the new CommentChecker TaskReferenceInComment / TrackingReferenceInComment checks plus targeted grep passes; full solution builds clean, append-only guard tests pass.
38 lines
1.6 KiB
C#
38 lines
1.6 KiB
C#
using ZB.MOM.WW.ScadaBridge.HealthMonitoring;
|
|
|
|
namespace ZB.MOM.WW.ScadaBridge.AuditLog.Site;
|
|
|
|
/// <summary>
|
|
/// Bridges <see cref="IAuditWriteFailureCounter"/>
|
|
/// (incremented by <see cref="FallbackAuditWriter"/> every time the primary
|
|
/// SQLite writer throws) into <see cref="ISiteHealthCollector"/> so the count
|
|
/// surfaces in the site health report payload as
|
|
/// <c>SiteHealthReport.SiteAuditWriteFailures</c>.
|
|
/// </summary>
|
|
/// <remarks>
|
|
/// <para>
|
|
/// Registered by <see cref="ServiceCollectionExtensions.AddAuditLogHealthMetricsBridge"/>;
|
|
/// callers must register <c>AddHealthMonitoring()</c> first so
|
|
/// <see cref="ISiteHealthCollector"/> resolves. The default <see cref="AddAuditLog"/>
|
|
/// registration keeps <see cref="NoOpAuditWriteFailureCounter"/> for nodes
|
|
/// where Site Health Monitoring is not wired (the silent-sink contract — audit
|
|
/// write failures must NEVER abort the user-facing action, alog.md §7).
|
|
/// </para>
|
|
/// </remarks>
|
|
public sealed class HealthMetricsAuditWriteFailureCounter : IAuditWriteFailureCounter
|
|
{
|
|
private readonly ISiteHealthCollector _collector;
|
|
|
|
/// <summary>
|
|
/// Initializes a new <see cref="HealthMetricsAuditWriteFailureCounter"/> backed by the given health collector.
|
|
/// </summary>
|
|
/// <param name="collector">The site health collector to increment on each audit write failure.</param>
|
|
public HealthMetricsAuditWriteFailureCounter(ISiteHealthCollector collector)
|
|
{
|
|
_collector = collector ?? throw new ArgumentNullException(nameof(collector));
|
|
}
|
|
|
|
/// <inheritdoc/>
|
|
public void Increment() => _collector.IncrementSiteAuditWriteFailures();
|
|
}
|