/// <summary>
/// Initializes a new instance of the <see cref="PersistenceChannel"/> class.
/// </summary>
/// <param name="storageFolderName">
/// A folder name. Under this folder all the transmissions will be saved.
/// Setting this value groups channels, even from different processes.
/// If 2 (or more) channels has the same <c>storageFolderName</c> only one channel will perform the sending even if the channel is in a different process/AppDomain/Thread.
/// </param>
/// <param name="sendersCount">
/// Defines the number of senders. A sender is a long-running thread that sends telemetry batches in intervals defined by <see cref="SendingInterval"/>.
/// So the amount of senders also defined the maximum amount of http channels opened at the same time.
/// </param>
public PersistenceChannel(string storageFolderName, int sendersCount = 1)
{
this.TelemetryBuffer = new TelemetryBuffer();
this.storage = ServiceLocator.GetService <BaseStorageService>();
this.storage.Init(storageFolderName);
this.Transmitter = new PersistenceTransmitter(this.storage, sendersCount);
this.flushManager = new FlushManager(this.storage, this.TelemetryBuffer);
this.EndpointAddress = TelemetryServiceEndpoint;
this.developerMode = false;
}
/// <summary>
/// Initializes a new instance of the <see cref="PersistenceChannel"/> class.
/// </summary>
/// <param name="storageFolderName">
/// A folder name. Under this folder all the transmissions will be saved.
/// Setting this value groups channels, even from different processes.
/// If 2 (or more) channels has the same <c>storageFolderName</c> only one channel will perform the sending even if the channel is in a different process/AppDomain/Thread.
/// </param>
/// <param name="sendersCount">
/// Defines the number of senders. A sender is a long-running thread that sends telemetry batches in intervals defined by <see cref="SendingInterval"/>.
/// So the amount of senders also defined the maximum amount of http channels opened at the same time.
/// </param>
public PersistenceChannel(string storageFolderName, int sendersCount = 1)
{
this.TelemetryBuffer = new TelemetryBuffer();
this.storage = ServiceLocator.GetService<BaseStorageService>();
this.storage.Init(storageFolderName);
this.Transmitter = new PersistenceTransmitter(this.storage, sendersCount);
this.flushManager = new FlushManager(this.storage, this.TelemetryBuffer);
this.EndpointAddress = TelemetryServiceEndpoint;
this.developerMode = false;
}
/// <summary>
/// Initializes a new instance of the <see cref="Sender"/> class.
/// </summary>
/// <param name="storage">The storage that holds the transmissions to send.</param>
/// <param name="transmitter">
/// The persistence transmitter that manages this Sender.
/// The transmitter will be used as a configuration class, it exposes properties like SendingInterval that will be read by Sender.
/// </param>
/// <param name="startSending">A boolean value that determines if Sender should start sending immediately. This is only used for unit tests.</param>
internal Sender(BaseStorageService storage, PersistenceTransmitter transmitter, bool startSending = true)
{
this.stopped = false;
this.DelayHandler = new AutoResetEvent(false);
this.stoppedHandler = new AutoResetEvent(false);
this.drainingTimeout = TimeSpan.FromSeconds(100);
this.defaultSendingInterval = TimeSpan.FromSeconds(5);
// TODO: instead of a circualr reference, pass the TelemetryConfiguration.
this.transmitter = transmitter;
this.storage = storage;
if (startSending)
{
// It is currently possible for the long - running task to be executed(and thereby block during WaitOne) on the UI thread when
// called by a task scheduled on the UI thread. Explicitly specifying TaskScheduler.Default
// when calling StartNew guarantees that Sender never blocks the main thread.
Task.Factory.StartNew(this.SendLoop, CancellationToken.None, TaskCreationOptions.LongRunning, TaskScheduler.Default)
.ContinueWith(t => CoreEventSource.Log.LogVerbose("Sender: Failure in SendLoop: Exception: " + t.Exception.ToString()), TaskContinuationOptions.OnlyOnFaulted);
}
}
/// <summary>
/// Initializes a new instance of the <see cref="Sender"/> class.
/// </summary>
/// <param name="storage">The storage that holds the transmissions to send.</param>
/// <param name="transmitter">
/// The persistence transmitter that manages this Sender.
/// The transmitter will be used as a configuration class, it exposes properties like SendingInterval that will be read by Sender.
/// </param>
/// <param name="startSending">A boolean value that determines if Sender should start sending immediately. This is only used for unit tests.</param>
internal Sender(BaseStorageService storage, PersistenceTransmitter transmitter, bool startSending = true)
{
this.stopped = false;
this.DelayHandler = new AutoResetEvent(false);
this.stoppedHandler = new AutoResetEvent(false);
this.drainingTimeout = TimeSpan.FromSeconds(100);
this.defaultSendingInterval = TimeSpan.FromSeconds(5);
// TODO: instead of a circualr reference, pass the TelemetryConfiguration.
this.transmitter = transmitter;
this.storage = storage;
if (startSending)
{
// It is currently possible for the long - running task to be executed(and thereby block during WaitOne) on the UI thread when
// called by a task scheduled on the UI thread. Explicitly specifying TaskScheduler.Default
// when calling StartNew guarantees that Sender never blocks the main thread.
Task.Factory.StartNew(this.SendLoop, CancellationToken.None, TaskCreationOptions.LongRunning, TaskScheduler.Default)
.ContinueWith(t => CoreEventSource.Log.LogVerbose("Sender: Failure in SendLoop: Exception: " + t.Exception.ToString()), TaskContinuationOptions.OnlyOnFaulted);
}
}
