DatadogStatsD 0.2.5

DatadogStatsD

Full featured DogStatsD client:

• Count, Histogram, Gauge, Distribution, Set
• Events
• Service Checks
• UDP or UDS transport
• Performance - Metrics are aggregated and the submissions are batched
• Back pressure - Transport drops new metrics when it's falling behind
• Telemetry - Metrics to monitor communication between the agent and this client

Installation

DatadogStatsD targets both .NET Standard 2.0 & 2.1.

dotnet add package DatadogStatsD

Examples

await using var dogStatsD = new DogStatsD();

using var requests = dogStatsD.CreateCount("requests", new[] { "environment:dev" });
requests.Increment();
requests.Decrement();

var latency = dogStatsD.CreateHistogram("latency", sampleRate: 0.5);
latency.Sample(5.423);
latency.Sample(1.27);

using var threads = dogStatsD.CreateGauge("threads", () => Process.GetCurrentProcess().Threads.Count);

dogStasD.RaiseEvent(AlertType.Info, "Bad thing happened", "This happened");
dogStasD.SendServiceCheck("is_connected", CheckStatus.Ok);

See DogStatsDConfiguration.cs to configure the client.

Benchmark

Benchmark comparing performance of this library (DatadogStatsD), when sending 10000 metrics, with neuecc/DatadogSharp (DatadogSharp) and DataDog/dogstatsd-csharp-client (StatsDClient). Sources can be found in DatadogStatsD.Benchmark.

Count & Gauge

This library aggregates for 10 seconds (DogStatsD flush interval) counts and gauges, so for 10000 increments, one packet is sent, hence the ~0 bytes allocated.

Histogram, Set, Distribution

For those metrics, the library lets DogStatsD agent do the aggregation, so with a sample rate of 1.0, each call to Histogram.Update will be sent to the agent.