NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Go modules, #1892 by repository stars
Latest stable
v0.31.0
Last release 13 days ago
09 Nov 2026
Release timing varies
gaps range from 1 weeks to 3 months
Most releases are documented
notes for 51 of 57 stable releases
Nothing withdrawn
no release was ever pulled
12 years old
189 releases · first in 2015
Drag across the ruler to compare, or tap a release to open it.
[ENHANCEMENT] Use extracted go-kit/log to reduce transitive dependencies
Once again there is no functional change. For library users, the dependency tree shrinks considerably. See prometheus/common#255 for more details.
Nothing published for this version
Nothing published for this version
Your coding agent can read these notes before it upgrades. Set up the MCP server →
[BUGFIX] Remove copyleft licensed dependency
There is no functional change for exporter users. Removing this dependency reduces uncertainty for anyone reusing the mapping code.
Nothing published for this version
[CHANGE] [library] Split mapper caches out from mapper
Support for the deprecated attributes will be removed in a future release.
This completes support for summary_options and histogram_options.
Change the legacy configuration attributes throughout the mapping configuration as follows:
quantiles: … to summary_options: { quantiles: … }buckets: … to histogram_options: { buckets: … }timer_type to observer_type.Support for the deprecated attributes will be removed in a future release.
[BUGFIX] Don't return empty responses to lifecycle api requests
[CHANGE] [library] Require explicit Registerer
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
[ENHANCEMENT] Allow turning off tagging extensions
This release changes the interface for the github.com/prometheus/statsd_exporter/pkg/line library package to support the new configurability.
Nothing published for this version
[CHANGE] Support non-timer distributions without unit conversion
Distribution and histogram events (type d, h) are now treated as distinct from timer events (type ms).
Their values are observed as they are, while timer events are converted from milliseconds to seconds.
To reflect this generalization, the observer_type mapping option replaces timer_type.
Similary, change match_metric_type: timer to match_metric_type: observer.
The old name remains available for compatibility.
For users of the mapper library, the ObserverEvent replaces TimerEvent.
For timer metrics, it is emitted by the mapper already converted to seconds.
Nothing published for this version
Nothing published for this version
[CHANGE] Break out much of the exporter into reusable packages
This release mainly consists of an internal reorganization of the exporter. This should not have any impact on users of the binary, if it does, please file an issue.
For users of the existing library packages, nothing changes.
There are now multiple new packages available, exposing functionality that had been locked away in the main package. Consider the interfaces of these libraries preliminary; we will change them as we gain experience in how they are used.
For users of the mapper as a library, this is a breaking change. To adjust your code, replace mapping.Buckets with mapping.HistogramOptions.Buckets an…
To facilitate the expanded settings for summaries, the configuration format changes from
mappings:
- match: …
timer_type: summary
quantiles:
- quantile: 0.99
error: 0.001
- quantile: 0.95
error: 0.01
…
to
mappings:
- match: …
timer_type: summary
summary_options:
quantiles:
- quantile: 0.99
error: 0.001
- quantile: 0.95
error: 0.01
…
max_summary_age: 30s
summary_age_buckets: 3
stream_buffer_size: 1000
…
For consistency, the format for histogram buckets also changes from
mappings:
- match: …
timer_type: histogram
buckets: [ 0.01, 0.025, 0.05, 0.1 ]
to
mappings:
- match: …
timer_type: histogram
histogram_options:
buckets: [ 0.01, 0.025, 0.05, 0.1 ]
Transitionally, the old format will still work but is deprecated. The new settings are optional.
For users of the mapper
as a library, this is a breaking change. To adjust your code, replace
mapping.Buckets with mapping.HistogramOptions.Buckets and
mapping.Quantiles with mapping.SummaryOptions.Quantiles.
Nothing published for this version
[BUGFIX] Mapper cache poisoning when name is variable
[CHANGE] Switch logging to go-kit
Logs are more structured now. The fatal log level no longer exists; use --log.level=error instead. The valid log formats are logfmt and json.
The metric statsd_exporter_cache_length is now called statsd_metric_mapper_cache_length.
Nothing published for this version
[ENHANCEMENT] Support sampling factors for all statsd metric types
[BUGFIX] Fix Unix socket handler
[BUGFIX] Renew TTL when a metric receives updates
Nothing published for this version
* [BUGFIX] Fix TCP handler
[ENHANCEMENT] Batch event processing for improved ingestion performance
With #233, the exporter no longer exports metrics about its own HTTP status. These were not helpful since you could not get them when scraping fails. This allows mapping to metric names like http_requests_total that are useful as application metrics.
Nothing published for this version
[BUGFIX] Fix mapping collision for metrics with different types, but the same name
[BUGFIX] Fix "Error: inconsistent label cardinality: expected 0 label values but got N in prometheus.Labels"
[BUGFIX] Revert #218 due to a race condition
[ENHANCEMENT] Reduce allocations when escaping metric names
[CHANGE] Do not run as root in the Docker container by default
With #192, the count of events rejected because of negative counter increments has moved into the statsd_exporter_events_error_total metric, instead of being lumped in with the different kinds of successful events.
Note: 0.10.0 and 0.10.1 were eaten by CI.
Nothing published for this version
[ENHANCEMENT] Update the Prometheus client library to 0.9.2
If you are using summaries, all your quantiles and _total will change by a factor of 1000.
Adjust your queries and dashboards, or consider switching to histograms altogether.
[ENHANCEMENT] Update the Prometheus client library to 0.9.2
If you are using summaries, all your quantiles and _total will change by a factor of 1000.
Adjust your queries and dashboards, or consider switching to histograms altogether.
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
[BUGFIX] Expose the counter for unmapped matches
[ENHANCEMENT] Speed up glob matching
This release replaces the implementation of the glob matching mechanism, speeding it up significantly. In certain sub-optimal configurations, a warning is logged.
This major enhancement was contributed by Wangchong Zhou.
[ENHANCEMENT] Speed up glob matching
This release replaces the implementation of the glob matching mechanism, speeding it up significantly. In certain sub-optimal configurations, a warning is logged.
This major enhancement was contributed by Wangchong Zhou.
The deprecated --statsd.listen-address flag has been removed, use --statsd.listen-udp instead.
This is a breaking release, but the migration is easy: command line flags now
require two dashes (--help instead of -help). The previous flag library
already accepts this form, so if necessary you can migrate the flags first
before upgrading.
The deprecated --statsd.listen-address flag has been removed, use
--statsd.listen-udp instead.
Nothing published for this version
This is a non-breaking feature release.
This is a non-breaking feature release.
[IMPROVEMENT] Add a drop action (#115) [IMPROVEMENT] Allow templating metric names (#117)
A big thank you goes to @drawks for laying the ground for both features, as well as @bakins and @erickpintor for picking up the PRs and polishing them for release.
NOTE: This release breaks backward compatibility. statsd_exporter now uses a YAML configuration file. You must convert your mappings configuration to
NOTE: This release breaks backward compatibility. statsd_exporter now uses
a YAML configuration file. You must convert your mappings configuration to
the new format when you upgrade. For example, the configuration
test.dispatcher.*.*.*
name="dispatcher_events_total"
processor="$1"
action="$2"
outcome="$3"
job="test_dispatcher"
*.signup.*.*
name="signup_events_total"
provider="$2"
outcome="$3"
job="${1}_server"
now has the format
mappings:
- match: test.dispatcher.*.*.*
help: "The total number of events handled by the dispatcher."
name: "dispatcher_events_total"
labels:
processor: "$1"
action: "$2"
outcome: "$3"
job: "test_dispatcher"
- match: *.signup.*.*
name: "signup_events_total"
help: "The total number of signup events."
labels:
provider: "$2"
outcome: "$3"
job: "${1}_server"
The help field is optional.
There is a tool available to help with this conversion.
-statsd.add-suffix option flag #99. Users should remove
this flag when upgrading. Metrics will no longer automatically include the
suffixes _timer or counter. You may need to adjust any graphs that used
metrics with these suffixes.[IMPROVEMENT] Improve mapping configuration parser #61
Nothing published for this version
Nothing published for this version
Nothing published for this version
One column per quarter.