当您在集群中开启观测并安装 prometheus-agent 组件后，允许通过 PodMonitor 来满足自定义采集规则的需求。本文为您介绍如何通过 PodMonitor 来配置服务发现。

验证 Demo

您可以使用以下 Demo，体验基于 golang 的应用接入和 PodMonitor 服务发现过程。下面的示例中，使用 golang 语言创建了一个应用，并在应用中暴露了一个名为rpc_durations_seconds的指标，用于对服务的 RPC 延迟进行统计。

package main​
​
import (​
        "math"​
        "math/rand"​
        "net/http"​
        "time"​
​
        "github.com/prometheus/client_golang/prometheus"​
        "github.com/prometheus/client_golang/prometheus/collectors"​
        "github.com/prometheus/client_golang/prometheus/promhttp"​
)​
​
var rpcDurations = prometheus.NewSummaryVec(​
        prometheus.SummaryOpts{​
                Name:       "rpc_durations_seconds",​
                Help:       "RPC latency distributions.",​
                Objectives: map[float64]float64{0.5: 0.05, 0.9: 0.01, 0.99: 0.001},​
        },​
        []string{"service"},​
)​
​
func main() {​
        // Create a new registry.​
        reg := prometheus.NewRegistry()​
​
        // Add Go module build info.​
        reg.MustRegister(collectors.NewBuildInfoCollector())​
        // Add go runtime metrics and process collectors.​
        reg.MustRegister(​
                collectors.NewGoCollector(),​
                collectors.NewProcessCollector(collectors.ProcessCollectorOpts{}),​
        )​
​
        reg.MustRegister(rpcDurations)​
​
        start := time.Now()​
​
        oscillationFactor := func() float64 {​
                return 2 + math.Sin(math.Sin(2*math.Pi*float64(time.Since(start))/float64(10*time.Minute)))​
        }​
​
        // Periodically record some sample latencies for the three services.​
        go func() {​
                for {​
                        v := rand.Float64() * 0.0002​
                        rpcDurations.WithLabelValues("uniform").Observe(v)​
                        time.Sleep(time.Duration(100*oscillationFactor()) * time.Millisecond)​
                }​
        }()​
​
        go func() {​
                for {​
                        v := (rand.NormFloat64() * 0.0002) + 0.00001​
                        rpcDurations.WithLabelValues("normal").Observe(v)​
                        time.Sleep(time.Duration(75*oscillationFactor()) * time.Millisecond)​
                }​
        }()​
​
        go func() {​
                for {​
                        v := rand.ExpFloat64() / 1e6​
                        rpcDurations.WithLabelValues("exponential").Observe(v)​
                        time.Sleep(time.Duration(50*oscillationFactor()) * time.Millisecond)​
                }​
        }()​
​
        http.Handle("/metrics", promhttp.HandlerFor(​
                reg, promhttp.HandlerOpts{},​
        ))​
        http.ListenAndServe(":2023", nil)​
}​

前提条件

已开启云原生观测，详情请参见开启观测。

已将 Demo 代码打包成镜像，并上传至镜像仓库。详情请参见 Golang 应用接入。

已通过 kubectl 连接目标集群。具体操作说明，请参见连接集群。

配置步骤

步骤一：部署应用

您可以使用镜像仓库中的镜像，在容器服务 VKE 集群中部署应用。步骤如下：

登录容器服务控制台。

在左侧导航栏中选择集群，单击集群名称，进入集群配置页面。

在左侧导航栏中选择工作负载 > 无状态负载。单击使用 Yaml 创建，部署应用。

apiVersion: apps/v1
kind: Deployment
metadata:
name: golang-demo # 配置应用的名称
namespace: volcano-metrics # 配置应用所在的命名空间
labels:
app: golang-demo # 配置应用的标签
spec:
replicas: 2 # 配置应用副本数
selector:
matchLabels:
app: golang-demo
template:
metadata:
labels:
app: golang-demo
spec:
containers:
- name: golang-demo # 配置容器名称
image: doc-cn-beijing.cr.volces.com/vmp/golang-demo:1.0 # 配置应用镜像的地址和版本
ports:
- name: metric-port # 配置容器端口名称
containerPort: 2023 # 配置容器端口

步骤二：配置 PodMonitor

在左侧导航栏中选择工作负载 > 对象浏览器。单击使用 Yaml 创建，配置 PodMonitor。

在类型下拉菜单中选择自定义。

在 Yaml 配置框内输入 Yaml 配置。

单击确定，完成配置。

结果验证

登录 VMP 服务控制台。

在顶部导航栏，选择目标地域。

单击左侧导航栏的 Explore，进入 Explore 页面。

在右上角的配置项中，配置需要查询指标的工作区，并在指标检索文本框内，输入 up{job="volcano-metrics/golang-demo-discover"}，查看对应的 Pod 是否被正确发现。

高级配置

自定义 job 名称

默认情况下，通过 PodMonitor 发现的 job 名称为 PodMonitor 的 <namespace>/<name>，例如在本文中，job 的默认名称为volcano-metrics/golang-demo-discover。您可以根据需要，自定义 job 的名称。

方法一

您可以在 PodMonitor 中使用jobLabel字段，将 job 名称修改为指定的 Pod 标签值。例如在本例中，可以将 job 名称修改为标签app: golang-demo的值，即 job 名称为golang-demo。

预期结果如下所示，可以使用 job 名称golang-demo查询到指标。

方法二

您可以在 PodMonitor 中使用spec.podMetricsEndpoints.N.relabelings字段，配置 Relabel 能力，自定义 job 的名称。

预期结果如下所示，可以使用 job 名称jobname-demo查询到指标。

在指标中增加 PodLabel

默认情况下，Pod 的 Label 不会加到指标中。您可以在 PodMonitor 中使用spec.podTargetLabels字段，将 Pod 的 Label 加入到指标中。

预期结果如下所示：

指标 Relabel

您可以通过指标 Relabel，在抓取指标或推送指标到托管 Prometheus 工作区之前，添加、修改或删除指标标签。支持 2 种配置方式，包括：

使用relabelings：

需要在抓取目标之前修改或过滤目标标签。

需要在服务发现过程中修改或过滤目标标签。

使用metricRelabelings：

需要在抓取数据之后修改或过滤指标标签。

需要在数据已经抓取之后删除特定的指标。

典型场景包括删除不需要的指标、重命名指标标签、添加新的指标标签等。

增加全局 Label

如果您希望在采集到的指标都增加指定的 Label，可以通过配置spec.podMetricsEndpoints.N.relabelings参数实现。例如通过以下配置，可以在采集到的所有指标上增加label: value标签对。

保留指定指标

如果您希望仅写入某些指定的指标，可以通过配置action: keep来实现。例如通过以下配置，仅保留指标名满足正则表达式vmagent_remotewrite.*的指标。

删除指标

如果您希望不写入某些指标，可以通过配置action: drop来将某些指标丢弃掉。例如通过以下配置，可以将vmagent_daily_series_limit_rows_dropped_total指标丢弃。

修改 Label 的值

如果您希望修改某个 Label 的值，可以通过配置action: replace来实现。例如通过以下配置，可以将以/api/v1开头的 path label 值去掉/api/v1前缀，即由path: /api/v1/targets修改为path: /targets。