菜单
文档面包屑箭头 Grafana Mimir面包屑箭头 配置面包屑箭头 原生直方图
开源

配置原生直方图

注意

原生直方图是 Grafana Mimir 的一个实验性功能。

您可以通过 Prometheus 的 远程写入 API 端点（全局或按租户）配置原生直方图摄取。

注意

要启用对原生直方图以及

Grafana Mimir 查询分片 查询原生直方图的支持，请确保在 query frontend 上将标志 -query-frontend.query-result-response-format 设置为其默认值 protobuf。

全局配置原生直方图

要为所有租户启用通过 远程写入 API 端点摄取 Prometheus 原生直方图，请在 ingester 上设置标志 -ingester.native-histograms-ingestion-enabled=true。

要限制每个样本的原生直方图桶数量，请在 distributor 上设置标志 -validation.max-native-histogram-buckets。推荐值为 160，这是 OpenTelemetry SDK 指数直方图中的默认值。OpenTelemetry 中的指数直方图与 Prometheus 原生直方图概念类似。在摄取时，超出限制的样本桶将被缩小，这意味着分辨率会降低，并且桶会被合并，直到桶数量低于限制或达到最小分辨率。通过将 -validation.reduce-native-histogram-over-max-buckets 选项设置为 false，可以将行为更改为丢弃此类样本。

按租户配置原生直方图

要为租户启用通过 远程写入 API 摄取 Prometheus 原生直方图，请将 runtime 值 native_histograms_ingestion_enabled 设置为 true。

要限制租户的每个样本的原生直方图桶数量，请设置 runtime 值 max_native_histogram_buckets。推荐值为 160，这是 OpenTelemetry SDK 指数直方图中的默认值。OpenTelemetry 中的指数直方图与 Prometheus 原生直方图概念类似。在摄取时，超出限制的样本桶将被缩小，这意味着分辨率会降低，并且桶会被合并，直到桶数量低于限制或达到最小分辨率。通过将 -validation.reduce-native-histogram-over-max-buckets 选项设置为 false，可以将行为更改为丢弃此类样本。

yaml 
overrides:
  tenant1:
    native_histograms_ingestion_enabled: true
    max_native_histogram_buckets: 160

要了解更多关于通过 Grafana Alloy 或 Prometheus 将原生直方图发送到 Mimir 或 Grafana Cloud Metrics 的信息，请参阅将原生直方图发送到 Mimir。