Commit Graph

840 Commits

Author SHA1 Message Date
Joseph Doherty 53013eb2d8 docs(index): OtOpcUa DEV vd03 at 6c4d2990 (read-only historian bindings); lmxopcua#700 closed
Claude-Session: https://claude.ai/code/session_01GT67ACmpMR7b9LGRPLijMi
2026-11-13 01:37:13 -05:00
Joseph Doherty 178ef651f9 docs(index): HistorianGateway Contracts + Client 1.1.0 published (historiangw#135)
Claude-Session: https://claude.ai/code/session_01GT67ACmpMR7b9LGRPLijMi
2026-11-13 01:36:21 -05:00
Joseph Doherty 6d3fcaaa73 docs(index): mxaccessgw QA vq03/vq04 on 76a71bc8 (mxaccessgw#229, #170)
Claude-Session: https://claude.ai/code/session_01GT67ACmpMR7b9LGRPLijMi
2026-11-12 23:48:32 -05:00
Joseph Doherty 4909946104 docs(overview): Phase 4 live acceptance complete - OtOpcUa one-Active + leader/split-brain chips pass (#14)
Re-ran the two design 9 checks that were blocked for OtOpcUa on 2026-07-24, against a
docker-dev rig from OtOpcUa master 412da27c (Health 0.3.0) with the dashboard in a
container on the rig network:

1. one Active per pair: exactly one /health/active 200 per mesh (MAIN central-2,
   SITE-A site-a-1, SITE-B site-b-1), dashboard shows one ACTIVE + one STANDBY each;
2. leader chip on every group; network-partitioning site-b-2 from site-b-1 produced
   two 1-member clusters, both Active, and the SPLIT BRAIN chip, which cleared once
   site-b-2 was restarted (healing the link alone does not merge two Akka clusters,
   the documented OtOpcUa recovery); stopping site-a-1 moved the SITE-A chip.

Evidence (screenshots, /health/active bodies, timeline) under
docs/plans/evidence/2026-11-12-overview-phase4/. Ledger task 20 -> completed (20/20).

Claude-Session: https://claude.ai/code/session_01GT67ACmpMR7b9LGRPLijMi
2026-11-12 22:47:13 -05:00
Joseph Doherty 2859d9ebfc docs(history): ScadaBridge OPC UA client on SDK 2.0.1 (ScadaBridge#125 closed, a2e9d718)
Claude-Session: https://claude.ai/code/session_01GT67ACmpMR7b9LGRPLijMi
2026-11-12 22:24:07 -05:00
Joseph Doherty 41a5e4d187 docs(observability): Telemetry 0.3.1 published, adopted by all four apps, export spans gone at the collector (#56)
Claude-Session: https://claude.ai/code/session_01GT67ACmpMR7b9LGRPLijMi
2026-11-12 22:21:07 -05:00
Joseph Doherty 71b8595742 feat(infra): per-box OTel collector on the wonder tiers; apps switched to OTLP (#54)
ZbOtelCollector (otelcol-contrib 0.162.0, NSSM, NT SERVICE\ZbOtelCollector, every
listener on 127.0.0.1, file + Prometheus exporters, size-capped rotation) on DEV
vd03 and QA vq03/vq04. OtOpcUa, ScadaBridge Central + Site, MxAccessGateway and
HistorianGateway export OTLP to http://127.0.0.1:4317 via two service-env entries
each; rolling restarts, standby-first on the QA pairs. Overview has no exporter
binding and is unchanged. Config, install/switch/verify scripts, runbook and the
dated rollout record under infra/otel-collector/wonder/; evidence doc, GAPS,
index row and deployment.md updated.

Claude-Session: https://claude.ai/code/session_01GT67ACmpMR7b9LGRPLijMi
2026-11-12 22:10:15 -05:00
Joseph Doherty 85654d7b43 fix(telemetry): 0.3.1 OTLP export calls are not traced as client spans (#56)
The Serilog OTLP log sink is not part of the OTel SDK and does not run
inside SuppressInstrumentationScope, so every log batch produced a root
opentelemetry.proto.collector.logs.v1.LogsService/Export gRPC client span.

AddZbTelemetry now drops telemetry's own transport from tracing:
- HttpClient instrumentation: FilterHttpRequestMessage rejects export calls
- gRPC client instrumentation (no Filter option): the start-time
  EnrichWithHttpRequestMessage callback clears Recorded/IsAllDataRequested,
  which also leaves the child HTTP activity unsampled.
An export call is any /opentelemetry.proto.collector.* path, or an
OTLP/HTTP /v1/{traces,metrics,logs} path on the configured endpoint's
host:port (ZbOtlpExportCallFilter). Every other outgoing call keeps its span.

Tests: predicate theory + an end-to-end run against a loopback OTLP
receiver with positive controls (app gRPC + HttpClient calls traced) and
negatives (the real log-sink export, /v1/logs, gRPC path over HttpClient);
mutation-checked three ways.

Claude-Session: https://claude.ai/code/session_01GT67ACmpMR7b9LGRPLijMi
2026-11-12 22:09:24 -05:00
Joseph Doherty d93ca7b8c2 docs(observability): ScadaBridge Central role over OTLP proven on the rig (ScadaBridge#133)
Metrics, traces and logs from both rig centrals with node.role=Central and site.id=central;
deployments.applied and inbound_api.requests arrive. Follow-ups scadaproj#56 (log-export
self-spans) and ScadaBridge#134 (rig image lacks git SHA).

Claude-Session: https://claude.ai/code/session_01GT67ACmpMR7b9LGRPLijMi
2026-11-12 21:49:33 -05:00
Joseph Doherty ca81dcbdd2 docs(observability): correct the 0.3.0 library commit SHAs after rebase (#55)
Claude-Session: https://claude.ai/code/session_01GT67ACmpMR7b9LGRPLijMi
2026-11-12 21:29:37 -05:00
Joseph Doherty f05ce80269 docs(observability): Telemetry 0.3.0 published, adopted by all four apps, logs over OTLP proven (#55)
Evidence doc gains the #55 section (root cause of no logs, 0.3.0 contents + SHA256,
per-app commits, collector output per app: service.version, site.id, node.role and
log records on OtOpcUa, HistorianGateway, ScadaBridge Site and MxAccessGateway).
GAPS, current-state, SPEC, the Telemetry CLAUDE.md and the index row updated;
infra/otel-collector gains otelidentity.py (Resource per signal + log samples).

Claude-Session: https://claude.ai/code/session_01GT67ACmpMR7b9LGRPLijMi
2026-11-12 21:28:50 -05:00
Joseph Doherty 2011c8d6b9 feat(telemetry): 0.3.0 ApplyConfiguration reads an app's telemetry section (#55)
Exporter, OtlpEndpoint, ServiceVersion, SiteId, NodeRole, ExportLogs and
ResourceAttributes:<key> from <App>:Telemetry, absent keys keep code defaults, so
the four apps stop re-implementing the exporter parse and gain the identity keys.

Claude-Session: https://claude.ai/code/session_01GT67ACmpMR7b9LGRPLijMi
2026-11-12 21:28:50 -05:00
Joseph Doherty cfc7168ace feat(telemetry): 0.3.0 service.version default, ResourceAttributes, logs follow AddZbTelemetry OTLP (#55)
- service.version: null ServiceVersion now defaults to the entry assembly's
  AssemblyInformationalVersion (the family apps stamp the git SHA there); "" omits it.
- ResourceAttributes: extra Resource attributes on every signal; first-class keys
  (service.*, host.name, site.id, node.role) are reserved and rejected at startup.
- Logs over OTLP: AddZbTelemetry publishes its options in DI and AddZbSerilog's OTLP
  log sink follows them when its own options do not select Otlp, so
  <App>:Telemetry:Exporter=Otlp now switches logs along with metrics and traces, with
  the same endpoint and Resource. ExportLogs=false opts out.
- Ships the unpublished 0.2.1 review fixes, including the stricter OTLP endpoint check
  (scheme-less host:port rejected when Exporter=Otlp); no app config sets an endpoint.
- Tests 42 -> 74, incl. a loopback OTLP/gRPC receiver proving logs arrive with the
  Resource, and an ExportLogs=false case with a metrics positive control.

Claude-Session: https://claude.ai/code/session_01GT67ACmpMR7b9LGRPLijMi
2026-11-12 21:28:50 -05:00
Joseph Doherty 616e913f3e docs(index): mxaccessgw 76a71bc8 deployed on DEV vd03 (#226 + #228 verified live, mxaccessgw#229); QA pending
Claude-Session: https://claude.ai/code/session_01GT67ACmpMR7b9LGRPLijMi
2026-11-12 21:25:17 -05:00
Joseph Doherty e6a724ba8e docs(index): mxaccessgw #228 Write2 time-argument fix on main 9ef6fc84, deploy tracked #229
Claude-Session: https://claude.ai/code/session_01GT67ACmpMR7b9LGRPLijMi
2026-11-12 21:01:10 -05:00
Joseph Doherty e1a2df83f7 feat(infra): shared dev OTel collector; OTLP proven end to end for all four apps (#13)
- infra/otel-collector/: zb-otel-collector (otelcol-contrib 0.162.0) on 10.100.0.35 —
  OTLP gRPC :4317 / HTTP :4318, debug + file exporters, Prometheus re-export :8889,
  health :13133; README runbook + otelsum.py summariser. Deployed.
- components/observability/2026-11-12-otlp-end-to-end-evidence.md: metrics + traces
  received from OtOpcUa, HistorianGateway, ScadaBridge (Site) and MxAccessGateway;
  OtOpcUa Galaxy driver allowlist defect fixed in lmxopcua#892 (db86b996).
- GAPS.md, current-state banners, index row, Telemetry CLAUDE.md: #13 closed; follow-ups
  #54 (wonder-tier collector), #55 (resource identity + logs over OTLP), ScadaBridge#133
  (Central role). Telemetry 0.2.1 deliberately left unpublished (no lib change needed).

Claude-Session: https://claude.ai/code/session_01GT67ACmpMR7b9LGRPLijMi
2026-11-12 20:48:36 -05:00
Joseph Doherty f98ba08910 docs(index): Auth 0.5.0 published (ILdapGroupLookup; 0.4.2-0.4.4 first published), scadaproj#51 closed
Claude-Session: https://claude.ai/code/session_01GT67ACmpMR7b9LGRPLijMi
2026-11-12 20:11:16 -05:00
Joseph Doherty f5ef0efedd feat(auth): 0.5.0 passwordless group lookup ILdapGroupLookup (ScadaBridge#46)
ILdapGroupLookup.GetUserGroupsAsync(username, ct) re-reads a known user's
groups with the service account: same extraction, canonicalisation, endpoint
walk (FallbackServers), timeouts and TLS policy as AuthenticateAsync, via one
shared WalkEndpoints<T>. Explicit statuses: Found, UserNotFound, UserDisabled
(AD userAccountControl), AmbiguousUser, DirectoryUnavailable, NotSupported
(BindMode=User / no service account / foreign ILdapAuthService),
ProviderDisabled. AddZbLdapAuth registers it as the same singleton.

0.5.0 is the first published version carrying 0.4.2-0.4.4; scadaproj#51 was
live-verified against the NAM AD (24/24, identity check mutation-proven).

Claude-Session: https://claude.ai/code/session_01GT67ACmpMR7b9LGRPLijMi
2026-11-12 20:11:16 -05:00
Joseph Doherty 3ca7e1936f docs(deployment): QA HistorianGateway now fa9cf31 (historiangw#78)
Claude-Session: https://claude.ai/code/session_01GT67ACmpMR7b9LGRPLijMi
2026-11-12 20:07:47 -05:00
Joseph Doherty 6c4595e87f docs(index): HistorianGateway fa9cf31 deployed to QA vq03/vq04 (historiangw#78 closed)
QA had no historian account and now reuses DEV's personal NAM account
(follow-up historiangw#134). Env migration: RuntimeDb removed,
LiveWritesEnabled on, gRPC 0.0.0.0:5221 kept.

Claude-Session: https://claude.ai/code/session_01GT67ACmpMR7b9LGRPLijMi
2026-11-12 20:07:32 -05:00
Joseph Doherty f83c75678c docs(secrets): ignitionoee router is a deployed 0.6.2 consumer; store moved on CR (scadaproj#21)
Claude-Session: https://claude.ai/code/session_01GT67ACmpMR7b9LGRPLijMi
2026-11-12 20:00:52 -05:00
Joseph Doherty 610c40afa5 docs(index): OtOpcUa QA canary, #890 re-apply, live #794 check and #780 runaway drill; #782/#801/#794/#890 closed
Claude-Session: https://claude.ai/code/session_01GT67ACmpMR7b9LGRPLijMi
2026-11-12 19:11:11 -05:00
Joseph Doherty cde1297c4a docs(index): OtOpcUa fea7de0a deployed on DEV vd03 and the QA pair vq03/vq04 (SDK 2.0.1, runner OutOfProcess on QA)
Claude-Session: https://claude.ai/code/session_01GT67ACmpMR7b9LGRPLijMi
2026-11-12 17:05:06 -05:00
Joseph Doherty e6beb9b4bf 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
2026-11-12 14:51:45 -05:00
Joseph Doherty e573ee40d5 docs(scadabridge-history): DCL OPC UA SDK 1.5.378.106 -> 1.5.378.182 (e36cd605), wire-compat vs SDK 1.5 + 2.0.1 servers; 2.0.x deferred (ScadaBridge#125)
Claude-Session: https://claude.ai/code/session_01GT67ACmpMR7b9LGRPLijMi
2026-11-12 14:09:10 -05:00
Joseph Doherty ccfcc7c3d2 docs(index): LocalDb 0.3.7 published; ScadaBridge + OtOpcUa pin it (#53)
Published ZB.MOM.WW.LocalDb, .Contracts and .Replication 0.3.7 to the
Gitea feed (carrying the 0.3.5/0.3.6 changes); SHA256 recorded. Pins:
ScadaBridge main 12fa7aff (ScadaBridge#130), OtOpcUa master e3031654
(lmxopcua#889). Not deployed.

Claude-Session: https://claude.ai/code/session_01GT67ACmpMR7b9LGRPLijMi
2026-11-12 14:07:58 -05:00
Joseph Doherty 470465dfbd docs(scadabridge-history): #129 alarm Severity one direction (dd4f1c2a), raw priority kept, MES deploy gate #131
Claude-Session: https://claude.ai/code/session_01GT67ACmpMR7b9LGRPLijMi
2026-11-12 14:06:09 -05:00
Joseph Doherty 30a12dd0fa docs(otopcua-history): #887 Galaxy alarm Severity follows AVEVA priority bands, 1 = most urgent (b61f3e05), consumer impact + ScadaBridge#129
Claude-Session: https://claude.ai/code/session_01GT67ACmpMR7b9LGRPLijMi
2026-11-12 12:19:09 -05:00
Joseph Doherty d5afd932e8 docs(otopcua-history): #886 Galaxy-backed folders serve AVEVA A&E history (3a312ffd), consumer impact
Claude-Session: https://claude.ai/code/session_01GT67ACmpMR7b9LGRPLijMi
2026-11-12 11:47:17 -05:00
Joseph Doherty a6d4d0d903 docs(otopcua-history): #879 EnabledSecurityProfiles replaces the default (a83bf1fa), consumer impact
Claude-Session: https://claude.ai/code/session_01GT67ACmpMR7b9LGRPLijMi
2026-11-12 11:39:24 -05:00
Joseph Doherty da4cb92713 docs(otopcua-history): wire ServiceLevel correct on SDK 2 (#884 claim, #885 startup 0); vd03 still 255 until redeployed
Claude-Session: https://claude.ai/code/session_01GT67ACmpMR7b9LGRPLijMi
2026-11-12 11:21:12 -05:00
Joseph Doherty d5de462f19 docs(otopcua-history): #880 SDK2 clients force legacy UserName encryption for 65-char keys vs SDK 1.5 servers (be28aa44), consumer impact
Claude-Session: https://claude.ai/code/session_01GT67ACmpMR7b9LGRPLijMi
2026-11-12 11:15:37 -05:00
Joseph Doherty 23693ef66c docs(otopcua-history): #882 folder event history includes attribute alarms (da948e5f), consumer impact
Claude-Session: https://claude.ai/code/session_01GT67ACmpMR7b9LGRPLijMi
2026-11-12 10:37:20 -05:00
Joseph Doherty 7c3d40ff19 docs(otopcua-history): drop unverified consumer example from #881 note
Claude-Session: https://claude.ai/code/session_01GT67ACmpMR7b9LGRPLijMi
2026-11-12 10:33:07 -05:00
Joseph Doherty 2624b32b1c docs(otopcua-history): #881 HistoryServerCapabilities flags per backend (b27b5b9c)
Claude-Session: https://claude.ai/code/session_01GT67ACmpMR7b9LGRPLijMi
2026-11-12 10:32:49 -05:00
Joseph Doherty 3180b09659 docs(theme): Theme 0.5.3 published to the Gitea feed (unblocks ScadaBridge#61)
Claude-Session: https://claude.ai/code/session_01GT67ACmpMR7b9LGRPLijMi
2026-11-12 08:51:34 -05:00
Joseph Doherty 9f7d36e7dc docs(index): mxaccessgw Contracts/Client 0.4.0 published; OtOpcUa adopts the stream-attached ack (lmxopcua#877)
Claude-Session: https://claude.ai/code/session_01GT67ACmpMR7b9LGRPLijMi
2026-11-12 07:41:12 -05:00
Joseph Doherty ef1b835910 docs(index): mxaccessgw #227 stream-attached ack + #226 alarm UTC fix on main 2026-11-12 07:28:33 -05:00
Joseph Doherty d25b73bacd docs(deploy): vd03 HistorianGateway gRPC :5221 opened off-box (0.0.0.0 + firewall rule) 2026-11-12 07:04:47 -05:00
Joseph Doherty 24c2624ce5 docs(index): vd03 OtOpcUa #793 close-out — MaxRpm re-pointed (9adc5590), ACL off, no ScadaBridge OPC UA link 2026-11-12 06:16:30 -05:00
Joseph Doherty 1f23e8a965 docs(index): vd03 OtOpcUa upgraded to 5fb4b4db (#793); DEV inventory in deployment.md §9 2026-11-12 06:08:08 -05:00
Joseph Doherty 2e2ce62665 docs(history): correct vd03 Galaxy-ack note (no Galaxy driver deployed there) 2026-11-12 06:00:30 -05:00
Joseph Doherty 4735913cdc docs(history): OtOpcUa vd03 upgraded to 5fb4b4db (#793) 2026-11-12 06:00:23 -05:00
Joseph Doherty 2ff319197d docs(index): OtOpcUa master 31be927f — script-runner Windows pipe I/O (#789) 2026-11-11 21:11:23 -05:00
Joseph Doherty b322140b99 docs(index): OtOpcUa master f109e5f2 — Galaxy init budget (#875), #717 spec draft, gate F PASS 2026-11-11 19:01:36 -05:00
Joseph Doherty 81d8901bf0 docs(index): OtOpcUa master 43f8b8e8 — SDK server logging (#874), SDK2 clock-skew note (#873), integration CI green 2026-11-11 18:08:12 -05:00
Joseph Doherty 1c6fe5793b docs(index): vd03 DEV deploys 2026-11-11 — mxaccessgw 2b13564e, HistorianGateway ea9f21c, ScadaBridge 424db155 2026-11-11 16:50:58 -05:00
Joseph Doherty 601f7ae0e6 docs(index): OtOpcUa master 363f0d81 — Galaxy status mapping (#866/#872), ring event queue (#870) 2026-11-11 15:38:51 -05:00
Joseph Doherty d042890d50 docs(index): OtOpcUa master 7a27ef1f — Galaxy ack confirmation, host status, aggregates, folder events, hardware gates 2026-11-11 14:54:15 -05:00
Joseph Doherty d8147bd0fd docs(index): OtOpcUa master e857135e — Galaxy subscribe-reply race + reconnect fencing (#859/#861), #856–#862 batch 2026-11-11 11:29:07 -05:00