Skip to content

Commit

Permalink
feat/Update exporter/prometheusremotewriteexporter/README.md
Browse files Browse the repository at this point in the history
Co-authored-by: Arthur Silva Sens <[email protected]>
  • Loading branch information
bmiguel-teixeira and ArthurSens authored Nov 21, 2024
1 parent 2498ea3 commit 2978d8c
Showing 1 changed file with 5 additions and 5 deletions.
10 changes: 5 additions & 5 deletions exporter/prometheusremotewriteexporter/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -154,14 +154,14 @@ sum by (namespace) (app_ads_ad_requests_total)

**DISCLAIMER**: This snippet applies only to Prometheus, other remote write destinations using Prometheus Protocol (ex: Thanos/Grafana Mimir/VictoriaMetrics) may have different settings.

By default, Prometheus tipically expects samples to be ingested sequentially, in temporal order.
By default, Prometheus expects samples to be ingested sequentially, in temporal order.

When multiple consumers are enabled, the temporal ordering the samples written to the target destination is not deterministic and temporal ordering can no longer be garanteed. Example: one worker may be pushing a sample for `t+30s` and a second worker may push an additional sample but for `t+15s`.
When multiple consumers are enabled, the temporal ordering of the samples written to the target destination is not deterministic, and temporal ordering can no longer be guaranteed. For example, one worker may push a sample for `t+30s`, and a second worker may push an additional sample but for `t+15s`.

Vanilla Prometheus configurations will reject these unordered samples. You will find similar error to this `Error on ingesting out-of-order samples`.
Vanilla Prometheus configurations will reject these unordered samples and you'll receive "out of order" errors.

For enabling multiple consumers, it is necessary to enable out-of-order support in Prometheus.
This can be done by using the `tsdb.out_of_order_time_window: 10m` settings. Please choose an appropriate time window to support pushing the worst case scenarios of a "queue" build up on the sender side.
Out-of-order support in Prometheus must be enabled for multiple consumers.
This can be done by using the `tsdb.out_of_order_time_window: 10m` settings. Please choose an appropriate time window to support pushing the worst-case scenarios of a "queue" build-up on the sender side.

See for more info:
- https://prometheus.io/docs/prometheus/latest/configuration/configuration/#tsdb
Expand Down

0 comments on commit 2978d8c

Please sign in to comment.