feat(ui): mark native histograms as stable in ui strings

Plus some docstrings

Signed-off-by: György Krajcsovits <gyorgy.krajcsovits@grafana.com>
This commit is contained in:
György Krajcsovits 2025-10-24 12:32:15 +02:00
parent c929578718
commit 18efd9d629
No known key found for this signature in database
GPG Key ID: 47A8F9CE80FD7C7F
4 changed files with 15 additions and 26 deletions

View File

@ -572,8 +572,8 @@ var (
// DefaultProtoFirstScrapeProtocols is like DefaultScrapeProtocols, but it
// favors protobuf Prometheus exposition format.
// Used by default for certain feature-flags like
// "native-histograms" and "created-timestamp-zero-ingestion".
// Used by default by the "scrape_native_histograms" option and for certain
// feature-flags like "created-timestamp-zero-ingestion".
DefaultProtoFirstScrapeProtocols = []ScrapeProtocol{
PrometheusProto,
OpenMetricsText1_0_0,

View File

@ -563,7 +563,7 @@ func (w *Watcher) readSegment(r *LiveReader, segmentNum int, tail bool) error {
w.writer.AppendExemplars(exemplars)
case record.HistogramSamples, record.CustomBucketsHistogramSamples:
// Skip if experimental "histograms over remote write" is not enabled.
// Skip if "native histograms over remote write" is not enabled.
if !w.sendHistograms {
break
}
@ -591,7 +591,7 @@ func (w *Watcher) readSegment(r *LiveReader, segmentNum int, tail bool) error {
}
case record.FloatHistogramSamples, record.CustomBucketsFloatHistogramSamples:
// Skip if experimental "histograms over remote write" is not enabled.
// Skip if "native histograms over remote write" is not enabled.
if !w.sendHistograms {
break
}

View File

@ -1010,8 +1010,7 @@ const funcDocs: Record<string, React.ReactNode> = {
<>
<p>
<em>
This function only acts on native histograms, which are an experimental feature. The behavior of this function may
change in future versions of Prometheus, including its removal from PromQL.
This function only acts on native histograms.
</em>
</p>
@ -1043,8 +1042,7 @@ const funcDocs: Record<string, React.ReactNode> = {
<>
<p>
<em>
Both functions only act on native histograms, which are an experimental feature. The behavior of these functions
may change in future versions of Prometheus, including their removal from PromQL.
Both functions only act on native histograms.
</em>
</p>
@ -1071,8 +1069,7 @@ const funcDocs: Record<string, React.ReactNode> = {
<>
<p>
<em>
This function only acts on native histograms, which are an experimental feature. The behavior of this function may
change in future versions of Prometheus, including its removal from PromQL.
This function only acts on native histograms.
</em>
</p>
@ -1121,13 +1118,6 @@ const funcDocs: Record<string, React.ReactNode> = {
explanation of φ-quantiles and the usage of the (classic) histogram metric type in general.)
</p>
<p>
<em>
Note that native histograms are an experimental feature. The behavior of this function when dealing with native
histograms may change in future versions of Prometheus.
</em>
</p>
<p>
The float samples in <code>b</code> are considered the counts of observations in each bucket of one or more classic
histograms. Each float sample must have a label
@ -1260,8 +1250,7 @@ const funcDocs: Record<string, React.ReactNode> = {
<>
<p>
<em>
Both functions only act on native histograms, which are an experimental feature. The behavior of these functions
may change in future versions of Prometheus, including their removal from PromQL.
Both functions only act on native histograms.
</em>
</p>

View File

@ -218,43 +218,43 @@ export const functionIdentifierTerms = [
{
label: 'histogram_avg',
detail: 'function',
info: 'Return the average of observations from a native histogram (experimental feature)',
info: 'Return the average of observations from a native histogram',
type: 'function',
},
{
label: 'histogram_count',
detail: 'function',
info: 'Return the count of observations from a native histogram (experimental feature)',
info: 'Return the count of observations from a native histogram',
type: 'function',
},
{
label: 'histogram_fraction',
detail: 'function',
info: 'Calculate fractions of observations within an interval from a native histogram (experimental feature)',
info: 'Calculate fractions of observations within an interval from a native histogram',
type: 'function',
},
{
label: 'histogram_quantile',
detail: 'function',
info: 'Calculate quantiles from native histograms (experimental) and from conventional histogram buckets',
info: 'Calculate quantiles from native histograms and from conventional histogram buckets',
type: 'function',
},
{
label: 'histogram_sum',
detail: 'function',
info: 'Return the sum of observations from a native histogram (experimental feature)',
info: 'Return the sum of observations from a native histogram',
type: 'function',
},
{
label: 'histogram_stddev',
detail: 'function',
info: 'Estimate the standard deviation of observations from a native histogram (experimental feature)',
info: 'Estimate the standard deviation of observations from a native histogram',
type: 'function',
},
{
label: 'histogram_stdvar',
detail: 'function',
info: 'Estimate the standard variance of observations from a native histogram (experimental feature)',
info: 'Estimate the standard variance of observations from a native histogram',
type: 'function',
},
{