From 143a588871cb4ffdc4e9a1f9aed087c9c26e4372 Mon Sep 17 00:00:00 2001 From: Brian Akins Date: Tue, 14 Nov 2017 11:04:52 -0500 Subject: [PATCH 1/3] Preperation for v0.5.0 release --- CHANGELOG.md | 17 +++++++++++++++++ VERSION | 2 +- 2 files changed, 18 insertions(+), 1 deletion(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index c9577f7..bc18f1f 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,3 +1,20 @@ +## v 0.5.0 / 2017-11-14 + +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. + +* [CHANGE] Use YAML for configuration file +* [BUGFIX] Fix matching empty statsd metric components #105 +* [CHANGE] Reduce log levels #92 +* [CHANGE] Removed `-statsd.add-suffix` option flag #99 +* [IMPROVEMENT] Allow help text to be customized #87 +* [IMPROVEMENT] Add support for regex mappers #85 +* [BUGFIX] Fixes for crashes with conflicting metric values #72 +* [IMPROVEMENT] Add TCP listener support #71 +* [IMPROVEMENT] Allow histograms for timer metrics #66 +* [IMPROVEMENT] Added support for sampling factor on timing events #28 + ## v0.4.0 / 2017-05-12 * [IMPROVEMENT] Improve mapping configuration parser #61 diff --git a/VERSION b/VERSION index 1d0ba9e..8f0916f 100644 --- a/VERSION +++ b/VERSION @@ -1 +1 @@ -0.4.0 +0.5.0 From a4c9927b8909daaaa3d4d3f4f4cf32f9c382335b Mon Sep 17 00:00:00 2001 From: Brian Akins Date: Wed, 15 Nov 2017 07:03:40 -0500 Subject: [PATCH 2/3] Add example for config file. Rearrange list of changes --- CHANGELOG.md | 58 ++++++++++++++++++++++++++++++++++++++++++++++------ 1 file changed, 52 insertions(+), 6 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index bc18f1f..886d5f7 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -2,18 +2,64 @@ 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. +the new format when you upgrade. For example, the configuration -* [CHANGE] Use YAML for configuration file -* [BUGFIX] Fix matching empty statsd metric components #105 -* [CHANGE] Reduce log levels #92 -* [CHANGE] Removed `-statsd.add-suffix` option flag #99 +``` +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 + +```yaml +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](https://github.com/bakins/statsd-exporter-convert) available to help with this conversion. + +* [CHANGE] Replace the overloaded "packets" metric (#106) +* [CHANGE] Removed `-statsd.add-suffix` option flag #99. Users should remove +this flag wgen 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. +* [CHANGE] Reduce log levels #92. Many log events have been changed from error +to debug log level. +* [CHANGE] Use YAML for configuration file #66. See note above about file format +conversion. * [IMPROVEMENT] Allow help text to be customized #87 * [IMPROVEMENT] Add support for regex mappers #85 -* [BUGFIX] Fixes for crashes with conflicting metric values #72 * [IMPROVEMENT] Add TCP listener support #71 * [IMPROVEMENT] Allow histograms for timer metrics #66 * [IMPROVEMENT] Added support for sampling factor on timing events #28 +* [BUGFIX] Conflicting label sets no longer crash the exporter and will be +ignored. Restart to clear the remembered label set. #72 ## v0.4.0 / 2017-05-12 From 50a5c3e5f76c1e811c205a39481537f5921be702 Mon Sep 17 00:00:00 2001 From: Brian Akins Date: Thu, 16 Nov 2017 08:18:16 -0500 Subject: [PATCH 3/3] Formatting and typo fixes --- CHANGELOG.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 886d5f7..3754b7f 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -46,20 +46,20 @@ There is a [tool](https://github.com/bakins/statsd-exporter-convert) available t * [CHANGE] Replace the overloaded "packets" metric (#106) * [CHANGE] Removed `-statsd.add-suffix` option flag #99. Users should remove -this flag wgen 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. + 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. * [CHANGE] Reduce log levels #92. Many log events have been changed from error -to debug log level. + to debug log level. * [CHANGE] Use YAML for configuration file #66. See note above about file format -conversion. + conversion. * [IMPROVEMENT] Allow help text to be customized #87 * [IMPROVEMENT] Add support for regex mappers #85 * [IMPROVEMENT] Add TCP listener support #71 * [IMPROVEMENT] Allow histograms for timer metrics #66 * [IMPROVEMENT] Added support for sampling factor on timing events #28 * [BUGFIX] Conflicting label sets no longer crash the exporter and will be -ignored. Restart to clear the remembered label set. #72 + ignored. Restart to clear the remembered label set. #72 ## v0.4.0 / 2017-05-12