## relabeling机制 ## 一、基本介绍 ### 1.1 引子 上个章节中增加consul_exporter的自动发现时，就应用了relabeling机制。主要对自动发现的服务器节点中“带有exporter的tag”进行数据保留，其余的服务器节点进行过滤。  ### 1.2 什么是relabeling? 在Prometheus拉取数据的这个过程中，可能有很多数据是我们不想要的或者需要修改的。Prometheus提供了一个叫relabeling的功能，它能够在抓取到目标实例之前把目标实例的元数据标签动态重新修改，动态添加或者覆盖标签。  prometheus从consul动态发现目标(targets)之后，在被发现的target实例中，都包含一些原 始的Metadata标签信息，默认的标签有如下几种 * address:以以<host>:<port>格式显示日标targets的地址。 * scheme:采集的目标服务地址的Scheme形式，HTTP或者HTTPS。 * metrics_path:采集的目标服务的访问路径。 ### 1.3 relabeling的两个阶段 为了更好的识别监控指标,便于后期调用数据绘图、告警等需求，prometheus支持对发现1的目标进行label修改，在两个阶段可以重新标记: * relabel_configs阶段 在对target进行数据采集之前(比如在采集数据之前重新定义标签信息，如目的IP、目的口等信息)，可以使用relabel_configs添加、修改或删除一些标签、也可以只采集特定目或过滤目标。这种方式也是用的最多的。 * metric_relabel_configs阶段 在对target进行数据采集之后，即如果是已经抓取到指标数据时，可以使用metric relabel configs做最后的重新标记和过滤  ### 1.4 label的类型 source_labels:源标签，没有经过relabel处理之前的标签名字 target_label:通过action处理之后的新的标签名字 regex:给定的值或正则表达式匹配，匹配源标签的值 replacement:通过分组替换后标签(target_label)对应的/(/()1:2，就是引用regex中的分组信息 <hr> <br> ## 二、relabel_configs实际运用介绍 ### 2.1 案例  ### 2.2 action类型讲解 #### &nbsp;&nbsp;&nbsp;2.2.1 replace 将regx正则表达式与连接的 source_labels 进行匹配。然后，将 target_label 设置为replacement，其中replacement 中的匹配组引用(1、(1}、1、{2}等)将被其值替换。如果正则表达式不匹配，则不进行替换。 * 示例  #### &nbsp;&nbsp;&nbsp;2.2.2 keep 删除regex与连接的source_labels不匹配的目标 * 示例  #### &nbsp;&nbsp;&nbsp;2.2.3 drop 删除regex与连接的source_labels匹配的目标 * 示例  #### &nbsp;&nbsp;&nbsp;2.2.4 labelmap 对所有源标签名匹配regex，而不仅仅是source_labels中指定的那些。然后将匹配标签的值复制到标签名称中，替换为匹配组引用(1，(1)，1，(2)，…)，替换为它们的值 * 示例  #### &nbsp;&nbsp;&nbsp;2.2.5 labelkeep 对所有标签名称匹配reg中。任何不匹配的标签都将从标签集中除 * 示例  #### &nbsp;&nbsp;&nbsp;2.2.6 labeldrop 对所有标签名称匹配regex。任何匹配的标签都将从标签集中除 * 示例  #### &nbsp;&nbsp;&nbsp;2.2.7 hashmod 将target_label设置为连接的source_labels的哈希值的模数 * 示例  #### &nbsp;&nbsp;&nbsp;2.2.8 lowercase 将连接的source_labels映射为它们的小写 * 示例  #### &nbsp;&nbsp;&nbsp;2.2.9 uppercase 将连接的source_labels映射为它们的大写 #### &nbsp;&nbsp;&nbsp;2.2.10 keepequal 删除source_labels与target_label不匹配的目标 #### &nbsp;&nbsp;&nbsp;2.2.11 dropequal 删除连接的source_labels与target_label匹配的目标