Prometheus监控之process-exporter

Posted 2022-12-23

一、简介

有些应用程序无法直接检测，要么是因为您无法控制代码，要么是因为它们是用一种不容易用 Prometheus 检测的语言编写的。我们必须转而求助于挖掘 /proc。

二、安装配置

1、下载
https://github.com/ncabatoff/process-exporter/releases

2、常用命令参数
Usage of process-exporter:
  -children
        if a proc is tracked, track with it any children that arent part of their own group (default true)
  -config.path string
        path to YAML config file
  -debug
        log debugging information to stdout
  -man
        print manual
  -namemapping string
        comma-separated list, alternating process name and capturing regex to apply to cmdline
  -once-to-stdout-delay duration
        Dont bind, just wait this much time, print the metrics once to stdout, and exit
  -procfs string
        path to read proc data from (default "/proc")
  -procnames string
        comma-separated list of process names to monitor
  -recheck
        recheck process names on each scrape
  -threads
        report on per-threadname metrics as well (default true)
  -version
        print version information and exit
  -web.listen-address string
        Address on which to expose metrics and web interface. (default ":9256")
  -web.telemetry-path string
        Path under which to expose metrics. (default "/metrics")
  -web.config.file web-config.yml #意味着可以使用TLS
        
3、配置模板
process_names:
  - matcher1
  - matcher2
  ...
  - matcherN
  
监控所有的服务进程
 process_names:
  - name: ".Comm"
    cmdline:
    - .+
通过ps -ef 查询到目标进程后，执行more /proc/端口号/cmdline查看cmdline内容，然后挑选必要信息填写到config.yaml中。
如果该进程不存在，则不会有该进程的数据采集到。
如果监控java，输入jar包名即可，最好是唯一

配置模板选项如下：
.Comm 包含原始可执行文件的basename，/proc//stat 中的换句话说，2nd 字段
.ExeBase 包含可执行文件的basename
.ExeFull 包含可执行文件的完全限定路径
.Username 包含有效用户的用户名
.Matches 映射包含应用命令行tlb所产生的所有匹配项
process_names中的每个项目都必须包含一个或多个选择器(comm，exe或cmdline), 如果存在多个选择器，则它们必须全部匹配。 每个选择器都是
一个字符串列表，用于与进程的comm，argv [0]匹配；对于cmdline，则是一个适用于命令行的正则表达式。 cmdline regexp使用Go语法。
对于comm和exe，字符串列表是一个OR，这意味着与任何字符串匹配的任何进程都将添加到该项目的组中。
对于cmdline，正则表达式列表为AND，表示它们都必须匹配。 正则表达式中的任何捕获组都必须使用？P <name>选项为捕获分配一个名称，该名称用于填充.Matches。

例如：> ps -ef | grep redis  
redis 771 1 0 Jun05 ? 00:45:49 /usr/bin/redis-server *:6379
.Comm       groupname="redis-server"                   exe或者sh文件名称
.ExeBase    groupname="redis-server *:6379"            /
.ExeFull    groupname="/usr/bin/redis-server *:6379"   ps中的进程完成信息
.Username   groupname="redis"                          使用进程所属的用户进行分组
.Matches    groupname="map[:redis]"                    表示配置到关键字“redis”

三、示例

1、解压
tar -zxvf  process-exporter-0.5.0.linux-amd64.tar.gz

2、创建配置文件process-conf.yaml
touch process-conf.yaml
并编写配置信息：(如监控进程名为test程序)
process_names:
  - name: ".Matches"
    cmdline:
    - test
    
3、后台启动：并指定配置文件process-conf.yaml
nohup ./process-exporter -config.path process-conf.yaml > process-exporter.stdout 2>&1 &
process-exporter默认会监听9256端口

4、Prometheus配置文件中添加，并重启
- job_name: process
    static_configs:
    - targets: [localhost:9256]
curl  localhost:9256/metrics |grep test
可以看到test进程相关监控的指标

5、Grafana图表显示：
process-exporter对应的dashboard为：https://grafana.com/grafana/dashboards/249