NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
NuGet
NuGet, #743 most downloaded on NuGet
A DogStatsD client library for .NET. DogStatsD is an extension of the StatsD metric server for use with Datadog. For more information visit https://datadoghq.com.
Latest stable
9.2.1
Last release 3 months ago
27 Jul 2026
Ships unpredictably
gaps range from 2 weeks to 3.6 years
Most releases are documented
notes for 22 of 27 stable releases
1 version withdrawn
withdrawn after publishing
127 years old
28 releases · first in 1900
Drag across the ruler to compare, or tap a release to open it.
[BUGFIX] Prevent named pipe write failures from causing unbounded thread growth. The telemetry timer now reschedules itself after each round instead o
[IMPROVEMENT] Use default scheduler for worker tasks. See [#205][].
Mono.Unix dependency. See [#223][].Your coding agent can read these notes before it upgrades. Set up the MCP server →
9.2.0
Compare
[FEATURE] Support sending counters and gauges with timestamp. See #185 and #188. These PRs add a default parameter to the methods of DogStatsdService,
[FEATURE] Support sending counters and gauges with timestamp. See #185 and #188.
These PRs add a default parameter to the methods of DogStatsdService, DogStatsd and IDogStatsd. They also remove params for tags in IDogStatsd.Decrement.
[COMPATIBILITY] Remove support for old frameworks. See #186.
This PR updates the targeted frameworks from netstandard1.3;netstandard2.0;netstandard2.1;net45;net461 to net461;netstandard2.0;netcoreapp3.1;net6.0
It means netstandard1.3 and net45 are not supported anymore.
[IMPROVEMENT] Add an exception handler. See #183 and #187.
These PRs add a default parameter to DogStatsdService.Configure, DogStatsd.Configure and IDogStatsd.Configure
[IMPROVEMENT] Add a Flush method to IDogStatsd. See #182.
This PR adds a new method to IDogStatsd.
[BUGFIX] Don't throw an exception when the size of the metric exceeds the internal buffer capacity. See #178.
By default, metrics are aggregated before they are sent. For example, instead of sending 3 times my_metric:10|c|#tag1:value, DogStatsD client sends my
By default, metrics are aggregated before they are sent. For example, instead of sending 3 times my_metric:10|c|#tag1:value, DogStatsD client sends my_metric:30|c|#tag1:value once. You can disable client-side aggregation by setting ClientSideAggregation property to null.
For more details about how client-side aggregation works see #134.
Enabling client-side aggregation has the benefit of reducing the network usage and also reducing the load for the DataDog Agent.
When an application sends a lot of different contexts but each context appear with a very low frequency, then enabling client-side aggregation may take more memory and more CPU. A context identifies a metric name, a tag sets and a metric type. The metric datadog.dogstatsd.client.aggregated_context reported by DogStatsD C# client counts the number of contexts in memory used for client-side aggregation. There is also the metric datadog.dogstatsd.client.metrics_by_type that represents the number of metrics submitted by the client before aggregation.
This PR changes the default values for unix domain socket and UDP buffer sizes.
In most cases, this change should work out of the box. Unlike Windows and Linux, on some operating systems like MacOS, the maximum unix domain socket buffer size is lower than 8192. For these systems you have to set StatsdMaxUnixDomainSocketPacketSize to the maximum supported value.
Methods Counter, Gauge, Histogram, Distribution and Timer from DogStatsdService and DogStatsd are not generic methods anymore. (See https://github.com
Counter, Gauge, Histogram, Distribution and Timer from DogStatsdService and DogStatsd are not generic methods anymore. (See https://github.com/DataDog/dogstatsd-csharp-client/pull/133/commits/ab18f9572de3bfe76fb95b5fce14d6ee965b62d4)StatsdConfig.DD_ENTITY_ID_ENV_VAR, StatsdConfig.DD_DOGSTATSD_PORT_ENV_VAR and StatsdConfig.DD_AGENT_HOST_ENV_VARpublic to internal for: ICommandType, IRandomGenerator, IStopWatchFactory, IStopwatch, MetricsTimer, RandomGenerator, StopWatchFactory, Stopwatch, ThreadSafeRandom and StatsdUDP.Statsd, IStatsd and IStatsdUDP.DD_AGENT_PIPE_NAME to DD_DOGSTATSD_PIPE_NAME.Flush method. See #144.[IMPROVEMENT] Reduce the memory allocations. See #123, #124, #127 and #132.
[BUGFIX] Fix an issue where the client cannot send metrics after the DogStatsd server restart. See #125.
[BUGFIX] Fix System.Net.Sockets.SocketException when telemetry is enabled and Statsd server is not up. See #120.
Significant improvements of DogStatsdService and DogStatsd performance.
Significant improvements of DogStatsdService and DogStatsd performance.
You must call DogStatsdService.Dispose() or DogStatsd.Dispose() before your program termination in order to flush metrics not yet sent.
Statsd is marked as obsolete.
[BUGFIX] Fix System.ArgumentException: unixSocket must start with unix:// when using the DD_AGENT_HOST environment variable with UDS support. See this
System.ArgumentException: unixSocket must start with unix:// when using the DD_AGENT_HOST environment variable with UDS support. See this comment (Thanks @danopia)Version 3.4.0 uses a strong-named assembly that may introduce a breaking change. This major version change makes this breaking change explicit. No oth…
Version 3.4.0 uses a strong-named assembly that may introduce a breaking change.
This major version change makes this breaking change explicit. No other breaking changes are expected.
Nothing published for this version
Nothing published for this version
[FEATURE] Option to set global tags that are added to every statsd call. See [#3][], [#78][] (Thanks [@chriskinsman][])
<!--- The following link definition list is generated by PimpMyChangelog ---> [#3]: https://github.com/DataDog/dogstatsd-csharp-client/issues/3 [#78]: https://github.com/DataDog/dogstatsd-csharp-client/issues/78 [@chriskinsman]: https://github.com/chriskinsman
[BUGFIX] Fix an issue causing the StartTimer method to ignore non static DogStatsdService instance configurations. See [#62][], [#63][] (Thanks [@jpas
StartTimer method to ignore non static DogStatsdService instance configurations. See [#62][], [#63][] (Thanks [@jpasichnyk][])tags in the Decrement method similar to Increment. See [#60][], [#61][] (Thanks [@sqdk][])<!--- The following link definition list is generated by PimpMyChangelog ---> [#60]: https://github.com/DataDog/dogstatsd-csharp-client/issues/60 [#61]: https://github.com/DataDog/dogstatsd-csharp-client/issues/61 [#62]: https://github.com/DataDog/dogstatsd-csharp-client/issues/62 [#63]: https://github.com/DataDog/dogstatsd-csharp-client/issues/63 [#65]: https://github.com/DataDog/dogstatsd-csharp-client/issues/65 [#66]: https://github.com/DataDog/dogstatsd-csharp-client/issues/66 [@jpasichnyk]: https://github.com/jpasichnyk [@nrjohnstone]: https://github.com/nrjohnstone [@sqdk]: https://github.com/sqdk
DogStatsD-CSharp-Client 3.1.0 supports the following platforms:
DogStatsD-CSharp-Client 3.1.0 supports the following platforms:
DogStatsdService implements IDogStatsd. See [#43][], [#54][]IDisposable interface to DogStatsdService to manage the release of resources. See [#44][] (Thanks [@bcuff][])StatsdConfig.StatsdTruncateIfTooLong option to truncate Events and Service checks larger than 8 kB (default to True). See [#48][], [#55][]<!--- The following link definition list is generated by PimpMyChangelog ---> [#43]: https://github.com/DataDog/dogstatsd-csharp-client/issues/43 [#44]: https://github.com/DataDog/dogstatsd-csharp-client/issues/44 [#48]: https://github.com/DataDog/dogstatsd-csharp-client/issues/48 [#50]: https://github.com/DataDog/dogstatsd-csharp-client/issues/50 [#52]: https://github.com/DataDog/dogstatsd-csharp-client/issues/52 [#54]: https://github.com/DataDog/dogstatsd-csharp-client/issues/54 [#55]: https://github.com/DataDog/dogstatsd-csharp-client/issues/55 [@DanielVukelich]: https://github.com/DanielVukelich [@bcuff]: https://github.com/bcuff [@pdpurcell]: https://github.com/pdpurcell
DogStatsD-CSharp-Client 2.2.1 is the last version to support .NET Framework 3.5. As of 3.0.0, DogStatsD-CSharp-Client supports the following platforms
DogStatsD-CSharp-Client 2.2.1 is the last version to support .NET Framework 3.5. As of 3.0.0, DogStatsD-CSharp-Client supports the following platforms:
<!--- The following link definition list is generated by PimpMyChangelog --->
[BUGFIX] Remove the TRACE directive from release builds. See #33, #34 (Thanks @albertofem)
TRACE directive from release builds. See #33, #34 (Thanks @albertofem)<!--- The following link definition list is generated by PimpMyChangelog --->
[BUGFIX] Fix Random generator thread safety. See #26 (Thanks @windsnow98)
Random generator thread safety. See #26 (Thanks @windsnow98)<!--- The following link definition list is generated by PimpMyChangelog --->
[BUGFIX] Optional automatic truncation of events that exceed the message length limit. See #22 (Thanks @daniel-chambers)
[BUGFIX][IMPROVEMENT] Fix DogStatsd unsafe thread operations. See #18 (Thanks @yori-s)
[BUGFIX] Fix event's text escape when it contains windows carriage returns. See #15 (Thanks @anthonychu)
Nothing published for this version
Nothing published for this version
Nothing published for this version
UDP packets containing multiple metrics that are over the UDP packet size limit will now be split into multiple appropriately-sized packets if possibl
Nothing published for this version
One column per quarter.