这是原厂英文文档的翻译页面. 欢迎帮助我们 完善文档.

Sidebar

Zabbix Summit 2022
Register for Zabbix Summit 2022

17 Prometheus 数据处理

概述

Zabbix 可以采集符合 Prometheus行协议格式的监控数据。

采集数据需要配置以下两步:

  • 创建一个作为主要监控项的HTTP监控项 指向合适的站点批量采集数据。例如:https://<prometheus host>/metrics
  • 配置使用Prometheus 预处理选项的从属监控项,来从主要监控项中获取需要的数据

Zabbix 有两个Prometheus 预处理选项:

  • Prometheus正则匹配 - 可以应用于一般监控项中,用来从查询Prometheus行协议中提取数据
  • Prometheus转JSON - 可以应用于一般监控项或低级别自动发现监控项。使用这个预处理步骤,将会将采集到的Prometheus 数据转化为JSON格式返回给监控项
批量处理

从属监控项支持批量处理。为了启用缓存和索引,是 Prometheus 正则匹配 步骤必须是预处理配置的第一个步骤。当 Prometheus 正则匹配是预处理的第一步时,经过这个预处理步骤配置的第一组 <label>==<value> 条件解析后的Prometheus数据会被缓存并建立索引。这个缓存可以在其他从属监控项的其他后续预处理过程中得到重用。为了更好的优化性能,第一个作为条件的label,应当匹配尽可能多的不同值。

如果有额外的预处理步骤需要在第一步之前执行,正确做法是将该步骤放在主要监控项或者新建一个从属监控项,并将这个监控项作为处理Prometheus数据处理监控项的主监控项。

配置

已经事先正确配置了 HTTP代理类型的主要监控项,你需要创建一个 从属监控项 来应用Prometheus 预处理步骤:

  • 在配置表单中填入一般从属监控项的参数
  • 前往预处理选项卡
  • 选择一个 Prometheus 预处理选项(Prometheus正则匹配 or Prometheus转JSON

参数 描述 示例
Pattern 要定义所需数据的正则匹配规则,可以使用与PromQL(Prometheus 查询语言)十分类似的检索语言 (详见 [对比表]](#query_language_comparison)), 举个例子:
<metric name> - 指定指标名称
{__name__=~"<regex>"} - 根据正则表达式,匹配指标名称
{<label name>="<label value>",...} - 指定标签名称
{<label name>=~"<regex>",...} - 根据正则表达式,匹配标签名称
{__name__=~".*"}==<value> - 指定指标值
或者将以上的条件任意组合:
<metric name>{<label1 name>="<label1 value>",<label2 name>=~"<regex>",...}==<value>

标签名称可以是任何UTF-8字符的序列,但对于反斜杠、双引号和换行符必须使用转义,就像 \\\"\n;其他字符不应被转义。
wmi_os_physical_memory_free_bytes
cpu_usage_system{cpu="cpu-total"}
cpu_usage_system{cpu=~".*"}
cpu_usage_system{cpu="cpu-total",host=~".*"}
wmi_service_state{name="dhcp"}==1
wmi_os_timezone{timezone=~".*"}==1
Result processing 定义如何返回处理结果,提供了标签 或应用适当的函数(如正则匹配的到了多行结果,需要对这些结果进行简单聚合):
- 返回指标的值(当匹配到多行记录时,会引发错误)
标签 - 在Label字段中指定的标签返回值(当匹配到多个指标时,会引发错误)
总和 - 返回值的总和
最小值 - 返回最小值
max - 返回最大值
平均值 - 返回平均值
计数 - 返回值的计数
此参数字段仅适用于Prometheus正则匹配预处理步骤。
实际用例见表后。
Output 定义标签名称(可选)。如果这里填了什么,那这个预处理步骤将返回与格子里内容匹配的标签名称
此参数字段仅适用于Prometheus正则匹配预处理步骤。

Prometheus转JSON

来自Prometheus 的数据可以被低级别自动发现使用。要这样使用数据,必须要转化为JSON格式。Zabbix提供了Prometheus转JSON作为预处理步骤的选项,这可以直接按照格式要求返回数据。

详情参见在低级别自动发现中,使用Prometheus数据

查询语言对照表

下表列出了PromQL与Zabbix Prometheus 预处理查询语言之间的异同。

PromQL瞬时向量选择器 Zabbix Prometheus预处理
不同点
查询目标 Prometheus服务器 Prometheus行协议中的纯文本
返回值 瞬时向量 指标或标签的值(Prometheus正则匹配)
JSON格式的包含单个值的指标构成的数组(Prometheus转JSON)
标签匹配操作符 =, !=, =~, !~ =, !=, =~, !~
在匹配标签或指标名称的正则表达式 RE2 PCRE
比较操作符 详见清单 只有 == (相等)用于支持值过滤
相似点
依据指标名相同的字符串筛选 <metric name> or {__name__="<metric name>"} <metric name> or {__name__="<metric name>"}
依据匹配正则表达式的指标名筛选 {__name__=~"<regex>"} {__name__=~"<regex>"}
依据相同字符串的标签名称 值筛选 {<label name>="<label value>",...} {<label name>="<label value>",...}
依据匹配正则表达式的标签名称 值筛选 {<label name>=~"<regex>",...} {<label name>=~"<regex>",...}
根据相同的字符串的值筛选 {__name__=~".*"} == <value> {__name__=~".*"} == <value>