Kafka Eagle 管理平台

Kafka-Eagle簡介

源代碼地址：https://github.com/smartloli/kafka-eagle

Kafka Eagle是什么

Kafka Eagle是一款用於監控和管理Apache Kafka的完全開源系統，目前托管在Github，由筆者和一些開源愛好者共同維護。它提供了完善的管理頁面，很方面的去管理和可視化Kafka集群的一些信息，例如Broker詳情、性能指標趨勢、Topic集合、消費者信息等。

同時，兼容若干Kafka版本，例如0.8，0.9，...，以及截止到2019-12-16最新發布的2.4.0版本

Kafka Eagle包含哪些功能

Kafka Eagle監控管理系統，提供了一個可視化頁面，使用者可以擁有不同的角色，例如管理員、開發者、游客等。不同的角色對應不同的使用權限。在知道了Kafka Eagle的作用之后，那么它包含哪些功能呢？核心功能如下所示:

數據面板

負責展示Kafka集群的Broker數、Topic數、Consumer數、以及Topic LogSize Top10和Topic Capacity Top10數據。

主題

該模塊包含主題創建、主題管理、主題預覽、KSQL查詢主題、主題數據寫入、主題屬性配置等。

消費者組

該模塊包含監控不同消費者組中的Topic被消費的詳情，例如LogSize、Offsets、以及Lag等。同時，支持查看Lag的歷史趨勢圖。

集群管理

該模塊包含Kafka集群和Zookeeper集群的詳情展示，例如Kafka的IP和端口、版本號、啟動時間、Zookeeper的Leader和Follower。同時，還支持多Kafka集群切換，以及Zookeeper Client數據查看等功能。

指標監控

該模塊包含監控Kafka集群和Zookeeper集群的核心指標，包含Kafka的消息發送趨勢、消息大小接收與發送趨勢、Zookeeper的連接數趨勢等。同時，還支持查看Broker的瞬時指標數據。

告警

該模塊包含告警集群異常和消費者應用Lag異常。同時，支持多種IM告警方式，例如郵件、釘釘、微信、Webhook等。

系統管理

該模塊包含用戶管理，例如創建用戶、用戶授權、資源管理等

數據大屏

該模塊包含展示消費者和生產者當日及最近7天趨勢、Kafka集群讀寫速度、Kafka集群歷史總記錄等。

Kafka Eagle部署

Kafka Eagle安裝部署非常方便，可以從官網下載最新版本進行安裝，或者從Github下載最新的Release源代碼進行編譯安裝。

例如，從官網下載Kafka Eagle安裝包，按如下命令操作即可

下載包安裝

# 解壓安裝包
tar xf kafka-eagle-bin-2.0.3.tar.gz -C /opt/
mv /opt/kafka-eagle-bin-2.0.3/kafka-eagle-web-2.0.3-bin.tar.gz  ./
rm -rf /opt/kafka-eagle-bin-2.0.3/
tar xf kafka-eagle-web-2.0.3-bin.tar.gz -C /opt/

然后，是配置環境變量，這里需要注意的是，KE_HOME和JAVA_HOME均需在環境變量文件中進行配置（建議在~/.bash_profile文件中進行設置好，否則，可能在啟動的時候拋出環境變量找不到的錯誤），配置內容如下：
# 配置JAVA_HOME和KE_HOME：
vi ~/.bash_profile
export JAVA_HOME=/usr/local/jdk1.8.0_151
export PATH=$PATH:$JAVA_HOME/bin
export CLASSPATH=.:$JAVA_HOME/lib/dt.jar:$JAVA_HOME/lib/tools.jar
export KE_HOME=/opt/kafka-eagle-web-2.0.3
export PATH=$PATH:$JAVA_HOME/bin:$KE_HOME/bin

配置

接下來是配置Kafka Eagle的系統文件，這里需要注意一些事項，配置內容如下：

