56bb4855bb
M1: the time-weighted family (incl. Total, formerly a pushed-down SUM) streams raw window rows into the C# evaluator. New shared knob ServerHistorian:MaxTimeWeightedRawRows (default 1,000,000; <=0 unbounded with a Validate warning) flows through HistorianBackendRegistry into both providers. The window query is capped at cap+1 (SQL Server TOP (@maxRows), QuestDB LIMIT $4); one row past the cap throws the new Core.Abstractions HistoryReadLimitExceededException, which the node manager maps to BadTooManyOperations for that node. Not counted as a backend health failure; bound rows are not counted; per-sample aggregates are not capped. M2: reverse Interpolative is anchored at the later time (Part 13): points at End - i*interval, emitted latest first. 10:00->09:00 @1h yields 10:00. L1: Partial bit (0x4, = Opc.Ua.AggregateBits.Partial) on non-Bad results of a truncated last interval (time-weighted family; per-sample family is a follow-up). L2/L3: aligned with the SDK AggregateCalculator.GetTimeBasedStatusCode (decompiled from Opc.Ua.Server 1.5.378.106): TreatUncertainAsBad=false counts Uncertain time (Uncertain samples, held-into-outage, extrapolation) as Good time; data but no non-Bad time => generic Bad (0x80000000); BadNoData only when there is no data at all. Consequence: a live tag's latest interval reads Good (documented). L5: release note no longer claims Total matches the Gateway Integral exactly (AVEVA's divisor is unverified); it notes Total is now evaluated in C# and subject to the cap. Tests: unit (reverse Interpolative x3, Partial, Bad vs BadNoData incl. an open-ended outage, cap helpers, SDK bit oracles); conformance (reverse Interpolative, raw-row cap at/over/0, bounds not counted, health unaffected); node manager BadTooManyOperations; options default + warning. Each new behaviour falsified by mutation (aggregator x9, data-source cap checks on both backends against the real DBs, node-manager catch).
115 lines
4.5 KiB
C#
115 lines
4.5 KiB
C#
using Xunit;
|
|
using ZB.MOM.WW.OtOpcUa.Runtime.Historian;
|
|
|
|
namespace ZB.MOM.WW.OtOpcUa.Runtime.Tests.Historian;
|
|
|
|
/// <summary>
|
|
/// Covers the gateway-shaped <see cref="ServerHistorianOptions.Validate"/> warnings: a disabled or
|
|
/// correctly-configured historian is silent; an enabled one with a blank <c>Endpoint</c> or blank
|
|
/// <c>ApiKey</c> surfaces an operator-facing warning (carrying no secret value text).
|
|
/// </summary>
|
|
public sealed class ServerHistorianOptionsTests
|
|
{
|
|
[Fact]
|
|
public void Disabled_yields_no_warnings()
|
|
=> Assert.Empty(new ServerHistorianOptions { Enabled = false }.Validate());
|
|
|
|
[Fact]
|
|
public void Enabled_without_endpoint_warns()
|
|
{
|
|
var w = new ServerHistorianOptions { Enabled = true, Endpoint = "", ApiKey = "histgw_x_y" }.Validate();
|
|
Assert.Contains(w, m => m.Contains("Endpoint"));
|
|
}
|
|
|
|
[Fact]
|
|
public void Enabled_with_malformed_endpoint_warns()
|
|
{
|
|
// archreview 06/S-11 warning parity: a non-empty but unparseable / non-absolute Endpoint warns
|
|
// too, so the Runtime-side registration logs describe malformed endpoints (not just empty ones),
|
|
// keeping this surface consistent with the Host's fail-fast ServerHistorianOptionsValidator.
|
|
var w = new ServerHistorianOptions { Enabled = true, Endpoint = "not a uri", ApiKey = "histgw_x_y" }.Validate();
|
|
Assert.Contains(w, m => m.Contains("Endpoint"));
|
|
}
|
|
|
|
[Fact]
|
|
public void Enabled_without_apikey_warns()
|
|
{
|
|
var w = new ServerHistorianOptions { Enabled = true, Endpoint = "https://h:5222", ApiKey = "" }.Validate();
|
|
Assert.Contains(w, m => m.Contains("ApiKey"));
|
|
}
|
|
|
|
[Fact]
|
|
public void Valid_config_is_clean()
|
|
=> Assert.Empty(new ServerHistorianOptions { Enabled = true, Endpoint = "https://h:5222", ApiKey = "histgw_x_y" }.Validate());
|
|
|
|
[Fact]
|
|
public void Enabled_with_nonpositive_MaxTieClusterOverfetch_warns()
|
|
{
|
|
var w = new ServerHistorianOptions
|
|
{ Enabled = true, Endpoint = "https://h:5222", ApiKey = "histgw_x_y", MaxTieClusterOverfetch = 0 }
|
|
.Validate();
|
|
Assert.Contains(w, m => m.Contains("MaxTieClusterOverfetch"));
|
|
}
|
|
|
|
// ── S3 HistoryRead concurrency knobs (arch-review 03/S3) ────────────────────────────────────
|
|
|
|
[Fact]
|
|
public void HistoryRead_knob_defaults()
|
|
{
|
|
var o = new ServerHistorianOptions();
|
|
Assert.Equal(4, o.HistoryReadBatchParallelism);
|
|
Assert.Equal(16, o.MaxConcurrentHistoryReadBatches);
|
|
Assert.Equal(TimeSpan.FromSeconds(60), o.HistoryReadDeadline);
|
|
}
|
|
|
|
[Fact]
|
|
public void Enabled_with_nonpositive_HistoryReadBatchParallelism_warns()
|
|
{
|
|
var w = new ServerHistorianOptions
|
|
{ Enabled = true, Endpoint = "https://h:5222", ApiKey = "histgw_x_y", HistoryReadBatchParallelism = 0 }
|
|
.Validate();
|
|
Assert.Contains(w, m => m.Contains("HistoryReadBatchParallelism"));
|
|
}
|
|
|
|
[Fact]
|
|
public void Enabled_with_nonpositive_MaxConcurrentHistoryReadBatches_warns()
|
|
{
|
|
var w = new ServerHistorianOptions
|
|
{ Enabled = true, Endpoint = "https://h:5222", ApiKey = "histgw_x_y", MaxConcurrentHistoryReadBatches = 0 }
|
|
.Validate();
|
|
Assert.Contains(w, m => m.Contains("MaxConcurrentHistoryReadBatches"));
|
|
}
|
|
|
|
[Fact]
|
|
public void Enabled_with_nonpositive_HistoryReadDeadline_warns()
|
|
{
|
|
var w = new ServerHistorianOptions
|
|
{ Enabled = true, Endpoint = "https://h:5222", ApiKey = "histgw_x_y", HistoryReadDeadline = TimeSpan.Zero }
|
|
.Validate();
|
|
Assert.Contains(w, m => m.Contains("HistoryReadDeadline"));
|
|
}
|
|
|
|
[Fact]
|
|
public void MaxTimeWeightedRawRows_defaults_to_one_million_and_warns_when_nonpositive()
|
|
{
|
|
Assert.Equal(1_000_000, new ServerHistorianOptions().MaxTimeWeightedRawRows);
|
|
var w = new ServerHistorianOptions
|
|
{ Enabled = true, Endpoint = "https://h:5222", ApiKey = "histgw_x_y", MaxTimeWeightedRawRows = 0 }
|
|
.Validate();
|
|
Assert.Contains(w, m => m.Contains("MaxTimeWeightedRawRows"));
|
|
}
|
|
|
|
[Fact]
|
|
public void Disabled_with_nonpositive_HistoryRead_knobs_is_silent()
|
|
{
|
|
var w = new ServerHistorianOptions
|
|
{
|
|
Enabled = false,
|
|
HistoryReadBatchParallelism = 0,
|
|
MaxConcurrentHistoryReadBatches = 0,
|
|
HistoryReadDeadline = TimeSpan.Zero,
|
|
}.Validate();
|
|
Assert.Empty(w);
|
|
}
|
|
}
|