Server side analytics

Fork me on GitHub

I wanted to keep trace of visitors and know the usual stuff of web analytics: visitors, source, nationality, behaviour and so on.
And client side analytics are not so reliable:

  • Ad Blockers interfere with them
  • Using a third party service require to annoy the user with those huge cookie consent banners
  • They drastically increase the loading time of the web application
  • They don't register API calls and any other not-html calls like web api

So i developed by myself a very simple server side analytics system for Dot Net Core, which is running on this website.

Live demo here

How to

The very basic use of analytics is invoking the UseServerSideAnalytics extension in your application startup code

public void Configure(IApplicationBuilder app)
   app.UseServerSideAnalytics(new MongoAnalyticStore("mongodb://"));

I'm using Mongo DB to store my data because is my preferred database but you can you whatever database system you like, by implementing IAnalyticStore or by using one of my nugget:

Reading from the store

To show collected data in your app the best practice is to use the dependency injection pattern, like any other AspNet Core service.
To do that bind IAnalyticStore into the ConfigureServices system method.


//Asp Net Core system call where service are binded to container 
public void ConfigureServices(IServiceCollection services)
   //Here we bind IAnalyticStore to READ
   services.AddTransient<IAnalyticStore>(_=> GetAnalyticStore());

//Asp Net Core system call where web application is setted up
public void Configure(IApplicationBuilder app)
   //Here we bind IAnalyticStore to WRITE

private IAnalyticStore GetAnalyticStore() => 
	new MongoAnalyticStore("mongodb://");

Configuring the analytic system

By default Server Side Analytic keeps trace of every request.
But obviously not everyone cares of every request that comes to his web application.
By making this system running for a month I found thousand of request from crawlers fecthing robots.txt and honestly I don't care about them.
So how to filter request we don't care of ? By fluid extension methods. Here a brief example copy pasted from my website


public void Configure(IApplicationBuilder app)
	// Request into those url spaces will be not recorded
        .ExcludePath("/js", "/lib","/css")     
	// Request ending with this extension will be not recorded
	.ExcludeExtension(".jpg", ".ico", "robots.txt", "sitemap.xml")
        // Request coming from local host will be not recorded

Configuring analytics for API

What I shown above is a way to configure analytics for a web site but what if I want to use server side analytics just to measure the usage of my API ?
Just exclude anything else by using the fluid method LimitToPath


public void Configure(IApplicationBuilder app)
         //Anything outside of this url space will be ignored
.LimitToPath("/webapi"); }

Configuring the store

Every store takes use two default table (or collection on Mongo) to store his data:

  • SSARequest : to store recieved requests
  • SSAGeoIp: to store IP address ranges used in ip geo coding

To change those default settings use fluid methods RequestTable and GeoIpTable
private IAnalyticStore GetAnalyticStore() => 
	(new SqlServerAnalyticStore(Config.ConnectionString))
	    //Change the default table where request are stored
             //Change the default table where request are stored

IP Geocoding

The store tries to resolve the country of incoming request by IP geocoding on local database via those methods:

  • StoreGeoIpRangeAsync: which stores an IP range and relative country
  • ResolveCountryCodeAsync: which is called by ServerSideAnalytics internals to detect the country of incoming requests

If no corresponding IP range has been found CountryCode.World is assigned to the request.

Filling the database with IP range can be quite painfully, I spent hours downloading CSV from different sources just found that biggest part of detected countries was wrong or not found.
So I wrote an another library ServerSideAnalytics.Extensions which contains some useful methods for make calculation on requests time series and three extension to add remote ip geocoding.
Those extensions will encapsulate the current store into another which will try to resolve the geocoding locally and if it fails makes a call to a remote service to obtain the country and store it into local database


public IAnalyticStore GetAnalyticStore()
     var store = (new MongoAnalyticStore("mongodb://"))
	         //Use Ip Stack remote service (
		.UseIpStackFailOver("API KEY")
		 //Use Ip Api remote service (
		  //Use Ip Info remote service (
		.UseIpInfoFailOver("MY TOKEN");
return store; }