Skip to content

Commit

Permalink
Document incompatibility with Graphite bridge
Browse files Browse the repository at this point in the history
Closes #165 #168.

Using this exporter together with the Graphite bridge (at least the one
in the Python client) does not work. Discourage trying this; point at
alternatives instead.

Signed-off-by: Matthias Rampke <[email protected]>
  • Loading branch information
matthiasr committed Oct 29, 2021
1 parent df6443c commit 166fbf3
Showing 1 changed file with 11 additions and 3 deletions.
14 changes: 11 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -149,9 +149,7 @@ docker run -d -p 9108:9108 -p 9109:9109 -p 9109:9109/udp \
prom/graphite-exporter --graphite.mapping-config=/tmp/graphite_mapping.conf
```

## Importing Whisper data

**EXPERIMENTAL**
## **Experimental**: Importing Whisper data

Import data from Graphite using the bundled `getool`.
See `getool create-blocks --help` for usage.
Expand All @@ -161,6 +159,16 @@ The `--block-duration` must be a power of two in hours, e.g. `4h`, `8h`, and so

To merge the data into an existing Prometheus storage directory, start Prometheus with the `--storage.tsdb.allow-overlapping-blocks` flag.

## Incompatibility with Graphite bridge

This exporter does not work in combination with the [Java client](https://prometheus.github.io/client_java/io/prometheus/client/bridge/Graphite.html) or [Python client](https://github.com/prometheus/client_python#graphite) Graphite bridge.
In the transition to the Graphite data model and back, information is lost.
Additionally, default metrics conflict between the client libraries and the exporter.

Instead, configure Prometheus to scrape your application directly, without the exporter in the middle.
If you absolutely must push, consider the [Grafana agent](https://github.com/grafana/agent) instead.


[circleci]: https://circleci.com/gh/prometheus/graphite_exporter
[hub]: https://hub.docker.com/r/prom/graphite-exporter/
[travis]: https://travis-ci.org/prometheus/graphite_exporter
Expand Down

0 comments on commit 166fbf3

Please sign in to comment.