All notable changes to this project will be documented in this file. This project adheres to Semantic Versioning.
-
New
signature changed. The default address used is now ":8125". To use another address use theAddress
option:Before:
statsd.New(":8125") statsd.New(":9000")
After
statsd.New() statsd.New(statsd.Address(":9000"))
-
The
rate
parameter has been removed from theCount
andTiming
methods. Use the newSampleRate
option instead. -
Count
,Gauge
andTiming
now accept ainterface{}
instead of an int as the value parameter. So you can now use any type of integer or float in these functions. -
The
WithInfluxDBTags
andWithDatadogTags
options were replaced by theTagsFormat
andTags
options:Before:
statsd.New(statsd.WithInfluxDBTags("tag", "value")) statsd.New(statsd.WithDatadogTags("tag", "value"))
After
statsd.New(statsd.TagsFormat(statsd.InfluxDB), statsd.Tags("tag", "value")) statsd.New(statsd.TagsFormat(statsd.Datadog), statsd.Tags("tag", "value"))
-
All options whose named began by
With
had theWith
stripped:Before:
statsd.New(statsd.WithMaxPacketSize(65000))
After
statsd.New(statsd.MaxPacketSize(65000))
-
ChangeGauge
has been removed as it is a bad practice: UDP packets can be lost so using relative changes can cause unreliable values in the long term. UseGauge
instead which sends an absolute value. -
The
Histogram
method has been added. -
The
Clone
method was added to theClient
, it allows to create a newClient
with different rate / prefix / tags parameters while still using the same connection.