JitterMagic

A c# library to add jitter to cache durations and retry intervals to increase entropy in your system and prevent thundering herds

Why?

The library is inspired by YouTube's strategy to add entropy to large systems by adding randomness to cache expiry durations

Use it with either the default percentage of 25

int cacheDuration = Jitter.Apply(1000);

or by supplying a settings object with different percentage yourself

int cacheDuration = Jitter.Apply(1000, new JitterSettings(percentage: 50));

Also works for doubles

double cacheDuration = Jitter.Apply(1000D);

or by supplying different settings yourself

double cacheDuration = Jitter.Apply(1000D, new JitterSettings(percentage: 50));

The following default settings are used and can be changed by using the code below with different values

Jitter.UpdateSettings(new JitterSettings(percentage: 25));

If you wish to be able to inject it - for example for having different percentages in different places - you can use the JitterInstance class:

IJitterInstance instance = new JitterInstance(new JitterSettings(percentage: 25));

This interface and class only has the Apply methods without settings, because you already provide those during construction.

So it provides the following function for integers

int cacheDuration = instance.Apply(1000);

And also works for doubles

double cacheDuration = instance.Apply(1000D);

First, install NuGet. Then, install JitterMagic from the package manager console:

PM> Install-Package JitterMagic