ApplicationMetrics.MetricLoggers.MongoDb 1.0.0

ApplicationMetrics.MetricLoggers.MongoDb

An implementation of an ApplicationMetrics metric logger which writes metrics and instrumentation to a MongoDB database.

Setup

The code below demonstrates the setup and use case (with fake metrics logged) of the MongoDbMetricLogger class...

using (var bufferProcessor = new SizeLimitedBufferProcessor(5))
using (var metricLogger = new MongoDbMetricLogger
(
    "DefaultCategory",
    "mongodb://127.0.0.1:27017",
    "ApplicationMetrics",
    bufferProcessor,
    IntervalMetricBaseTimeUnit.Nanosecond,
    true
))
{
    metricLogger.Start();

    Guid beginId = metricLogger.Begin(new MessageSendTime());
    Thread.Sleep(20);
    metricLogger.Increment(new MessageSent());
    metricLogger.Add(new MessageSize(), 2661);
    metricLogger.End(beginId, new MessageSendTime());

    metricLogger.Stop();
}

The MongoDbMetricLogger class accepts the following constructor parameters...

Storage

4 collections are created in the specified MongoDB database, which store the metrics...

Note that timestamps in MongoDB have only millisecond precision by default, hence metric events timestamps are stored in 2 properties in each document, as per the below table...

An example of event timestamps queried from MongoDB is as follows...

{
	"_id" : ObjectId("6979616fd47069ae771e0141"),
	"Category" : "DefaultCategory",
	"EventTime" : ISODate("2026-01-28T01:07:59.112Z"),
	"EventTimeTicks" : Long("639051592791127525"),
	"AmountMetric" : "DiskBytesRead",
	"Amount" : Long("2048")
}

Storing metric event timestamps using both properties gives both readability, and complete precision/accuracy.

Non-interleaved Method Overloads

Methods which support 'non-interleaved' interval metric logging (i.e. overloads of End() and CancelBegin() methods which don't accept a Guid) will be deprecated in a future version of ApplicationMetrics. Hence it's recommended to only use the End() and CancelBegin() method overloads which accept a 'beginId' Guid parameter.

Links

The documentation below was written for version 1.* of ApplicationMetrics. Minor implementation details may have changed in versions 2.0.0 and above, however the basic principles and use cases documented are still valid. Note also that this documentation demonstrates the older 'non-interleaved' method of logging interval metrics.

Full documentation for the project...<br /> http://www.alastairwyse.net/methodinvocationremoting/application-metrics.html

A detailed sample implementation...<br /> http://www.alastairwyse.net/methodinvocationremoting/sample-application-5.html

Release History