kubeasz/docs/guide/prometheus.md

6.8 KiB
Raw Blame History

Prometheus

随着heapster项目停止更新并慢慢被metrics-server取代,集群监控这项任务也将最终转移。prometheus的监控理念、数据结构设计其实相当精简包括其非常灵活的查询语言但是对于初学者来说想要在k8s集群中实践搭建一套相对可用的部署却比较麻烦由此还产生了不少专门的项目prometheus-operator),本文介绍使用helm chart部署集群的prometheus监控。

  • helm已成为CNCF独立托管项目,预计会更加流行起来

前提

准备

安装目录概览 ll /etc/ansible/manifests/prometheus

drwx------  3 root root  4096 Jun  3 22:42 grafana/
-rw-r-----  1 root root 67875 Jun  4 22:47 grafana-dashboards.yaml
-rw-r-----  1 root root   690 Jun  4 09:34 grafana-settings.yaml
-rw-r-----  1 root root  1105 May 30 16:54 prom-alertrules.yaml
-rw-r-----  1 root root   474 Jun  5 10:04 prom-alertsmanager.yaml
drwx------  3 root root  4096 Jun  2 21:39 prometheus/
-rw-r-----  1 root root   294 May 30 18:09 prom-settings.yaml
  • 目录prometheus/grafana/即官方的helm charts可以使用helm fetch --untar stable/prometheushelm fetch --untar stable/grafana下载本安装不会修改任何官方charts里面的内容这样方便以后跟踪charts版本的更新
  • prom-settings.yaml个性化prometheus安装参数比如禁用PV禁用pushgateway设置nodePort等
  • prom-alertrules.yaml:配置告警规则
  • prom-alertsmanager.yaml:配置告警邮箱设置等
  • grafana-settings.yaml个性化grafana安装参数比如用户名密码datasourcesdashboardProviders等
  • grafana-dashboards.yaml预设置dashboard

安装

$ source ~/.bashrc
$ cd /etc/ansible/manifests/prometheus
# 安装 prometheus chart如果你的helm安装没有启用tls证书请忽略--tls参数
$ helm install --tls \
        --name monitor \
        --namespace monitoring \
        -f prom-settings.yaml \
        -f prom-alertsmanager.yaml \
        -f prom-alertrules.yaml \
        prometheus
# 安装 grafana chart
$ helm install --tls \
	--name grafana \
	--namespace monitoring \
	-f grafana-settings.yaml \
	-f grafana-dashboards.yaml \
	grafana

验证安装

# 查看相关pod和svc
$ kubectl get pod,svc -n monitoring 
NAME                                                     READY     STATUS    RESTARTS   AGE
grafana-54dc76d47d-2mk55                                 1/1       Running   0          1m
monitor-prometheus-alertmanager-6d9d9b5b96-w57bk         2/2       Running   0          2m
monitor-prometheus-kube-state-metrics-69f5d56f49-fh9z7   1/1       Running   0          2m
monitor-prometheus-node-exporter-55bwx                   1/1       Running   0          2m
monitor-prometheus-node-exporter-k8sb2                   1/1       Running   0          2m
monitor-prometheus-node-exporter-kxlr9                   1/1       Running   0          2m
monitor-prometheus-node-exporter-r5dx8                   1/1       Running   0          2m
monitor-prometheus-server-5ccfc77dff-8h9k6               2/2       Running   0          2m

NAME                                    TYPE        CLUSTER-IP     EXTERNAL-IP   PORT(S)        AGE
grafana                                 NodePort    10.68.74.242   <none>        80:39002/TCP   1m
monitor-prometheus-alertmanager         NodePort    10.68.69.105   <none>        80:39001/TCP   2m
monitor-prometheus-kube-state-metrics   ClusterIP   None           <none>        80/TCP         2m
monitor-prometheus-node-exporter        ClusterIP   None           <none>        9100/TCP       2m
monitor-prometheus-server               NodePort    10.68.248.94   <none>        80:39000/TCP   2m
  • 访问prometheus的web界面http://$NodeIP:39000
  • 访问alertmanager的web界面http://$NodeIP:39001
  • 访问grafana的web界面http://$NodeIP:39002 (默认用户密码 admin:admin可在web界面修改)

管理操作

  • 升级(修改配置):修改配置请在prom-settings.yaml prom-alertsmanager.yaml 等文件中进行,保存后执行:
# 修改prometheus
$ helm upgrade --tls monitor -f prom-settings.yaml -f prom-alertsmanager.yaml -f prom-alertrules.yaml prometheus
# 修改grafana
$ helm upgrade --tls grafana -f grafana-settings.yaml -f grafana-dashboards.yaml grafana
  • 回退:具体可以参考helm help rollback文档
$ helm rollback --tls monitor [REVISION]
  • 删除
$ helm del --tls monitor --purge
$ helm del --tls grafana --purge

验证告警

  • 修改prom-alertsmanager.yaml文件中邮件告警为有效的配置内容,并使用 helm upgrade更新安装
  • 手动临时关闭 master 节点的 kubelet 服务,等待几分钟看是否有告警邮件发送
# 在 master 节点运行
$ systemctl stop kubelet

[可选] 配置钉钉告警

  • 创建钉钉群,获取群机器人 webhook 地址

使用钉钉创建群聊以后可以方便设置群机器人,【群设置】-【群机器人】-【添加】-【自定义】-【添加】,然后按提示操作即可,参考 https://open-doc.dingtalk.com/docs/doc.htm?spm=a219a.7629140.0.0.666d4a97eCG7XA&treeId=257&articleId=105735&docType=1

上述配置好群机器人获得这个机器人对应的Webhook地址记录下来后续配置钉钉告警插件要用格式如下

https://oapi.dingtalk.com/robot/send?access_token=xxxxxxxx
# 编辑修改文件中 access_token=xxxxxx 为上一步你获得的机器人认证 token
$ vi /etc/ansible/manifests/prometheus/dingtalk-webhook.yaml
# 运行插件
$ kubectl apply -f /etc/ansible/manifests/prometheus/dingtalk-webhook.yaml
  • 修改 alertsmanager 告警配置后,更新 helm prometheus 部署,成功后如上节测试告警发送
# 修改 alertsmanager 告警配置
$ cd /etc/ansible/manifests/prometheus
$ vi prom-alertsmanager.yaml
# 增加 receiver dingtalk然后在 route 配置使用 receiver: dingtalk
    receivers:
    - name: dingtalk
      webhook_configs:
      - send_resolved: false
        url: http://webhook-dingtalk.monitoring.svc.cluster.local:8060/dingtalk/webhook1/send
# ...
# 更新 helm prometheus 部署
$ helm upgrade --tls monitor -f prom-settings.yaml -f prom-alertsmanager.yaml -f prom-alertrules.yaml prometheus

下一步

  • 继续了解prometheus查询语言和配置文件
  • 继续了解prometheus告警规则编写适合业务应用的告警规则
  • 继续了解grafana的dashboard编写本项目参考了部分feisky的模板
    如果对以上部分有心得总结,欢迎分享贡献在项目中。