docs(telemetry): Telemetry(.Serilog) 0.2.0 published; ScadaBridge on AddZbSerilog (ScadaBridge#94, scadaproj#12)
Both packages published to the feed 2026-11-12, packed from 01c6dc1 (the 0.2.0
code + corrected RepositoryUrl, before the 0.2.1 commit); SHA256 of the feed
download matches the local pack. ScadaBridge switched to AddZbSerilog with the
MinimumLevelGovernor + ConfigureLogger hooks (main 2d2e9f35) and deleted its
LoggerConfigurationFactory. Updates the Observability row, Telemetry/CLAUDE.md
and components/observability/GAPS.md.
Claude-Session: https://claude.ai/code/session_01GT67ACmpMR7b9LGRPLijMi
This commit is contained in:
@@ -6,7 +6,7 @@ Observability libraries for the **ZB.MOM.WW SCADA family** (OtOpcUa, MxAccessGat
|
||||
|
||||
The library normalizes the three-project observability surface: a shared OpenTelemetry Resource driven by a single identity triple (`service.name` / `site.id` / `node.role`), standard instrumentation wiring, Prometheus and OTLP export, and a Serilog bootstrap with enrichers and `TraceContextEnricher` for trace↔log correlation.
|
||||
|
||||
**Built at 0.1.0, published to the Gitea NuGet feed, and adopted across all three apps on 2026-06-01** (branch `feat/adopt-zb-telemetry` per repo, behaviour-preserving). MxAccessGateway's MEL→Serilog migration + metrics export both landed in this pass — they were *not* actually done beforehand despite the earlier claim. ScadaBridge keeps its `LoggerConfigurationFactory` (min-level governance) and only adds the shared `TraceContextEnricher`; it does not call `AddZbSerilog`. Per-repo result + deferred follow-ons tracked in `~/Desktop/scadaproj/components/observability/GAPS.md`.
|
||||
**Built at 0.1.0, published to the Gitea NuGet feed, and adopted across all three apps on 2026-06-01** (branch `feat/adopt-zb-telemetry` per repo, behaviour-preserving). MxAccessGateway's MEL→Serilog migration + metrics export both landed in this pass — they were *not* actually done beforehand despite the earlier claim. ScadaBridge kept its own `LoggerConfigurationFactory` until **2026-11-12**, when it switched to `AddZbSerilog` 0.2.0 (ScadaBridge#94). Per-repo result + deferred follow-ons tracked in `~/Desktop/scadaproj/components/observability/GAPS.md`.
|
||||
|
||||
---
|
||||
|
||||
@@ -25,12 +25,12 @@ The library normalizes the three-project observability surface: a shared OpenTel
|
||||
|---|:---:|:---:|
|
||||
| **OtOpcUa** | ✅ adopted | ✅ adopted (`AddZbSerilog`) |
|
||||
| **MxAccessGateway** | ✅ adopted (`GatewayMetrics` exported) | ✅ adopted (MEL→Serilog migrated in this pass) |
|
||||
| **ScadaBridge** | ✅ adopted (both roots) | ⚠️ referenced for `TraceContextEnricher` only — keeps `LoggerConfigurationFactory`, does **not** call `AddZbSerilog` |
|
||||
| **ScadaBridge** | ✅ adopted (both roots) | ✅ `AddZbSerilog` **0.2.0** (2026-11-12, ScadaBridge#94, `main` `2d2e9f35`) — `MinimumLevelGovernor` + `ConfigureLogger` (standby filter); run on a pre-host builder so the static `Log.Logger` stays the one process logger |
|
||||
| **HistorianGateway** | ✅ adopted | ✅ adopted (`AddZbSerilog`) |
|
||||
|
||||
All three adopted on 2026-06-01 (branch `feat/adopt-zb-telemetry` per repo); HistorianGateway adopted since. All four pin both packages at `0.1.0` on their origin default branches (verified 2026-11-09). ScadaBridge's logging
|
||||
deviates: it keeps its own `LoggerConfigurationFactory` (min-level governance contract) and only
|
||||
adds the shared `TraceContextEnricher`. See `components/observability/GAPS.md` for the full result.
|
||||
All three adopted on 2026-06-01 (branch `feat/adopt-zb-telemetry` per repo); HistorianGateway adopted since. OtOpcUa, MxAccessGateway and HistorianGateway pin both packages at `0.1.0` on their origin default branches
|
||||
(verified 2026-11-09; their `AddZbSerilog(o => …)` call sites are source-compatible with 0.2.0 — the new overload is
|
||||
additive). ScadaBridge pins **`0.2.0`** since 2026-11-12. See `components/observability/GAPS.md` for the full result.
|
||||
|
||||
---
|
||||
|
||||
@@ -71,7 +71,11 @@ endpoint must be `http`/`https` with a host (`collector:4317` is now rejected) a
|
||||
`AddZbTelemetry(services, options)` overload validates `ServiceName` + endpoint like the lambda overloads (011).
|
||||
**Behaviour change:** a scheme-less OTLP endpoint that previously passed validation now throws at startup.
|
||||
|
||||
**`0.2.0` (2026-11-09, scadaproj#12) — built, NOT published** (feed carries `0.1.0` only). Additive:
|
||||
**`0.2.0` (2026-11-09, scadaproj#12) — PUBLISHED 2026-11-12** (both packages, packed from `01c6dc1` — the
|
||||
0.2.0 code plus the corrected RepositoryUrl, i.e. before the 0.2.1 commit `1786bab`; 12 + 30 tests green in Release).
|
||||
SHA256: `ZB.MOM.WW.Telemetry.0.2.0.nupkg` `71749cb3c34a0d0aba3eca43a6c12398b427f494e8c4c6f216db0be7d3ab40dc`,
|
||||
`ZB.MOM.WW.Telemetry.Serilog.0.2.0.nupkg` `2aef391e7ab28061c5b3365c62c73e5c972ba8bcecd88bd0e0471550cfcc40c0`
|
||||
(feed download matches the local pack). First consumer: ScadaBridge (#94). Additive:
|
||||
a new `AddZbSerilog(builder, configure, configureSerilog)` overload taking `ZbSerilogOptions` —
|
||||
`MinimumLevelGovernor` (`Func<IConfiguration, LogEventLevel?>`, applied with `MinimumLevel.Is`
|
||||
AFTER `ReadFrom.Configuration`, so an app-owned key outranks `Serilog:MinimumLevel`; `null` defers to
|
||||
|
||||
Reference in New Issue
Block a user