public async Task UsableIfBufferOverflowOccurs()
{
Mock <IHealthReporter> healthReporterMock = new Mock <IHealthReporter>();
UnitTestOutput unitTestOutput = new UnitTestOutput();
unitTestOutput.SendEventsDelay = TimeSpan.FromMilliseconds(100);
DiagnosticPipelineConfiguration settings = new DiagnosticPipelineConfiguration()
{
MaxBatchDelayMsec = 10,
PipelineCompletionTimeoutMsec = 1000,
PipelineBufferSize = 1,
MaxConcurrency = 1,
MaxEventBatchSize = 1
};
const int TestBatchSize = 6;
using (UnitTestInput unitTestInput = new UnitTestInput())
using (DiagnosticPipeline pipeline = new DiagnosticPipeline(
healthReporterMock.Object,
new IObservable <EventData>[] { unitTestInput },
null,
new EventSink[] { new EventSink(unitTestOutput, null) },
settings))
{
// Six events in quick succession will cause a buffer overflow
// (we have a buffer of 1 set for the pipeline, but the pipeline has 3 blocks, so the actual buffer space is 3).
// There should be no ill effects from that on the input--not catching any exceptions.
for (int i = 0; i < TestBatchSize; i++)
{
unitTestInput.SendMessage($"Message {i}");
}
// Wait for the pipeline to drain (use ten times batch delay time for extra padding).
await Task.Delay(TimeSpan.FromMilliseconds(TestBatchSize * (unitTestOutput.SendEventsDelay.TotalMilliseconds + settings.MaxBatchDelayMsec * 10)));
// At least one message should get to the output.
Assert.True(unitTestOutput.CallCount > 0);
// We should get a warning about throttling
healthReporterMock.Verify(o => o.ReportWarning(It.IsAny <string>(), It.Is <string>(s => s == EventFlowContextIdentifiers.Throttling)), Times.AtLeastOnce());
// Pipeline should still be usable after this. Let's try to send a message through it.
unitTestOutput.CallCount = 0;
healthReporterMock.ResetCalls();
unitTestInput.SendMessage("Final message");
// Wait for the message to be processed (use ten times batch delay time for extra padding)
await Task.Delay(TimeSpan.FromMilliseconds(unitTestOutput.SendEventsDelay.TotalMilliseconds + settings.MaxBatchDelayMsec * 10));
// The message should have come through.
Assert.Equal(1, unitTestOutput.CallCount);
// There should be no new warnings or errors
healthReporterMock.Verify(o => o.ReportWarning(It.IsAny <string>(), It.IsAny <string>()), Times.Never());
healthReporterMock.Verify(o => o.ReportProblem(It.IsAny <string>(), It.IsAny <string>()), Times.Never());
}
}
public void UsableIfBufferOverflowOccurs()
{
Mock <IHealthReporter> healthReporterMock = new Mock <IHealthReporter>();
var deterministicTaskScheduler = new DeterministicTaskScheduler();
UnitTestOutput unitTestOutput = new UnitTestOutput();
DiagnosticPipelineConfiguration settings = new DiagnosticPipelineConfiguration()
{
MaxBatchDelayMsec = 10,
PipelineCompletionTimeoutMsec = 5000,
PipelineBufferSize = 1,
MaxConcurrency = 1,
MaxEventBatchSize = 1
};
const int TestBatchSize = 6;
using (UnitTestInput unitTestInput = new UnitTestInput())
using (DiagnosticPipeline pipeline = new DiagnosticPipeline(
healthReporterMock.Object,
new IObservable <EventData>[] { unitTestInput },
null,
new EventSink[] { new EventSink(unitTestOutput, null) },
settings,
disposeDependencies: false,
taskScheduler: deterministicTaskScheduler))
{
// Six events in quick succession will cause a buffer overflow
// (we have a buffer of 1 set for the pipeline, but the pipeline has 3 blocks, so the actual buffer space is 3).
// There should be no ill effects from that on the input--not catching any exceptions.
for (int i = 0; i < TestBatchSize; i++)
{
unitTestInput.SendMessage($"Message {i}");
}
// Wait for the pipeline to drain
deterministicTaskScheduler.RunTasksUntilIdle();
Assert.True(unitTestOutput.CallCount > 0, "At least one message should get to the output");
// We should get a warning about throttling
healthReporterMock.Verify(o => o.ReportWarning(It.IsAny <string>(), It.Is <string>(s => s == EventFlowContextIdentifiers.Throttling)), Times.AtLeastOnce());
// Pipeline should still be usable after this. Let's try to send a message through it.
unitTestOutput.CallCount = 0;
healthReporterMock.ResetCalls();
unitTestInput.SendMessage("Final message");
// Give the pipeline a chance to process the message
deterministicTaskScheduler.RunTasksUntilIdle();
// The message should have come through.
Assert.Equal(1, unitTestOutput.CallCount);
// There should be no new warnings or errors
healthReporterMock.Verify(o => o.ReportWarning(It.IsAny <string>(), It.IsAny <string>()), Times.Never());
healthReporterMock.Verify(o => o.ReportProblem(It.IsAny <string>(), It.IsAny <string>()), Times.Never());
}
}
public void ShouldPassOneInputToOneOutput()
{
// Setup
Mock <IHealthReporter> healthReporterMock = new Mock <IHealthReporter>();
Mock <IOutput> mockOutput = new Mock <IOutput>();
DiagnosticPipelineConfiguration settings = new DiagnosticPipelineConfiguration()
{
MaxBatchDelayMsec = 10,
PipelineCompletionTimeoutMsec = 1000
};
using (UnitTestInput unitTestInput = new UnitTestInput())
using (DiagnosticPipeline pipeline = new DiagnosticPipeline(
healthReporterMock.Object,
new IObservable <EventData>[] { unitTestInput },
null,
new EventSink[] { new EventSink(mockOutput.Object, null) },
settings))
{
// Execrise
unitTestInput.SendMessage("Test information");
}
// Verify
mockOutput.Verify(o => o.SendEventsAsync(It.Is <IReadOnlyCollection <EventData> >(c => c.Count == 1),
It.IsAny <long>(), It.IsAny <CancellationToken>()), Times.Exactly(1));
}
public void UsableIfExceptionInOutputSpecificFilterOccurs()
{
Mock <IHealthReporter> healthReporterMock = new Mock <IHealthReporter>();
UnitTestOutput unitTestOutput = new UnitTestOutput();
DiagnosticPipelineConfiguration settings = new DiagnosticPipelineConfiguration()
{
MaxBatchDelayMsec = 10,
PipelineCompletionTimeoutMsec = 10000,
MaxEventBatchSize = 2
};
UnitTestFilter unitTestFilter = new UnitTestFilter();
unitTestFilter.EvaluationFailureCondition = "Trouble == true";
const int TestEventCount = 6;
DateTime pipelineDisposalStart;
using (UnitTestInput unitTestInput = new UnitTestInput())
using (DiagnosticPipeline pipeline = new DiagnosticPipeline(
healthReporterMock.Object,
new IObservable <EventData>[] { unitTestInput },
null,
new EventSink[] { new EventSink(unitTestOutput, new IFilter[] { unitTestFilter }) },
settings))
{
// Half of the events should cause filtering to fail with an exception
for (int i = 0; i < TestEventCount; i++)
{
if (i % 2 == 0)
{
unitTestInput.SendData(new Dictionary <string, object> {
["Trouble"] = true
});
}
else
{
unitTestInput.SendMessage("Hi!");
}
}
pipelineDisposalStart = DateTime.Now;
}
// We should have got good events and warnings about bad events
DateTime pipelineDisposalEnd = DateTime.Now;
// We should have got good events and warnings about bad events
Assert.True(TestEventCount / 2 == unitTestOutput.EventCount,
$"Events missing: expected: {TestEventCount / 2}, " +
$"actual: {unitTestOutput.EventCount}, " +
$"filter invocations: {unitTestFilter.CallCount}, " +
$"pipeline disposal time: {(pipelineDisposalEnd - pipelineDisposalStart).TotalMilliseconds} msec");
healthReporterMock.Verify(o => o.ReportWarning(It.IsAny <string>(), It.Is <string>(s => s == EventFlowContextIdentifiers.Filtering)), Times.Exactly(TestEventCount / 2));
}
public async Task WarnsAboutThrottlingIfOneSinkIsSlow()
{
Mock <IHealthReporter> healthReporterMock = new Mock <IHealthReporter>();
UnitTestOutput fastOutput = new UnitTestOutput();
UnitTestOutput slowOutput = new UnitTestOutput();
slowOutput.SendEventsDelay = TimeSpan.FromMilliseconds(50);
const int InputBufferSize = 10;
const int BurstCount = 100;
DiagnosticPipelineConfiguration settings = new DiagnosticPipelineConfiguration()
{
MaxBatchDelayMsec = 10,
PipelineBufferSize = InputBufferSize,
MaxEventBatchSize = 4,
MaxConcurrency = 2,
PipelineCompletionTimeoutMsec = 5000
};
using (UnitTestInput unitTestInput = new UnitTestInput())
using (DiagnosticPipeline pipeline = new DiagnosticPipeline(
healthReporterMock.Object,
new IObservable <EventData>[] { unitTestInput },
null,
new EventSink[] { new EventSink(fastOutput, null), new EventSink(slowOutput, null) },
settings))
{
for (int burst = 0; burst < BurstCount; burst++)
{
// Each burst fills the input buffer
for (int i = 0; i < InputBufferSize; i++)
{
unitTestInput.SendMessage($"{burst}--{i}");
}
// Give the pipeline some time to process events--the fast output will keep up, the slow one, certainly not
bool eventsReceived = await TaskUtils.PollWaitAsync(() => fastOutput.EventCount == (burst + 1) *InputBufferSize, TimeSpan.FromSeconds(5));
Assert.True(eventsReceived);
}
// Slow output should have received some, but not all events
Assert.InRange(slowOutput.EventCount, 1, BurstCount * InputBufferSize - 1);
}
healthReporterMock.Verify(o => o.ReportWarning(It.IsAny <string>(), It.Is <string>(s => s == EventFlowContextIdentifiers.Throttling)),
Times.AtLeastOnce());
}
public async Task CanDisposePipelineStuckInAnOutput()
{
Mock <IHealthReporter> healthReporterMock = new Mock <IHealthReporter>();
UnitTestOutput unitTestOutput = new UnitTestOutput();
unitTestOutput.SendEventsDelay = TimeSpan.MaxValue;
unitTestOutput.DisregardCancellationToken = true;
const int CompletionTimeoutMsec = 1000;
DiagnosticPipelineConfiguration settings = new DiagnosticPipelineConfiguration()
{
MaxBatchDelayMsec = 10,
PipelineCompletionTimeoutMsec = CompletionTimeoutMsec,
MaxEventBatchSize = 1,
PipelineBufferSize = 1,
MaxConcurrency = 1
};
Stopwatch stopwatch;
using (UnitTestInput unitTestInput = new UnitTestInput())
using (DiagnosticPipeline pipeline = new DiagnosticPipeline(
healthReporterMock.Object,
new IObservable <EventData>[] { unitTestInput },
null,
new EventSink[] { new EventSink(unitTestOutput, null) },
settings))
{
// Saturate the pipeline
for (int i = 0; i < 10; i++)
{
unitTestInput.SendMessage("Hi!");
}
// Wait a little bit for the pipeline to process messages and get stuck in the output.
await Task.Delay(TimeSpan.FromMilliseconds(100));
stopwatch = Stopwatch.StartNew();
}
stopwatch.Stop();
// We should have received not sent any data successfully
Assert.Equal(0, unitTestOutput.CallCount);
// Ensure the pipeline stops within the timeout (plus some padding)
Assert.InRange(stopwatch.ElapsedMilliseconds, 0, CompletionTimeoutMsec + 200);
}
public async Task UsableIfExceptionInOutputSpecificFilterOccurs()
{
Mock <IHealthReporter> healthReporterMock = new Mock <IHealthReporter>();
UnitTestOutput unitTestOutput = new UnitTestOutput();
DiagnosticPipelineConfiguration settings = new DiagnosticPipelineConfiguration()
{
MaxBatchDelayMsec = 10,
PipelineCompletionTimeoutMsec = 1000,
MaxEventBatchSize = 2
};
UnitTestFilter unitTestFilter = new UnitTestFilter();
unitTestFilter.EvaluationFailureCondition = "Trouble == true";
const int TestEventCount = 6;
using (UnitTestInput unitTestInput = new UnitTestInput())
using (DiagnosticPipeline pipeline = new DiagnosticPipeline(
healthReporterMock.Object,
new IObservable <EventData>[] { unitTestInput },
null,
new EventSink[] { new EventSink(unitTestOutput, new IFilter[] { unitTestFilter }) },
settings))
{
// Half of the events should cause filtering to fail with an exception
for (int i = 0; i < TestEventCount; i++)
{
if (i % 2 == 0)
{
unitTestInput.SendData(new Dictionary <string, object> {
["Trouble"] = true
});
}
else
{
unitTestInput.SendMessage("Hi!");
}
}
// Wait for the pipeline to drain.
await Task.Delay(TimeSpan.FromMilliseconds(300));
// We should have got good events and warnings about bad events
Assert.Equal(TestEventCount / 2, unitTestOutput.EventCount);
healthReporterMock.Verify(o => o.ReportWarning(It.IsAny <string>(), It.Is <string>(s => s == EventFlowContextIdentifiers.Filtering)), Times.Exactly(TestEventCount / 2));
}
}
public void CanDisposePipelineStuckInAFilter()
{
Mock <IHealthReporter> healthReporterMock = new Mock <IHealthReporter>();
UnitTestOutput unitTestOutput = new UnitTestOutput();
const int CompletionTimeoutMsec = 1000;
DiagnosticPipelineConfiguration settings = new DiagnosticPipelineConfiguration()
{
MaxBatchDelayMsec = 10,
PipelineCompletionTimeoutMsec = CompletionTimeoutMsec,
MaxEventBatchSize = 1,
PipelineBufferSize = 1,
MaxConcurrency = 1
};
UnitTestFilter unitTestFilter = new UnitTestFilter();
unitTestFilter.EvaluationDelay = TimeSpan.MaxValue;
Stopwatch stopwatch;
using (UnitTestInput unitTestInput = new UnitTestInput())
using (DiagnosticPipeline pipeline = new DiagnosticPipeline(
healthReporterMock.Object,
new IObservable <EventData>[] { unitTestInput },
new IFilter[] { unitTestFilter },
new EventSink[] { new EventSink(unitTestOutput, null) },
settings))
{
// Saturate the pipeline
for (int i = 0; i < 10; i++)
{
unitTestInput.SendMessage("Hi!");
}
stopwatch = Stopwatch.StartNew();
}
stopwatch.Stop();
// We should have received no events on the output side--everything should have been stuck in the filter (or dropped because of buffer overflow)
Assert.Equal(0, unitTestOutput.CallCount);
// Ensure the pipeline stops within the timeout (plus some padding)
Assert.InRange(stopwatch.ElapsedMilliseconds, 0, CompletionTimeoutMsec + 200);
}
public async Task DoesNotWarnIfNoThrottlingOccurs()
{
Mock <IHealthReporter> healthReporterMock = new Mock <IHealthReporter>();
// Need two outputs to force the pipeline to use the BroadcastBlock.
UnitTestOutput firstOutput = new UnitTestOutput();
UnitTestOutput secondOutput = new UnitTestOutput();
const int InputBufferSize = 100;
DiagnosticPipelineConfiguration settings = new DiagnosticPipelineConfiguration()
{
MaxBatchDelayMsec = 10,
PipelineBufferSize = InputBufferSize,
MaxEventBatchSize = 4,
MaxConcurrency = 2,
PipelineCompletionTimeoutMsec = 5000
};
using (UnitTestInput unitTestInput = new UnitTestInput())
using (DiagnosticPipeline pipeline = new DiagnosticPipeline(
healthReporterMock.Object,
new IObservable <EventData>[] { unitTestInput },
null,
new EventSink[] { new EventSink(firstOutput, null), new EventSink(secondOutput, null) },
settings))
{
for (int i = 0; i < InputBufferSize; i++)
{
unitTestInput.SendMessage(i.ToString());
}
// There should be no problem for both outputs to receive all events
bool eventsReceived = await TaskUtils.PollWaitAsync(() => firstOutput.EventCount == InputBufferSize, TimeSpan.FromMilliseconds(100));
Assert.True(eventsReceived);
eventsReceived = await TaskUtils.PollWaitAsync(() => secondOutput.EventCount == InputBufferSize, TimeSpan.FromMilliseconds(100));
Assert.True(eventsReceived);
}
healthReporterMock.Verify(o => o.ReportWarning(It.IsAny <string>(), It.Is <string>(s => s == EventFlowContextIdentifiers.Throttling)),
Times.Never());
}
public async Task UsableIfExceptionInOutputOccurs()
{
Mock <IHealthReporter> healthReporterMock = new Mock <IHealthReporter>();
UnitTestOutput unitTestOutput = new UnitTestOutput();
unitTestOutput.FailureCondition = (transmissionSequenceNumber) => transmissionSequenceNumber % 2 == 0;
DiagnosticPipelineConfiguration settings = new DiagnosticPipelineConfiguration()
{
MaxBatchDelayMsec = 10,
PipelineCompletionTimeoutMsec = 1000,
MaxEventBatchSize = 2
};
const int TestEventCount = 32;
using (UnitTestInput unitTestInput = new UnitTestInput())
using (DiagnosticPipeline pipeline = new DiagnosticPipeline(
healthReporterMock.Object,
new IObservable <EventData>[] { unitTestInput },
null,
new EventSink[] { new EventSink(unitTestOutput, null) },
settings))
{
// Half of the events should cause output to fail with an exception
for (int i = 0; i < TestEventCount; i++)
{
unitTestInput.SendMessage("Hi!");
}
// Wait for the pipeline to drain.
await Task.Delay(TimeSpan.FromMilliseconds(300));
// We should have at least TestEventCount / MaxEventBatchSize calls to the output
int expectedMinCallCount = TestEventCount / settings.MaxEventBatchSize;
Assert.InRange(unitTestOutput.CallCount, expectedMinCallCount, TestEventCount);
// Half of these calls (modulo 1) should have failed
healthReporterMock.Verify(o => o.ReportWarning(It.IsAny <string>(), It.Is <string>(s => s == EventFlowContextIdentifiers.Output)),
Times.Between(unitTestOutput.CallCount / 2, unitTestOutput.CallCount / 2 + 1, Range.Inclusive));
}
}