/// <summary>
/// Adds <see cref="AdaptiveSamplingTelemetryProcessor"/> to the <see cref="TelemetryProcessorChainBuilder" />
/// </summary>
/// <param name="builder">Instance of <see cref="TelemetryProcessorChainBuilder"/></param>
/// <param name="settings">Set of settings applicable to dynamic sampling percentage algorithm.</param>
/// <param name="callback">Callback invoked every time sampling percentage evaluation occurs.</param>
/// <return>Instance of <see cref="TelemetryProcessorChainBuilder"/>.</return>
public static TelemetryProcessorChainBuilder UseAdaptiveSampling(
this TelemetryProcessorChainBuilder builder,
SamplingPercentageEstimatorSettings settings,
AdaptiveSamplingPercentageEvaluatedCallback callback)
{
return builder.Use((next) => new AdaptiveSamplingTelemetryProcessor(settings, callback, next) { InitialSamplingPercentage = 100.0 / settings.EffectiveInitialSamplingRate });
}
/// <summary>
/// Initializes a new instance of the <see cref="SamplingPercentageEstimatorTelemetryProcessor"/> class.
/// <param name="settings">Dynamic sampling estimator settings.</param>
/// <param name="callback">Callback to invoke every time sampling percentage is evaluated.</param>
/// <param name="next">Next TelemetryProcessor in call chain.</param>
/// </summary>
public SamplingPercentageEstimatorTelemetryProcessor(
SamplingPercentageEstimatorSettings settings,
AdaptiveSamplingPercentageEvaluatedCallback callback,
ITelemetryProcessor next)
{
if (settings == null)
{
throw new ArgumentNullException("settings");
}
if (next == null)
{
throw new ArgumentNullException("next");
}
this.evaluationCallback = callback;
this.settings = settings;
this.next = next;
this.currenSamplingRate = settings.EffectiveInitialSamplingRate;
this.itemCount = new ExponentialMovingAverageCounter(settings.EffectiveMovingAverageRatio);
this.samplingPercentageLastChangeDateTime = DateTimeOffset.UtcNow;
// set evaluation interval to default value if it is negative or zero
this.evaluationInterval = this.settings.EffectiveEvaluationInterval;
// set up timer to run math to estimate sampling percentage
this.evaluationTimer = new Timer(
this.EstimateSamplingPercentage,
null,
this.evaluationInterval,
this.evaluationInterval);
}
/// <summary>
/// Adds <see cref="AdaptiveSamplingTelemetryProcessor"/> to the <see cref="TelemetryProcessorChainBuilder" />
/// </summary>
/// <param name="builder">Instance of <see cref="TelemetryProcessorChainBuilder"/></param>
/// <param name="settings">Set of settings applicable to dynamic sampling percentage algorithm.</param>
/// <param name="callback">Callback invoked every time sampling percentage evaluation occurs.</param>
/// <return>Instance of <see cref="TelemetryProcessorChainBuilder"/>.</return>
public static TelemetryProcessorChainBuilder UseAdaptiveSampling(
this TelemetryProcessorChainBuilder builder,
SamplingPercentageEstimatorSettings settings,
AdaptiveSamplingPercentageEvaluatedCallback callback)
{
return(builder.Use((next) => new AdaptiveSamplingTelemetryProcessor(settings, callback, next)
{
InitialSamplingPercentage = 100.0 / settings.EffectiveInitialSamplingRate
}));
}
/// <summary>
/// Initializes a new instance of the <see cref="AdaptiveSamplingTelemetryProcessor"/> class.
/// <param name="settings">Sampling percentage estimator settings.</param>
/// <param name="callback">Callback invoked every time sampling percentage is evaluated.</param>
/// <param name="next">Next TelemetryProcessor in call chain.</param>
/// </summary>
public AdaptiveSamplingTelemetryProcessor(
SamplingPercentageEstimatorSettings settings,
AdaptiveSamplingPercentageEvaluatedCallback callback,
ITelemetryProcessor next)
{
this.estimatorSettings = settings;
this.evaluationCallback = callback;
// make estimatortelemetry processor work after sampling was done
this.estimatorProcessor = new SamplingPercentageEstimatorTelemetryProcessor(settings, this.SamplingPercentageChanged, next);
this.samplingProcessor = new SamplingTelemetryProcessor(this.estimatorProcessor);
}
/// <summary>
/// Initializes a new instance of the <see cref="AdaptiveSamplingTelemetryProcessor"/> class.
/// <param name="settings">Sampling percentage estimator settings.</param>
/// <param name="callback">Callback invoked every time sampling percentage is evaluated.</param>
/// <param name="next">Next TelemetryProcessor in call chain.</param>
/// </summary>
public AdaptiveSamplingTelemetryProcessor(
SamplingPercentageEstimatorSettings settings,
AdaptiveSamplingPercentageEvaluatedCallback callback,
ITelemetryProcessor next)
{
this.estimatorSettings = settings;
this.evaluationCallback = callback;
// make estimatortelemetry processor work after sampling was done
this.estimatorProcessor = new SamplingPercentageEstimatorTelemetryProcessor(settings, this.SamplingPercentageChanged, next);
this.samplingProcessor = new SamplingTelemetryProcessor(this.estimatorProcessor);
}
public void Configure(TelemetryConfiguration tc)
{
AdaptiveSamplingPercentageEvaluatedCallback samplingCallback = (ratePerSecond, currentPercentage, newPercentage, isChanged, estimatorSettings) =>
{
if (isChanged)
{
tc.SetLastObservedSamplingPercentage(SamplingTelemetryItemTypes.Request, newPercentage);
}
};
tc.DefaultTelemetrySink.TelemetryProcessorChainBuilder
.UseAdaptiveSampling(_settings.Value, samplingCallback, excludedTypes: "Event")
.UseAdaptiveSampling(_settings.Value, null, includedTypes: "Event")
.Build()
;
}
public void UseAdaptiveSamplingAddsAdaptiveSamplingProcessorToTheChainWithCorrectSettings()
{
SamplingPercentageEstimatorSettings settings = new SamplingPercentageEstimatorSettings
{
MaxSamplingPercentage = 13
};
AdaptiveSamplingPercentageEvaluatedCallback callback = (second, percentage, samplingPercentage, changed, estimatorSettings) => { };
var tc = new TelemetryConfiguration {
TelemetryChannel = new StubTelemetryChannel()
};
var channelBuilder = new TelemetryProcessorChainBuilder(tc);
channelBuilder.UseAdaptiveSampling(settings, callback);
channelBuilder.Build();
Assert.AreEqual(13, ((AdaptiveSamplingTelemetryProcessor)tc.TelemetryProcessorChain.FirstTelemetryProcessor).MaxSamplingPercentage);
}
private void AddSampling(TelemetryConfiguration configuration)
{
if (this.applicationInsightsServiceOptions.EnableAdaptiveSampling)
{
AdaptiveSamplingPercentageEvaluatedCallback samplingCallback = (ratePerSecond, currentPercentage, newPercentage, isChanged, estimatorSettings) =>
{
if (isChanged)
{
configuration.SetLastObservedSamplingPercentage(SamplingTelemetryItemTypes.Request, newPercentage);
}
};
SamplingPercentageEstimatorSettings settings = new SamplingPercentageEstimatorSettings();
settings.MaxTelemetryItemsPerSecond = 5;
configuration.DefaultTelemetrySink.TelemetryProcessorChainBuilder.UseAdaptiveSampling(settings, samplingCallback, excludedTypes: "Event");
configuration.DefaultTelemetrySink.TelemetryProcessorChainBuilder.UseAdaptiveSampling(5, includedTypes: "Event");
}
}
/// <summary>
/// Adds <see cref="AdaptiveSamplingTelemetryProcessor"/> to the <see cref="TelemetryProcessorChainBuilder" />
/// </summary>
/// <param name="builder">Instance of <see cref="TelemetryProcessorChainBuilder"/></param>
/// <param name="settings">Set of settings applicable to dynamic sampling percentage algorithm.</param>
/// <param name="callback">Callback invoked every time sampling percentage evaluation occurs.</param>
/// <return>Instance of <see cref="TelemetryProcessorChainBuilder"/>.</return>
public static TelemetryProcessorChainBuilder UseAdaptiveSampling(
this TelemetryProcessorChainBuilder builder,
SamplingPercentageEstimatorSettings settings,
AdaptiveSamplingPercentageEvaluatedCallback callback)
{
if (builder == null)
{
throw new ArgumentNullException("builder");
}
if (settings == null)
{
throw new ArgumentNullException("settings");
}
return(builder.Use(next => new AdaptiveSamplingTelemetryProcessor(settings, callback, next)
{
InitialSamplingPercentage = 100.0 / settings.EffectiveInitialSamplingRate
}));
}
/// <summary>
/// Initializes a new instance of the <see cref="SamplingPercentageEstimatorTelemetryProcessor"/> class.
/// <param name="settings">Dynamic sampling estimator settings.</param>
/// <param name="callback">Callback to invoke every time sampling percentage is evaluated.</param>
/// <param name="next">Next TelemetryProcessor in call chain.</param>
/// </summary>
public SamplingPercentageEstimatorTelemetryProcessor(
SamplingPercentageEstimatorSettings settings,
AdaptiveSamplingPercentageEvaluatedCallback callback,
ITelemetryProcessor next)
{
if (settings == null)
{
throw new ArgumentNullException("settings");
}
if (next == null)
{
throw new ArgumentNullException("next");
}
this.evaluationCallback = callback;
this.settings = settings;
this.next = next;
this.currenSamplingRate = settings.EffectiveInitialSamplingRate;
this.itemCount = new ExponentialMovingAverageCounter(settings.EffectiveMovingAverageRatio);
this.samplingPercentageLastChangeDateTime = DateTimeOffset.UtcNow;
// set evaluation interval to default value if it is negative or zero
this.evaluationInterval = this.settings.EffectiveEvaluationInterval;
// set up timer to run math to estimate sampling percentage
this.evaluationTimer = new Timer(
this.EstimateSamplingPercentage,
null,
this.evaluationInterval,
this.evaluationInterval);
}
