跳转至

ProcStat

视图预览

ProcStat 指标展示，包括进程返回码、进程数、返回状态等

image

版本支持

操作系统支持：Linux / Windows

前置条件

安装 Telegraf

以 CentOS 为例，其他系统参考 [Telegraf 官方文档]

1、 添加 yum 源

cat <<EOF | tee /etc/yum.repos.d/influxdb.repo
[influxdb]
name = InfluxDB Repository - RHEL \$releasever
baseurl = https://repos.influxdata.com/rhel/\$releasever/\$basearch/stable
enabled = 1
gpgcheck = 1
gpgkey = https://repos.influxdata.com/influxdb.key
EOF

2、 安装 telegraf

yum -y install telegraf

安装配置

说明：示例 Linux 版本为：CentOS Linux release 7.8.2003 (Core)

部署实施

指标采集 (必选)

1、 数据上传至 DataKit，修改主配置文件 telegraf.conf

vi /etc/telegraf/telegraf.conf

2、 关闭 influxdb，开启 outputs.http (修改对应的行)

#[[outputs.influxdb]]
[[outputs.http]]
url = "http://127.0.0.1:9529/v1/write/metric?input=telegraf"

3、 关闭主机检测 (否则会与 DataKit 冲突)

#[[inputs.cpu]]
#  percpu = true
#  totalcpu = true
#  collect_cpu_time = false
#  report_active = false
#[[inputs.disk]]
#  ignore_fs = ["tmpfs", "devtmpfs", "devfs", "iso9660", "overlay", "aufs", "squashfs"]
#[[inputs.diskio]]
#[[inputs.mem]]
#[[inputs.processes]]
#[[inputs.swap]]
#[[inputs.system]]

4、 开启 ProcStat 检测

主要参数说明

  • pid_file：pid 文件路径
  • exe：进程名匹配 (等同于 pgrep 命令)
  • pattern：进程名匹配 (等同于 pgrep -f 命令)
  • cmdline_tag：是否开启 cmdline (默认 false) 
    [[inputs.procstat]]
    # pid_file/exe/pattern 三选一
    pattern = "zookeeper"
    # cmdline_tag = false
[[inputs.procstat]]
    pattern = "httpd"

5、 启动 Telegraf

systemctl start telegraf

6、 指标验证

/usr/bin/telegraf --config /etc/telegraf/telegraf.conf --input-filter procstat --test

有数据返回 (行协议)，代表能够正常采集

image

7、 指标预览

image

插件标签 (非必选)

参数说明

  • 该配置为自定义标签，可以填写任意 key-value 值
  • 以下示例配置完成后，所有 ProcStat 指标都会带有 app = oa 的标签，可以进行快速查询
  • 相关文档 <TAG在观测云中的最佳实践>
# 示例
[inputs.procstat.tags]
   app = "oa"

重启 Telegraf

systemctl restart telegraf

场景视图

<场景 - 新建仪表板 - 模板库 - 系统视图 - Procstat 监控视图>

检测库

<监控 - 监控器 - 从模板新建 - Procstat 检测库>

指标详解

主要指标

指标 描述 数据类型
pid_count pid 文件数 int
running 进程数 int
result_code 返回码 (0=success,1=error) int

常见问题排查

<无数据上报排查>

进一步阅读

<主机可观测最佳实践>