Update changelog and readme for #315: SignalFX extension

Declare the behavior with mixed tagging as undefined, we don't want to
promise anything in that case, not even negatively.

Signed-off-by: Matthias Rampke <matthias@prometheus.io>
This commit is contained in:
Matthias Rampke 2020-06-26 15:17:23 +00:00
parent 36de8c9e12
commit cc709f242c
No known key found for this signature in database
GPG key ID: F9AFF7F67ACE10BA
2 changed files with 10 additions and 4 deletions

View file

@ -2,6 +2,7 @@
* [CHANGE] Support non-timer distributions without unit conversion ([#314](https://github.com/prometheus/statsd_exporter/pull/314)) * [CHANGE] Support non-timer distributions without unit conversion ([#314](https://github.com/prometheus/statsd_exporter/pull/314))
* [ENHANCEMENT] Offline configuration check ([#312](https://github.com/prometheus/statsd_exporter/pull/312)) * [ENHANCEMENT] Offline configuration check ([#312](https://github.com/prometheus/statsd_exporter/pull/312))
* [ENHANCEMENT] Support the SignalFX tagging extension ([#315](https://github.com/prometheus/statsd_exporter/pull/315))
* [BUGFIX] Allow matching single-letter metric name components ([#309](https://github.com/prometheus/statsd_exporter/pull/309)) * [BUGFIX] Allow matching single-letter metric name components ([#309](https://github.com/prometheus/statsd_exporter/pull/309))
Distribution and histogram events (type `d`, `h`) are now treated as distinct from timer events (type `ms`). Distribution and histogram events (type `d`, `h`) are now treated as distinct from timer events (type `ms`).

View file

@ -31,7 +31,7 @@ in the long term.
### Tagging Extensions ### Tagging Extensions
The exporter supports Librato, InfluxDB, and DogStatsD-style tags, The exporter supports Librato, InfluxDB, DogStatsD, and SignalFX-style tags,
which will be converted into Prometheus labels. which will be converted into Prometheus labels.
For Librato-style tags, they must be appended to the metric name with a For Librato-style tags, they must be appended to the metric name with a
@ -68,9 +68,14 @@ in the DogStatsD documentation for the concept description and
If you encounter problems, note that this tagging style is incompatible with If you encounter problems, note that this tagging style is incompatible with
the original `statsd` implementation. the original `statsd` implementation.
Be aware: If you mix tag styles (e.g., Librato/InfluxDB with DogStatsD), the For [SignalFX dimension](https://docs.signalfx.com/en/latest/integrations/agent/monitors/collectd-statsd.html#adding-dimensions-to-statsd-metrics), add the tags to the metric name in square brackets, as so:
exporter will consider this an error and the sample will be discarded. Also,
tags without values (`#some_tag`) are not supported and will be ignored. ```
metric.name[tagName=val,tag2Name=val2]:0|c
```
Be aware: If you mix tag styles (e.g., Librato/InfluxDB with DogStatsD), the exporter will consider this an error and the behavior is undefined.
Also, tags without values (`#some_tag`) are not supported and will be ignored.
## Building and Running ## Building and Running