前言
EFAK(Eagle For Apache Kafka)是一个简单、高性能的Kafka集群监控系统,实现了监控、可视化操作Topic/Zookeeper、SQL查询、告警等功能,它以前的名字叫Kafka Eagle。
我们重点看看如何安装以及简单使用它。
kafka 版本支持:
0.8.2.x
,0.9.x
,0.10.x
,0.11.x
,1.x
,2.x
.支持平台:
Mac OS X
,Linux
,Windows
.支持的JDK:
JDK8+
安装步骤
下载解压
执行后下载目录是~/soft/kafka
,可执行程序目录是/opt/soft/efak-web-2.0.8
。
echo "创建下载目录" > /dev/null
mkdir -p ~/soft/kafka
echo "下载到~/soft/kafka" > /dev/null
curl -o ~/soft/kafka/kafka-eagle-bin-2.0.8.tar.gz https://codeload.github.com/smartloli/kafka-eagle-bin/tar.gz/v2.0.8
echo "创建解压目录" > /dev/null
mkdir -p /opt/soft
echo "解压到当前目录,真正的包还在解压文件夹下" > /dev/null
tar -xf ~/soft/kafka/kafka-eagle-bin-2.0.8.tar.gz
echo "解压到/opt/soft" > /dev/null
tar -xf ~/soft/kafka/kafka-eagle-bin-2.0.8/efak-web-2.0.8-bin.tar.gz -C /opt/soft
编辑配置文件
我们这里演示只使用了必要的参数进行配置,详细配置参考Kafka-eagle – 配置文档[1]。数据库得提前创建好。
需要注意的是cluster1.zk.list=
配置的值需要跟Kafka配置文件server.properties
中参数zookeeper.connect=
配置得一样,包括后面的命名空间/kafka
。
echo "备份配置文件" > /dev/null
cp /opt/soft/efak-web-2.0.8/conf/system-config.properties /opt/soft/efak-web-2.0.8/conf/system-config.properties.bak
echo "覆盖配置文件为以下内容" > /dev/null
echo '
# Kafka使用的Zookeeper集群别名,多个集群用逗号分隔,后续针对不同集群配置都需要别名作前缀
efak.zk.cluster.alias=cluster1
# Kafka配置的Zookeeper集群客户端访问地址
cluster1.zk.list=node1:2181,node2:2181,node3:2181/kafka
# efak的Web界面访问端口
efak.webui.port=8048
# EFAK跟Zookeeper的最大连接数
kafka.zk.limit.size=25
# 开启metrics
efak.metrics.charts=true
# 保留时间15天
efak.metrics.retain=15
# kafka jmx uri
cluster1.efak.jmx.uri=service:jmx:rmi:///jndi/rmi://%s/jmxrmi
# MySQL配置
efak.driver=com.mysql.cj.jdbc.Driver
efak.url=jdbc:mysql://192.168.2.33:3306/efak?useUnicode=true&characterEncoding=UTF-8&zeroDateTimeBehavior=convertToNull
efak.username=root
efak.password=pwd888888' > /opt/soft/efak-web-2.0.8/conf/system-config.properties
配置环境变量
环境变量在脚本中会使用到,所以必须配置下,也能简便我们命令行操作。
echo "追加环境变量KE_HOME" > /dev/null
echo '
export KE_HOME=/opt/soft/efak-web-2.0.8
export PATH=$PATH:$KE_HOME/bin' >> /etc/profile
echo "使环境变量生效" > /dev/null
source /etc/profile
服务启停等操作
使用bin
目录下的脚本ke.sh
实现所有操作,命令格式为ke.sh [选项]
。选项有start|status|stop|restart|stats
对应启动|服务状态|停止|重启|查看资源占用
,参考 Kafka-eagle – shell[2]。如:
echo "启动" > /dev/null
ke.sh start
控制台日志在logs/ke_console.out
,是一个软链接指向了另一个真实日志路径。
启动成功后控制台会打印出用户名密码和HTTP访问地址相关信息。要注意的是,启动失败也会打印出这些信息,所以得通过链接访问成功了才能判断启动没问题。
配置Metrics
这个主要是为了开启Metrics和BScreen两个功能来实现Kafka消息的数量、请求的数量、处理时间等数据可视化。
这个功能是通过Java管理扩展(Java Management Extensions,JMX)实现监控的,参考Kafka-eagle – Metrics[3]。
EFAK配置文件system-config.properties
需要配置下面相关参数。
# 开启metrics
efak.metrics.charts=true
# 保留时间15天
efak.metrics.retain=15
# kafka jmx uri
cluster1.efak.jmx.uri=service:jmx:rmi:///jndi/rmi://%s/jmxrmi
开启Kafka的JMX功能,编辑Kafka启动脚本kafka-server-start.sh
,修改if [ "x$KAFKA_HEAP_OPTS" = "x" ]; then
中的内容为如下,其实就是设置相关的JVM启动选项。其中JMX_PORT
可以自定义,EFAK会自己发现。
if [ "x$KAFKA_HEAP_OPTS" = "x" ]; then
export KAFKA_HEAP_OPTS="-server -Xms2G -Xmx2G -XX:PermSize=128m -XX:+UseG1GC -XX:MaxGCPauseMillis=200 -XX:ParallelGCThreads=8 -XX:ConcGCThreads=5 -XX:InitiatingHeapOccupancyPercent=70"
export JMX_PORT="9999"
fi
Zookeeper版本3.5以上需要修改启动脚本zkServer.sh
,在77行后添加以下内容。
ZOOMAIN="-Dzookeeper.4lw.commands.whitelist=* ${ZOOMAIN}"
在【Cluster / ZK & Kafka】中可以看到Kafka节点,以及JMX相关信息,其中JMX Port设置成不一样它也自动发现了。
简单使用
通过浏览器用IP+端口号(如:http://192.168.0.1:8048/)访问主页,需要用户名和密码登陆。相关信息在启动日志中都有给出。
如果配置了Metrics,菜单栏中【Metrics】和【BScreen】都可以看到数据。
安装问题
内存不够
如果启动失败可以看日志来分析原因,比如我当时报错Cannot allocate memory
,因为机器内存不够。
cat $KE_HOME/logs/ke_console.out
Java HotSpot(TM) 64-Bit Server VM warning: INFO: os::commit_memory(0x0000000080000000, 2147483648, 0) failed; error=’Cannot allocate memory’ (errno=12)
而通过看启动脚本内容(ke.sh
)发现启动的JVM选项中指定了堆内存大小为2G。
解决办法:将脚本中堆内存参数改小,或者增加服务器内存。
看不到数据
【Dashboard】【ZK & Kafka】等功能没有数据。
【Cluster / ZkCli】中也能看到ZK连接状态为DISCONNECTED
。
通过日志可以看到类似下面的错误。通过错误提示在源码中定位后发现是因为kafka.zk.limit.size
(EFAK跟Zookeeper的最大连接数)没有设置,初始化后连接池为0,所以报错。
ERROR [KafkaZKPoolUtils.http-nio-8048-exec-8] – Error initializing zookeeper, msg is
java.lang.IndexOutOfBoundsException: Index: 0, Size: 0 at java.util.ArrayList.rangeCheck(ArrayList.java:659) at java.util.ArrayList.get(ArrayList.java:435) at org.smartloli.kafka.eagle.common.util.KafkaZKPoolUtils.getZkClient(KafkaZKPoolUtils.java:128)
Kafka cluster[cluster1.zk.list] address has null.
Get all brokers info has error,msg is
java.lang.IndexOutOfBoundsException: Index: 0, Size: 0 at java.util.ArrayList.rangeCheck(ArrayList.java:659) at java.util.ArrayList.get(ArrayList.java:435) at org.smartloli.kafka.eagle.common.util.KafkaZKPoolUtils.getZkClient(KafkaZKPoolUtils.java:128)
解决办法:在EFAK配置文件system-config.properties
中配置这个参数的值,比如像配置模板一样配置成25,然后重启服务即可。
参考
GitHub -EFAK[4]
Kafka-eagle – 官网[5]
Kafka-eagle – Install on Linux/macOS[6]
Kafka-eagle – 下载页[7]
Kafka-eagle – 配置文档[8]
引用链接
[1]
Kafka-eagle – 配置文档: http://www.kafka-eagle.org/articles/docs/installation/configuration.html[2]
Kafka-eagle – shell: http://www.kafka-eagle.org/articles/docs/quickstart/shell.html[3]
Kafka-eagle – Metrics: http://www.kafka-eagle.org/articles/docs/quickstart/metrics.html[4]
GitHub -EFAK: https://github.com/smartloli/EFAK[5]
Kafka-eagle – 官网: https://www.kafka-eagle.org/[6]
Kafka-eagle – Install on Linux/macOS: http://www.kafka-eagle.org/articles/docs/installation/linux-macos.html[7]
Kafka-eagle – 下载页: http://download.kafka-eagle.org/[8]
Kafka-eagle – 配置文档: http://www.kafka-eagle.org/articles/docs/installation/configuration.html
原文始发于微信公众号(我有八千部下):在Linux安装Kafka监控系统EFAK
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 举报,一经查实,本站将立刻删除。
文章由极客之音整理,本文链接:https://www.bmabk.com/index.php/post/102693.html