@@ -318,9 +318,7 @@ the exponential bucketing featured by the standard schemas is a bad match for
318
318
the distribution to be represented by the histogram. Histograms with different
319
319
custom bucket boundaries are generally not mergeable with each other.
320
320
Therefore, schema -53 SHOULD only be used as an informed decision in specific
321
- use cases. (TODO: NHCB aren't fully merged into main as of now (2024-11-03).
322
- They are worked into this document as far as possible already. This information
323
- might not yet be relevant for released Prometheus versions.)
321
+ use cases.
324
322
325
323
### Buckets
326
324
@@ -688,8 +686,11 @@ message BucketSpan {
688
686
// [...]
689
687
```
690
688
691
- (TODO: The above does not yet contain the custom values needed for NHCBs. Update
692
- once merged into main.)
689
+ (TODO: The above does not yet contain the custom values needed for NHCBs. We do
690
+ not need it right now because NHCB can be ingested via scraping classic
691
+ histograms. However, it might still be useful to have custom buckets in the
692
+ exposition format eventually, e.g. for federation, and for future schemas that
693
+ might also utilize the custom values.)
693
694
694
695
Note the following:
695
696
@@ -1117,8 +1118,9 @@ as just one series with their unmodified name. (Example: A histogram called
1117
1118
### Scraping classic histograms as NHCBs
1118
1119
1119
1120
The aforementioned NHCB is capable of modeling a classic histogram as a native
1120
- histogram. Prometheus can be configured to ingest classic histograms as NHCBs
1121
- rather than classic histograms. (TODO: Explain how to do that once it is merged.)
1121
+ histogram. Via the boolean scrape config option
1122
+ ` convert_classic_histograms_to_nhcb ` , Prometheus can be configured to ingest
1123
+ classic histograms as NHCBs.
1122
1124
1123
1125
NHCBs have the same issue with limited mergeability as classic histograms, but
1124
1126
they are generally much less expensive to store.
0 commit comments