云消息隊列 Kafka 版可以作為Output接入Filebeat。本文說明如何在公網環境下通過Filebeat向云消息隊列 Kafka 版發送消息。
前提條件
在開始本教程前,請確保您已完成以下操作:
購買并部署云消息隊列 Kafka 版實例。具體操作,請參見公網和VPC接入。
下載并安裝Filebeat。具體操作,請參見Download Filebeat。
下載并安裝JDK 8。具體操作,請參見Download JDK 8。
步驟一:獲取接入點與用戶名密碼
Filebeat通過云消息隊列 Kafka 版的接入點與云消息隊列 Kafka 版建立連接。
在概覽頁面的資源分布區域,選擇地域。
在實例列表頁面,單擊作為Output接入Filebeat的實例的名稱。
在實例詳情頁面的接入點信息區域,獲取實例的接入點。在配置信息區域,獲取用戶名與密碼。
說明不同接入點的差異,請參見接入點對比。
步驟二:創建Topic
創建用于存儲消息的Topic。
在概覽頁面的資源分布區域,選擇地域。
重要Topic需要在應用程序所在的地域(即所部署的ECS的所在地域)進行創建。Topic不能跨地域使用。例如Topic創建在華北2(北京)這個地域,那么消息生產端和消費端也必須運行在華北2(北京)的ECS。
在實例列表頁面,單擊目標實例名稱。
在左側導航欄,單擊Topic 管理。
在Topic 管理頁面,單擊創建 Topic。
在創建 Topic面板,設置Topic屬性,然后單擊確定。
參數
說明
示例
名稱
Topic名稱。
demo
描述
Topic的簡單描述。
demo test
分區數
Topic的分區數量。
12
存儲引擎
說明當前僅專業版實例支持選擇存儲引擎類型,標準版暫不支持,默認選擇為云存儲類型。
Topic消息的存儲引擎。
云消息隊列 Kafka 版支持以下兩種存儲引擎。
云存儲:底層接入阿里云云盤,具有低時延、高性能、持久性、高可靠等特點,采用分布式3副本機制。實例的規格類型為標準版(高寫版)時,存儲引擎只能為云存儲。
Local 存儲:使用原生Kafka的ISR復制算法,采用分布式3副本機制。
云存儲
消息類型
Topic消息的類型。
普通消息:默認情況下,保證相同Key的消息分布在同一個分區中,且分區內消息按照發送順序存儲。集群中出現機器宕機時,可能會造成消息亂序。當存儲引擎選擇云存儲時,默認選擇普通消息。
分區順序消息:默認情況下,保證相同Key的消息分布在同一個分區中,且分區內消息按照發送順序存儲。集群中出現機器宕機時,仍然保證分區內按照發送順序存儲。但是會出現部分分區發送消息失敗,等到分區恢復后即可恢復正常。當存儲引擎選擇Local 存儲時,默認選擇分區順序消息。
普通消息
日志清理策略
Topic日志的清理策略。
當存儲引擎選擇Local 存儲(當前僅專業版實例支持選擇存儲引擎類型為Local存儲,標準版暫不支持)時,需要配置日志清理策略。
云消息隊列 Kafka 版支持以下兩種日志清理策略。
Delete:默認的消息清理策略。在磁盤容量充足的情況下,保留在最長保留時間范圍內的消息;在磁盤容量不足時(一般磁盤使用率超過85%視為不足),將提前刪除舊消息,以保證服務可用性。
Compact:使用Kafka Log Compaction日志清理策略。Log Compaction清理策略保證相同Key的消息,最新的value值一定會被保留。主要適用于系統宕機后恢復狀態,系統重啟后重新加載緩存等場景。例如,在使用Kafka Connect或Confluent Schema Registry時,需要使用Kafka Compact Topic存儲系統狀態信息或配置信息。
重要Compact Topic一般只用在某些生態組件中,例如Kafka Connect或Confluent Schema Registry,其他情況的消息收發請勿為Topic設置該屬性。具體信息,請參見云消息隊列 Kafka 版Demo庫。
Compact
標簽
Topic的標簽。
demo
創建完成后,在Topic 管理頁面的列表中顯示已創建的Topic。
步驟三:Filebeat發送消息
在安裝了Filebeat的機器上啟動Filebeat,向創建的Topic發送消息。
執行cd命令切換到Filebeat的安裝目錄。
執行以下命令下載CA證書文件。
wget https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20220826/ytsw/only-4096-ca-cert
創建output.conf配置文件。
執行命令
vim output.conf
創建空的配置文件。按i鍵進入插入模式。
輸入以下內容。
filebeat.inputs: - type: stdin output.kafka: hosts: ["alikafka-pre-cn-zv**********-1.alikafka.aliyuncs.com:9093", "alikafka-pre-cn-zv**********-2.alikafka.aliyuncs.com:9093", "alikafka-pre-cn-zv**********-3.alikafka.aliyuncs.com:9093"] username: "alikafka_pre-cn-v641e1d***" password: "aeN3WLRoMPRXmAP2jvJuGk84Kuuo***" topic: 'filebeat_test' partition.round_robin: reachable_only: false ssl.certificate_authorities: ["/home/admin/filebeat/filebeat-7.7.0-linux-x86_64/tasks/vpc_ssl/ca-cert"] ssl.verification_mode: none required_acks: 1 compression: none max_message_bytes: 1000000
參數
描述
示例值
hosts
云消息隊列 Kafka 版提供的公網接入點為SSL接入點。
alikafka-pre-cn-zv**********-1.alikafka.aliyuncs.com:9093,alikafka-pre-cn-zv**********-2.alikafka.aliyuncs.com:9093,alikafka-pre-cn-zv**********-3.alikafka.aliyuncs.com:9093
username
公網/VPC實例的用戶名。
alikafka_pre-cn-v641e1d***
password
公網/VPC實例的密碼。
aeN3WLRoMPRXmAP2jvJuGk84Kuuo***
topic
Topic的名稱。
filebeat_test
reachable_only
消息是否只發送到可用的分區。取值:
true:如果主分區不可用,輸出可能阻塞。
false:即使主分區不可用,輸出不被阻塞。
false
ssl.certificate_authorities
CA證書所在位置。
/home/admin/filebeat/filebeat-7.7.0-linux-x86_64/ca-cert
ssl.verification_mode
認證模式。
none
required_acks
ACK可靠性。取值:
0:無響應
1:等待本地提交
-1:等待所有副本提交
默認值為1。
1
compression
數據壓縮編碼器。默認值為gzip。取值:
none:無
snappy:用來壓縮和解壓縮的C++開發包
lz4:著重于壓縮和解壓縮速度的無損數據壓縮算法
gzip:GNU自由軟件的文件壓縮程序
none
max_message_bytes
最大消息大小。單位為字節。默認值為1000000。該值應小于您配置的云消息隊列 Kafka 版最大消息大小。
1000000
更多參數說明,請參見Kafka output plugin。
按Esc鍵回到命令行模式。
按:鍵進入底行模式,輸入wq,然后按回車鍵保存文件并退出。
向創建的Topic發送消息。
執行
./filebeat -c ./output.yml
。輸入test,然后按回車鍵。
步驟四:查看Topic分區
查看消息發送到Topic的情況。
在概覽頁面的資源分布區域,選擇地域。
在實例列表頁面,單擊目標實例名稱。
在左側導航欄,單擊Topic 管理。
在Topic 管理頁面,單擊目標Topic名稱進入Topic 詳情頁面,然后單擊分區狀態頁簽。
表 1. 分區狀態信息
參數
說明
分區ID
該Topic分區的ID號。
最小位點
該Topic在當前分區下的最小消費位點。
最大位點
該Topic在當前分區下的最大消費位點。
分區消息量
該Topic在當前分區下的消息總量。
最近更新時間
本分區中最近一條消息的存儲時間。
步驟五:按位點查詢消息
您可以根據發送的消息的分區ID和位點信息查詢該消息。
在概覽頁面的資源分布區域,選擇地域。
在實例列表頁面,單擊目標實例名稱。
在左側導航欄,單擊消息查詢。
在消息查詢頁面的查詢方式列表中,選擇按位點查詢。
在Topic列表中,選擇消息所屬Topic名稱;在分區列表中,選擇消息所屬的分區;在起始位點文本框,輸入消息所在分區的位點,然后單擊查詢。
展示該查詢位點及以后連續的消息。例如,指定的分區和位點都為“5”,那么返回的結果從位點“5”開始。
表 2. 查詢結果參數解釋
參數
描述
分區
消息的Topic分區。
位點
消息的所在的位點。
Key
消息的鍵(已強制轉化為String類型)。
Value
消息的值(已強制轉化為String類型),即消息的具體內容。
消息創建時間
發送消息時,客戶端自帶的或是您指定的
ProducerRecord
中的消息創建時間。說明如果配置了該字段,則按配置值顯示。
如果未配置該字段,則默認取消息發送時的系統時間。
如果顯示值為1970/x/x x:x:x,則說明發送時間配置為0或其他有誤的值。
0.9及以前版本的云消息隊列 Kafka 版客戶端不支持配置該時間。
操作
單擊下載 Key:下載消息的鍵值。
單擊下載 Value:下載消息的具體內容。
重要查詢到的每條消息在控制臺上最多顯示1 KB的內容,超過1 KB的部分將自動截斷。如需查看完整的消息內容,請下載相應的消息。
下載的消息最大為10 MB。如果消息超過10 MB,則只下載10 MB的內容。