Document implications of negative observations

Signed-off-by: beorn7 <[email protected]>
prometheus · May 26, 2021 · f34145a · f34145a
1 parent a7515ca
commit f34145a
Show file tree

Hide file tree

Showing 2 changed files with 12 additions and 2 deletions.
diff --git a/prometheus/histogram.go b/prometheus/histogram.go
@@ -47,7  47,12 @@ type Histogram interface {
 	Metric
 	Collector
 
-	// Observe adds a single observation to the histogram.
 	// Observe adds a single observation to the histogram. Observations are
 	// usually positive or zero. Negative observations are accepted but
 	// prevent current versions of Prometheus from properly detecting
 	// counter resets in the sum of observations. See
 	// https://prometheus.io/docs/practices/histograms/#count-and-sum-of-observations
 	// for details.
 	Observe(float64)
 }
 

diff --git a/prometheus/summary.go b/prometheus/summary.go
@@ -55,7  55,12 @@ type Summary interface {
 	Metric
 	Collector
 
-	// Observe adds a single observation to the summary.
 	// Observe adds a single observation to the summary. Observations are
 	// usually positive or zero. Negative observations are accepted but
 	// prevent current versions of Prometheus from properly detecting
 	// counter resets in the sum of observations. See
 	// https://prometheus.io/docs/practices/histograms/#count-and-sum-of-observations
 	// for details.
 	Observe(float64)
 }