Releases: kamon-io/kamon-prometheus
v2.0.0-RC1 - Upgrade to Kamon 2.0.0-RC1
Same features, just upgraded to Kamon 2.0.0-RC1.
v1.1.2 - Metric Overrides and Tag Manipulation
Highlights
Metrics Overrides and Tag Manipulation
This release ships an additional metrics reporter that can wrap the Prometheus reporter (or, as a matter of fact, any other reporter) and perform three actions:
- Change the metric name
- Remove tags
- Rename tags
All via configuration! For example, with the following configuration:
kamon.prometheus {
metric-overrides {
"span.processing-time" {
name = "operation.duration"
delete-tags = [ "user-id" ]
rename-tags {
"operation" = "endpoint"
}
}
}
}
The span.processing-time
metric will be renamed to operation.duration
, the user-id
tag will be removed from all time series of this metric, and, the operation
tag name will be replaced by endpoint
(the tag values remain the same).
To start using the overrides functionality you will need to wrap your reporter with the MetricOverrideReporter
as shown bellow:
val promReporter = new PrometheusReporter()
val reporterWithOverrides = new MetricOverrideReporter(promReporter, overridesConfig)
Kamon.addReporter(reporterWithOverrides)
Summary
New Features
- Now you can override metric names and tags, as well as delete tags from metrics. This feature was contributed by @GlassAndOneHalf and @fazy viea #19. Thanks a lot!
v1.1.1 - Fix Custom Buckets Configuration
Fixes:
- #16 Custom buckets configuration was not working for strings with dots. Reported by @ashokwaghmare and fixed by @ivantopo on ad4d168.
v1.1.0 - Custom Histogram Buckets and Environment Tags
Highlights
Environment Tags
Starting on this version the module can make use of the environment tags introduced on Kamon 1.1.0 and add these tags to all exposed metrics. The newly introduced kamon.prometheus.include-environment-tags
configuration setting controls whether to add the tags or not.
Custom Histogram Buckets
Now you can control the bucket boundaries for any exposed metric by providing your custom bucketing via configuration:
kamon.prometheus.buckets.custom {
"akka.actor.processing-time" = [0.1, 0.5, 2]
}
Summary
Improvements
- Include environment tags on exposed metrics. Contributed by @CasperKoning on #10, thanks to @japgolly for helping on the review!
- Allow configuring custom histogram buckets for metrics. Contributed by @StephenKing on #14.