Prometheus logo

Prometheus

文档下载社区支持与培训博客

Ctrl + K

GitHub Logo

抓取协议内容协商

摘要

本文档详细说明了 Prometheus 在从目标抓取指标时使用的协议协商机制。它定义了 Accept 头格式、支持的内容类型，以及用于确定指标暴露最佳可用格式的协商过程。

简介

Prometheus 支持多种指标抓取格式，包括文本格式和二进制 protobuf 格式。目标将根据 Accept 头的值选择最佳可用内容类型进行响应。

协议类型

支持的协议

Prometheus 支持以下协议

  1. PrometheusProto - 二进制 protobuf 格式
  2. PrometheusText0.0.4 - Prometheus 文本格式 0.0.4 版本
  3. PrometheusText1.0.0 - Prometheus 文本格式 1.0.0 版本
  4. OpenMetricsText0.0.1 - OpenMetrics 文本格式 0.0.1 版本
  5. OpenMetricsText1.0.0 - OpenMetrics 文本格式 1.0.0 版本

协议头

每个协议都**必须**关联特定的 MIME 类型和版本

协议MIME 类型参数
PrometheusProtoapplication/vnd.google.protobufproto=io.prometheus.client.MetricFamily;encoding=delimited
PrometheusText0.0.4text/plainversion=0.0.4
PrometheusText1.0.0text/plainversion=1.0.0
OpenMetricsText0.0.1application/openmetrics-textversion=0.0.1
OpenMetricsText1.0.0application/openmetrics-textversion=1.0.0

Accept 头构造

Prometheus 构造 Accept 头以指示其支持的格式。

基本格式

Accept 头**必须**按以下方式构造

  1. 对于目标支持的每个协议
    • **必须**指定协议的 MIME 类型和参数。
    • 对于 protobuf 协议，**必须**指定“delimited”编码。
    • 对于 PrometheusText1.0.0 和 OpenMetricsText1.0.0，**应**附加转义方案参数。
    • **应**附加质量值 (q) 参数。
  2. **应**附加一个具有最低质量值的通用 */*。

质量值

质量值**应**根据协议在 Accept 头中的位置按降序分配

  • 第一个协议：q=0.{n+1}
  • 第二个协议：q=0.{n}
  • 以此类推，其中 n 是支持的协议数量

转义方案

对于 PrometheusText1.0.0 和 OpenMetricsText1.0.0 协议，Accept 头**应**包含一个转义方案参数：escaping=<scheme>

其中 <scheme> **必须**是以下之一

  • allow-utf8
  • underscores
  • dots
  • values

有关转义方案如何运作的详细信息，请参阅转义方案规范。

压缩

Accept-Encoding 头**应**设置为

  • 如果启用压缩，则为gzip
  • 如果禁用压缩，则为identity

格式选择

抓取目标**应**使用以下过程，根据 Prometheus 生成的 Accept 头中的协议列表选择合适的内容类型

  1. 它**必须**使用 Accept 头中权重最高且 Prometheus 支持的协议。
  2. 如果没有支持的协议，目标**可以**使用用户配置的回退抓取协议。
  3. 如果未指定回退，目标**必须**最终使用 PrometheusText0.0.4。

Content-Type 响应

目标**应**使用与所接受格式之一匹配的 Content-Type 头进行响应。Content-Type 头**必须**包含

  1. 相应的 MIME 类型。
  2. 版本参数。
  3. 对于 1.0.0 及以上版本的文本格式，包含转义方案参数。

安全考量

  1. 目标**必须**验证 Accept 头以防止潜在的注入攻击
  2. **必须**验证转义方案参数以防止协议混淆
  3. Content-Type 头**必须**进行适当的清理以防止 MIME 类型混淆

示例

默认 Accept 头

Accept: application/openmetrics-text;version=1.0.0;escaping=allow-utf8;q=0.5,application/openmetrics-text;version=0.0.1;q=0.4,text/plain;version=1.0.0;escaping=allow-utf8;q=0.3,text/plain;version=0.0.4;q=0.2,/;q=0.1

Protobuf 优先的 Accept 头

Accept: application/vnd.google.protobuf;proto=io.prometheus.client.MetricFamily;encoding=delimited;q=0.5,application/
openmetrics-text;version=1.0.0;escaping=allow-utf8;q=0.4,application/openmetrics-text;version=0.0.1;q=0.3,text/plain;version=1.0.0;escaping=allow-utf8;q=0.2,text/plain;version=0.0.4;q=0.1,/;q=0.0

本页内容