All notable changes to this project will be documented in this file.
This project adheres to Semantic Versioning.
This release is by far the most feature rich update of the reporter. This wouldn't be possible without the amazing contributions we received! 💛
See the documentation for the new version at https://hexdocs.pm/telemetry_metrics_statsd/0.4.0.
The reporter is now compatible with Telemetry.Metrics 0.5.0, which means that it respects the :keep
and :drop
options set on metrics.
The :buckets
option on distribution metrics is no longer required and it can be safely removed from these metric definitions (the option was redundant for the StatsD reporter since the beginning).
If you are running reporter in a high volume environment, you can now set the sampling rate of each metric via the :sampling_rate
reporter option, to limit the number of metric updates sent to the StatsD daemon.
And last but not least, we have a few enhancements in how Telemetry.Metrics map to metric types in StatsD/DataDog:
- Both formats now support exporting sum metric as a monotonically increasing counter (via
report_as: :counter
reporter option). - For DataDog, summary is now exported as a histogram, while distribution maps to DataDog distribution metric.
- Allow to specify an IP address as a target StatsD host (#23), by @hkrutzer.
- Accept an atom for the global metric prefix (#29), by @jasondew.
- Add support for sampling rate configurable per-metric (#28), by @samullen.
- Optionally send sum metric updates as StatsD counter updates (#30), by @jredville.
- Respect the
:keep
and:drop
options on metrics (#34), by @arkgil.
- Change the default host from
localhost
to127.0.0.1
in order to skip redundant IP address lookup (#23), by @hkrutzer.
:global_tags
options to specify static tag values available for all metrics under the reporter
This release adds support for Telemetry.Metrics summary metric, as well as integration with DataDog.
Telemetry.Metrics.summary/2
can be now included in a list of metrics tracked by the reporter:formatter
option which determines whether standard or DataDog metric format is used
First version of the library.