监控系统参数

Pigsty中与监控系统有关的参数

Pigsty的监控系统包含三个组件:

  • Node Exporter
  • PG Exporter
  • Pgbouncer Exporter

此外,Haproxy将直接通过管理端口对外暴露监控指标。

所有监控Exporter都会被注册至Consul,Prometheus会通过服务发现的方式管理这些任务。

参数概览

#------------------------------------------------------------------------------
# MONITOR PROVISION
#------------------------------------------------------------------------------
exporter_metrics_path
exporter_binary_install
node_exporter_enabled
node_exporter_port
pg_exporter_config
pg_exporter_enabled
pgbouncer_exporter_enabled
pg_exporter_port
pgbouncer_exporter_port

默认参数

#------------------------------------------------------------------------------
# MONITOR PROVISION
#------------------------------------------------------------------------------
# - common - #
exporter_metrics_path: /metrics               # default metric path for pg related exporter
exporter_binary_install: false                # install exporter via copy local binary (from files/{pg,node}_exporter)

# - node exporter - #
node_exporter_enabled: true                   # setup node_exporter on instance
node_exporter_port: 9100                      # default port for node exporter

# - pg/pgb exporter - #
pg_exporter_config: pg_exporter-demo.yaml     # default config files for pg_exporter
pg_exporter_enabled: true                     # setup pg_exporter on instance
pgbouncer_exporter_enabled: true              # setup pgbouncer_exporter on instance
pg_exporter_port: 9630                        # default port for pg exporter
pgbouncer_exporter_port: 9631                 # default port for pgbouncer exporter

参数详解

exporter_metrics_path

所有Exporter对外暴露指标的URL PATH,默认为/metrics

该变量被外部角色prometheus引用,Prometheus会根据这里的配置,针对job = pg的监控对象应用此配置。

exporter_binary_install

是否采用复制二进制文件的方式安装Node Exporter与PG Exporter,默认为false

该选项主要用于集成外部管控方案时,减少对原有系统的假设。启用该选项将直接将Linux二进制文件复制至目标机器。

<meta>:<pigsty>/files/node_exporter ->  <target>:/usr/bin/node_exporter
<meta>:<pigsty>/files/pg_exporter   ->  <target>:/usr/bin/pg_exporter

您需要通过files/download-exporter.sh从Github下载Linux二进制程序至files目录,方可启用该选项。

node_exporter_enabled

是否安装并配置node_exporter,默认为true

node_exporter_port

node_exporter监听的端口

默认端口9100

pg_exporter_config

pg_exporter使用的默认配置文件,定义了Pigsty中的指标。

Pigsty默认提供了两个配置文件:

  • pg_exporter-demo.yaml 用于沙箱演示环境,缓存TTL更低(1s),监控实时性更好。

  • pg_exporter.yaml,用于生产环境,有着正常的缓存TTL(10s),显著降低多个Prometheus同时抓取的负载。

如果您采用了不同的Prometheus架构,建议对pg_exporter的配置文件进行检查与调整。

pg_exporter_enabled

是否安装并配置pg_exporter,默认为true

pgbouncer_exporter_enabled

是否安装并配置pgbouncer_exporter,默认为true

pg_exporter_port

pg_exporter监听的端口

默认端口9630

pgbouncer_exporter_port

pgbouncer_exporter监听的端口

默认端口9631

最后修改 2021-02-20: update config doc to v0.6 (835a0cf)