环境部署
通过命令行进行Prometheus和所有exporter的快捷部署,第一次安装需要确保有网络连接,输入参数为–online。
成功进行一次在线部署之后可以设参数为–offline进行离线部署。
如采用一键式部署,Prometheus和node_exporter的软件压缩包下载路径以及解压缩路径在用户的家目录$HOME下。
部署过程中为支持部署位置正确以及后续的运行和监测正常运行,程序会要求用户互动性地输入一些参数,主要包括以下内容,**应当注意到的是Prometheus和node-exporter的默认侦听地址是0.0.0.0,由于Prometheus和node-exporter属于开源软件,DBMind也无法获知用户希望绑定的IP地址,故无法直接进行修改,需要用户进行配置。**但是在安装过程中,DBMind会给予用户相应的提示,提示用户将侦听地址绑定到具体的某个IP地址上。下面是部署工具的配置文件示例,该工具会进行交互式配置,不建议用户手动修改。配置文件如下:
prometheus和reprocessing_exporter一起部署在主控设备上,设备数量为1,关于这一设备的参数被归类为[PROMETHEUS]。
node_exporter和opengauss_exporter一起部署在数据库所在设备上,可能存在多个设备,关于这些设备的参数被归类为[EXPORTERS]。这些数据库节点的账户和密码,数据库的账户和密码必须一致,部署的路径和SSL证书所在的路径也需要一致。
[EXPORTERS]的Targets选项是监控的数据库实例对象,格式为ip:port/dbname,多个数据库实例之间用逗号(,)分隔。目前该项中ip一项对地址进行了强校验,暂不支持输入域名的方式。
对于SSL证书的管理方式,Prometheus不支持包含密码的私钥文件,所以一键部署功能在Prometheus上不支持包含密码的私钥文件。
用户需要提前把[PROMETHEUS]和[EXPORTERS]需要的证书文件放置在各节点一致的路径下,如果是多节点部署,不同节点之间的证书文件路径必须一致。如果路径出现不正确的情况下,当各个组件运行时没有检测到证书文件时,会进行报警并退出运行。
用户可以通过–help获取帮助信息
gs_dbmind component deployment --help
当使用参数-c –conf时, 将指定读取的配置文件位置, CONF中的{CONFIG_PATH}根据实际安装路径进行变化。
通过自动部署过程之后会自动根据配置过程中用户输入的参数自动生成prometheus.yaml配置文件,在启动Prometheus时会自动加载该配置文件,示例内容如下:
alerting:
alertmanagers:
- static_configs:
- targets: null
global:
evaluation_interval: 15s
rule_files: null
scrape_configs:
scrape_interval: 5s
static_configs:
- targets:
- 10.90.56.175:9090
- job_name: reprocessing_exporter
static_configs:
- targets:
- 10.90.56.175:8181
tls_config:
ca_file:xxx.ca
key_file:xxx.key
cert_file:xxx.crt
- job_name: cmd_exporter
scheme: https
static_configs:
- targets:
- 10.90.56.172:9187
- 10.90.56.172:9188
ca_file:xxx.ca
cert_file:xxx.crt
- job_name: node_exporter
scheme: https
static_configs:
- targets:
- 10.90.56.172:9100
- job_name: opengauss_exporter
scheme: https
static_configs:
- targets:
- 10.90.56.172:9187
- 10.90.56.172:9188
tls_config:
ca_file:xxx.ca
cert_file:xxx.crt
部署完成之后,程序被相应分发到所有的目标位置,可以开始自动式运行,具体方法见下一节使用指导。
其中,提供的exporter组件默认采用Https通信协议,因此需要用户默认提供SSL证书和秘钥文件,并通过–ssl-keyfile、–ssl-certfile 以及 –ssl-ca-file 提供。若用户不希望使用Https协议,则可以通过–disable-https 选项禁用该模式。