通过在ZooKeeper中埋点来暴露数据,使用阿里云Prometheus监控抓取数据,借助Prometheus Grafana大盘来展示数据,并创建报警,即可实现通过Prometheus监控ZooKeeper的目的。

前提条件

容器服务K8s集群已接入阿里云Prometheus监控。如何接入,请参见开始使用Prometheus监控

操作流程

通过阿里云Prometheus监控ZooKeeper的操作流程如下图所示。

How It Works

步骤一:配置JMX端口

在ZooKeeper中启用JMX服务以获取资源信息,操作步骤如下:

  1. 修改/opt/zk/zookeeper-3.4.10/bin/zkServer.sh,在第44行添加JMXPORT=8999

    具体添加位置如下所示:

    if [ "x$JMXLOCALONLY" = "x" ]
    then
        JMXLOCALONLY=false
    fi
    
    JMXPORT=8999 ## 添加在此处第44行。
    if [ "x$JMXDISABLE" = "x" ] || [ "$JMXDISABLE" = 'false' ]
    then
      echo "ZooKeeper JMX enabled by default $JMXPORT ..." >&2
      if [ "x$JMXPORT" = "x" ]
      then
  2. 执行以下命令重启ZooKeeper。
    /opt/zk/zookeeper-3.4.10/bin/zkServer.sh start /opt/zk/zookeeper-3.4.10/conf/zoo_sample.cfg &

步骤二:为应用埋点

启动jmx_exporter,让JMX信息可以直接通过HTTP方式访问,以便Prometheus监控抓取。操作步骤如下:

  1. 下载zookeeper.yaml文件到/opt/exporter_zookeeper/目录下。
  2. 修改下载的/opt/exporter_zookeeper/zookeeper.yaml文件,在第一行添加hostPort: localhost:8999
    将JMX服务运行的端口暴露给jmx_exporter。
  3. 下载jmx_exporter的可执行文件opt/exporter_zookeeper/目录下。
  4. 启动jmx_exporter。
    java -Dcom.sun.management.jmxremote.ssl=false -Dcom.sun.management.jmxremote.authenticate=false -Dcom.sun.management.jmxremote.port=8998 -cp /opt/exporter_zookeeper/jmx_prometheus_httpserver-0.12.0-jar-with-dependencies.jar io.prometheus.jmx.WebServer 8997 /opt/exporter_zookeeper/zookeeper_exporter.yaml &
    通过运行如下命令验证jmx_exporter是否可以正常工作。
    curl http://<jmx_exporter所在机器的IP>:8997/metrics

步骤三:配置Prometheus

配置Prometheus.yaml文件以抓取ZooKeeper数据的操作步骤如下:

  1. 登录ARMS控制台
  2. 在左侧导航栏单击Prometheus监控
  3. Prometheus监控页面的顶部菜单栏,选择K8s集群所在的地域,并在目标集群右侧的操作列单击设置
  4. 在设置页面,单击Prometheus设置页签。
  5. Prometheus.yaml中输入以下内容,然后单击保存
    global:
      scrape_interval:     15s # Set the scrape interval to every 15 seconds. Default is every 1 minute.
      evaluation_interval: 15s # Evaluate rules every 15 seconds. The default is every 1 minute.
    scrape_configs:
      - job_name: 'zookeeper'
        static_configs:
        - targets: ['121.40.0.0:8997']

步骤四:配置大盘

配置Grafana大盘以展示数据的操作步骤如下:

  1. 打开Grafana大盘概览页
  2. 在左侧导航栏选择+ > Import
  3. Import页面的Import via grafna.com文本框,输入Prometheus提供的Zookeeper大盘模板的ID10981,然后在其右侧单击Load
    Import Grafana Dashboard
  4. Import页面输入以下信息,然后单击Import
    Import Grafana Dashboard with Options
    1. Name文本框中输入自定义的大盘名称。
    2. Folder下拉框中选择您的阿里云容器服务K8s集群。
    3. Select a Prometheus data source下拉框中选择您的阿里云容器服务K8s集群。
    配置完毕后的Prometheus Grafana ZooKeeper大盘如图所示。prom-zoo gra

步骤五:创建Prometheus监控报警

  1. 登录ARMS控制台
  2. 在左侧导航栏,选择Prometheus监控
  3. Prometheus监控页面的顶部菜单栏,选择K8s集群所在的地域,单击目标K8s集群的名称。
  4. 在左侧导航栏,选择报警配置
  5. 在报警配置页面右上角,单击创建报警
  6. 创建报警面板,执行以下操作:
    1. 可选:告警模板下拉列表,选择模板。
    2. 规则名称文本框,输入规则名称,例如:网络接收压力报警。
    3. 告警表达式文本框,输入告警表达式需。例如:(sum(rate(kube_state_metrics_list_total{job="kube-state-metrics",result="error"}[5m])) / sum(rate(kube_state_metrics_list_total{job="kube-state-metrics"}[5m]))) > 0.01
      注意 PromQL语句中包含的$符号会导致报错,您需要删除包含$符号的语句中=左右两边的参数及=。例如:将sum (rate (container_network_receive_bytes_total{instance=~"^$HostIp.*"}[1m]))修改为sum (rate (container_network_receive_bytes_total[1m]))
    4. 持续时间文本框,输入时间,例如:1分钟。
    5. 告警消息文本框,输入告警消息。
    6. 可选:高级配置标签区域,单击创建标签可以设置报警标签,设置的标签可用作分派规则的选项。
    7. 可选:高级配置注释区域,单击创建注释,设置message,设置 {{变量名}}告警信息。设置完成后的格式为:message:{{变量名}}告警信息,例如:message:{{$labels.pod_name}}重启

      您可以自定义变量名,也可以选择已有的标签作为变量名。已有的标签包括:

      • 报警规则表达式指标中携带的标签。
      • 通过报警规则创建的标签,请参见创建报警
      • ARMS系统自带的默认标签,默认标签说明如下。
        标签 说明
        alertname 告警名称,格式为:告警名称_集群名称。
        _aliyun_arms_alert_level 告警等级。
        _aliyun_arms_alert_type 告警类型。
        _aliyun_arms_alert_rule_id 告警规则对应的ID。
        _aliyun_arms_region_id 地域ID。
        _aliyun_arms_userid 用户ID。
        _aliyun_arms_involvedObject_type 关联对象子类型,如ManagedKubernetes,ServerlessKubernetes。
        _aliyun_arms_involvedObject_kind 关联对象分类,如app,cluster。
        _aliyun_arms_involvedObject_id 关联对象ID。
        _aliyun_arms_involvedObject_name 关联对象名称。
    8. 通知策略下拉列表,选择通知策略。
      如何创建通知策略,请参见设置报警通知策略
    9. 单击确定
    报警配置页面显示创建的报警。