修改配置參數
更新時間 2025-05-09 23:32:32
最近更新時間: 2025-05-09 23:32:32
分享文章
操作場景
天翼云分布式消息服務Kafka為實例、主題、消費組的幾個常用配置提供了默認值，在實例開通時默認配置，并支持在控制臺手動修改，您可以根據具體的業務需求，自行修改。這幾種常用的配置參數，根據是否需要重啟Kafka實例，可以分為動態參數和靜態參數：
- 動態參數：修改成功后，無需重啟實例，立即生效
- 靜態參數：修改成功后，只有重啟實例才能生效
- 自定義參數
使用限制
- 已開通天翼云Kafka集群版實例，實例的運行狀態為“運行中”。
- 單機版不支持修改配置參數。
操作步驟
- 登陸管理控制臺
- 進入Kafka管理控制臺
- 在實例列表頁的操作列，目標實例行點擊“管理”
- 點擊“配置參數”，在待修改參數所在行，單擊“編輯”，修改配置參數。
- 單擊“保存”，完成參數的修改。
參數說明
動態參數
| 參數 | 參數說明 | 參數范圍 | 默認值 |
|---|---|---|---|
| log.flush.interval.messages | 消息條數刷盤閾值，當實例 broker 接收的消息條數達到閾值時，將觸發消息刷盤 | 1~9223372036854775807 | 9223372036854775807 |
| min.insync.replicas | 當 producer 將 acks 設置為 “all” (或“-1”) 時，此配置指定必須確認寫入才能被認為成功的副本的最小數量 | 1~3 | 1 |
| message.max.bytes | kafka 允許的 topic 最大單條消息大小（單位：字節） | 0~10485760 | 10485760 |
| max.connections.per.ip | 每個 ip 允許的最大連接數。超過此連接數的連接請求將被丟棄 | 100~20000 | 1000 |
| unclean.leader.election.enable | 是否能夠使不在 ISR 中 replicas 設置用來作為 leader | true,false | false |
靜態參數
| 參數 | 參數說明 | 參數范圍 | 默認值 |
|---|---|---|---|
| connections.max.idle.ms | 連接空閑超時：服務器 socket 處理線程空閑超時關閉時間 | 5000~600000 | 600000 |
| log.retention.hours | 日志刪除的時間閾值（小時為單位） | 1~168 | 72 |
| group.max.session.timeout.ms | consumer 允許的最大會話超時時間。超時時間越長，consumer 就能在心跳探測周期內有更多時間處理消息，但也會使故障檢測花費更長時間 | 6000~1800000 | 1800000 |
| auto.create.topics.enable | 是否開啟創建主題功能。 | true,false | false |
| default.replication.factor | 自動創建 topic 時的默認副本個數。 | 1~3 | 3 |
| offsets.retention.minutes | 消費位點保留時間是消費位點最大保留時間，從提交消費位點的時間開始計算，超過該時間的消費位點將被刪除。group 每次向一個 topic 分區提交一次消費位點時，該消費位點的保留時間將會被重置為0 | 1440~30240 | 30240 |
| num.partitions | 自動創建 topic 時的默認分區數。 | 1~100 | 3 |
| group.min.session.timeout.ms | consumer 允許的最小會話超時時間。超時時間越短，consumer 的心跳探測越頻繁，可以使故障檢測更快，但會導致 broker 被搶占更多的資源 | 6000~300000 | 6000 |
自定義參數
| 參數 | 參數說明 | 參數范圍 | 默認值 |
|---|---|---|---|
| 容量閾值策略 | 天翼云Kafka實例的容量閾值為95%，該容量閾值策略用于定義磁盤使用率達到容量閾值后的消息處理策略。 自動刪除：磁盤使用達到容量閾值后，Kafka實例可以正常生產和消費消息，但是會刪除最早的10%的消息，以保證磁盤容量充足。該場景優先保障業務不中斷，數據存在丟失的風險。 生產受限：磁盤使用達到容量閾值后，Kafka實例無法繼續生產消息，但可以繼續消費消息。該場景適用于對數據不能丟的業務場景，但是會導致生產業務失敗。 （注意：2024年5月25日后開通的實例才支持該參數功能，在此之前開通的實例如需使用需升級實例版本） |
produce_limit：生產受限 auto_delete：自動刪除 |
produce_limit |
