prometheus学习笔记(1)-mac单机版环境搭建

注：以下所有环境均为mac笔记本

一、安装prometheus

brew install prometheus

安装完后，默认的安装路径为：

/usr/local/Cellar/prometheus/2.16.0/

同时还会生成一个默认配置文件：/usr/local/etc/prometheus.yml

global:
  scrape_interval: 15s

scrape_configs:
  - job_name: "prometheus"
    static_configs:
    - targets: ["localhost:9090"]

 进入安装路径后，输入以下命令：

./prometheus --config.file=/usr/local/etc/prometheus.yml

顺利的话，应该能正常启动，然后浏览器输入 http://localhost:9090

菜单切换到status，还能看到一些关键参数，比如数据默认保存天数：(默认15天)

 

二、安装grafana

要展示各种漂亮的图表，就得借助grafana，仍用brew安装

brew install grafana

默认安装路径：

/usr/local/Cellar/grafana/6.7.0

启动：

grafana-server --config=/usr/local/etc/grafana/grafana.ini --homepath /usr/local/share/grafana --packaging=brew cfg:default.paths.logs=/usr/local/var/log/grafana cfg:default.paths.data=/usr/local/var/lib/grafana cfg:default.paths.plugins=/usr/local/var/lib/grafana/plugins

启动完成后，浏览http://localhost:3000/进入首页(注：如需修改默认端口，可修改/usr/local/etc/grafana/grafana.ini 这个文件)，默认用户名/密码，都是admin，使用前必须更改密码

grafana只是一个图表展示工具，必须添加数据源，才能读取到数据，参考下图：

选择prometheus数据源，指定URL地址，然后保存即可

 

三、安装pushgateway

从官网https://prometheus.io/download/ 下载pushgateway-1.2.0.darwin-amd64.tar.gz

解压到本地运行

./pushgateway

启动正常的话，浏览http://localhost:9091 可以看到

 为什么要安装这个玩意儿，看下面的示意图(从网上淘的）：

 

客户端(不管是写代码，还是直接终端敲命令行)把数据push到网关(pushgateway)，然后prometheus从网关pull数据。

安装好之后，还要修改/usr/local/etc/prometheus.yml 不然prometheus感知不到网关的存在

global:
  scrape_interval: 15s

scrape_configs:
  - job_name: "prometheus"
    static_configs:
    - targets: ["localhost:9090"]
  # 加入下面这几行  
  - job_name: "push-metrics"
    static_configs:
    - targets: ["localhost:9091"]
    honor_labels: true

加入最后这几行即可，改完后最好把prometheus重启一下，以便让配置文件生效。　

接下来测试数据写入：先准备1个文件data.txt

blog_visit_total{blogid="12345",domain="yjmyzz.cnblogs.com",clientip="10.0.1.1"} 20
blog_visit_total{blogid="34567",domain="yjmyzz.cnblogs.com",clientip="10.0.1.2"} 30
blog_visit_total{blogid="56789",domain="yjmyzz.cnblogs.com",clientip="10.0.1.3"} 40

解释一下，blog_visit_total相当于指标名称，{ }里面的东西，相当于tag，可以根据tag在查询时过滤，最后的20、30、40相当于具体的指标值。

命令行下，输入：

curl -XPOST --data-binary @/Users/jimmy/Downloads/data.txt http://localhost:9091/metrics/job/cnblogs

就把这3行数据push到网关了，注意下格式：http://localhost:9091/metrics/job/cnblogs 红色的部分，这是job名称，大家可以根据需要自己修改。

此时再到http://localhost:9091查看一下，应该能看到刚push的数据:

感兴趣的同学，还可以看下http://localhost:9090 ，这时候prometheus里也能感知刚添加的数据 

prometheus底层存储是一个时序数据库，上面的curl命令，可以多跑几次，相当于持续在向时序数据库时添加记录，后面会用到。

 

四、配置grafana

到目前为止，grafana好象一直在打酱油，没派上用场，该它发挥点作用了。

4.1 新建dashboard

参考上图，新建1个dashboard，然后随便起个名字（上图中我已经创建了一个名为“菩提树下的杨过”的dashboard），命名的地方，在settings里(如下)

4.2 添加图表 

接下来，添加一个查询(Add Query)

参考下图，将刚才的指标blog_visit_total添加进来(还可以用sum/max/min/avg这类聚合函数处理)

 图表名称可以参考下图设置：

最后保存，这样一个基本的prometheus监控系统(单机环境)就搭建完成了。

 

参考文章：

https://prometheus.io/docs/practices/pushing/

https://prometheus.io/download/

https://prometheus.io/docs/introduction/overview/

https://www.liuyixiang.com/post/96100.html

https://blog.csdn.net/Holly_walker/article/details/103820509