# 設置Kafka多集群，這里只需要設置Zookeeper,
# 系統會自動識別Kafka Broker
######################################
kafka.eagle.zk.cluster.alias=cluster1
# cluster1.zk.list=127.0.0.1:2181
cluster1.zk.list=zk01:2181,zk02:2181,zk03:2181
# cluster2.zk.list=127.0.0.1:2181/plain
# cluster3.zk.list=127.0.0.1:2181/scram
# cluster4.zk.list=vmn4:2181
######################################
# Zookeeper線程池最大連接數
######################################
kafka.zk.limit.size=25
######################################
# Kafka Eagle的頁面訪問端口
######################################
kafka.eagle.webui.port=8048
######################################
# 存儲消費信息的類型，一般在0.9版本之前，消費
# 信息會默認存儲在Zookeeper中，所以存儲類型
# 設置zookeeper即可，如果是在0.10版本之后，
# 消費者信息默認存儲在Kafka中，所以存儲類型
# 設置為kafka。而且，在使用消費者API時，盡量
# 客戶端Kafka API版本和Kafka服務端的版本保持
# 一致性。
######################################
cluster1.kafka.eagle.offset.storage=kafka
cluster2.kafka.eagle.offset.storage=kafka
#cluster3.kafka.eagle.offset.storage=kafka
cluster4.kafka.eagle.offset.storage=kafka
######################################
# 開啟性能監控，數據默認保留30天
######################################
kafka.eagle.metrics.charts=true
kafka.eagle.metrics.retain=30
######################################
# KSQL查詢Topic數據默認是最新的5000條，如果
# 在使用KSQL查詢的過程中出現異常，可以將下面
# 的false屬性修改為true，Kafka Eagle會在
# 系統中自動修復錯誤。
######################################
kafka.eagle.sql.topic.records.max=5000
kafka.eagle.sql.fix.error=false
######################################
# 刪除Kafka Topic時需要輸入刪除密鑰，由
# 管理員執行
######################################
kafka.eagle.topic.token=keadmin
######################################
# 開啟Kafka ACL特性，例如SCRAM或者PLAIN，
# 一般生產環境會使用SCRAM來做ACL，應為SCRAM
# 可以動態創建和管理用戶。
######################################
cluster1.kafka.eagle.sasl.enable=false
cluster1.kafka.eagle.sasl.protocol=SASL_PLAINTEXT
cluster1.kafka.eagle.sasl.mechanism=SCRAM-SHA-256
cluster1.kafka.eagle.sasl.jaas.config=org.apache.kafka.common.security.scram.ScramLoginModule required username="admin" password="admin-secret";
cluster1.kafka.eagle.sasl.client.id=
cluster2.kafka.eagle.sasl.enable=true
cluster2.kafka.eagle.sasl.protocol=SASL_PLAINTEXT
cluster2.kafka.eagle.sasl.mechanism=PLAIN
cluster2.kafka.eagle.sasl.jaas.config=org.apache.kafka.common.security.plain.PlainLoginModule required username="admin" password="admin-secret";
cluster2.kafka.eagle.sasl.client.id=
######################################
# 存儲Kafka Eagle元數據信息的數據庫，目前支持
# MySQL和Sqlite，默認使用Sqlite進行存儲
######################################

kafka.eagle.driver=org.sqlite.JDBC
kafka.eagle.url=jdbc:sqlite:/opt/kafka-eagle-web-2.0.3/db/ke.db
kafka.eagle.username=root
kafka.eagle.password=www.kafka-eagle.org

######################################
# kafka mysql jdbc driver address
######################################
#kafka.eagle.driver=com.mysql.jdbc.Driver
#kafka.eagle.url=jdbc:mysql://127.0.0.1:3306/ke?useUnicode=true&characterEncoding=UTF-8&zeroDateTimeBehavior=convertToNull
#kafka.eagle.username=root
#kafka.eagle.password=123456

查看服務狀態

# 啟動Kafka Eagle系統，執行如下命令：
ke.sh start

# 查看Kafka Eagle運行狀態
ke.sh status

# 停止Kafka Eagle
ke.sh stop

# 查看Kafka Eagle GC情況
ke.sh gc

# 查看Kafka Eagle服務器資源占用情況，例如TCP、句柄等
ke.sh stats

# 查看Kafka Eagle版本號
ke.sh version

# 查看Kafka Eagle服務器上JDK的編碼情況（如果JDK編碼不是UTF-8，可能會有異常出現，執行如下命令，根據提示來修復JDK編碼問題）
ke.sh jdk

# 查看Kafka Eagle中是否存在某個類（如果需要精確，類名前面可以加上包名）
ke.sh find [ClassName]

總結

總的來說，Kafka Eagle提供了簡單、易用的頁面，部署方便。同時，提供非常詳細的操作手冊，根據官網提供的操作手冊來安裝Kafka Eagle，一般都可以正常使用。另外，有時候可能會在日志中發現一些連接超時或是空指針異常，對於這類問題，首先需要檢測Kafka集群的各個Broker節點JMX_PORT是否開啟（這個Kafka默認是不開啟），然后就是空指針異常問題，這類問題通常發生在Kafka集群配置了ACL，這就需要認真檢測Kafka Eagle配置文件中ACL信息是否正確（比如設置的用戶名和密碼是否正確，以及用戶是否擁有訪問Topic的權限等）

vi kafka-server-start.sh
...
if [ "x$KAFKA_HEAP_OPTS" = "x" ]; then
    export KAFKA_HEAP_OPTS="-server -Xms8G -Xmx8G -XX:PermSize=128m -XX:+UseG1GC -XX:MaxGCPauseMillis=200 -XX:ParallelGCThreads=8 -XX:ConcGCThreads=5 -XX:InitiatingHeapOccupancyPercent=70"
    # 開啟JMX_PORT端口，端口開啟后，Kafka Eagle系統會自動感知獲取
    export JMX_PORT="9999"
    # 注釋腳本中默認的信息
    # export KAFKA_HEAP_OPTS="-Xmx1G -Xms1G"
fi