This is an automated email from the ASF dual-hosted git repository.

morningman pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/doris-website.git


The following commit(s) were added to refs/heads/master by this push:
     new 223a1017dc5a [docs] Clarify compaction thread count versus CPU 
allocation (#4613)
223a1017dc5a is described below

commit 223a1017dc5a48f159c821254706bf12ab184ce6
Author: Mingyu Chen (Rayner) <[email protected]>
AuthorDate: Fri Nov 13 08:01:49 2026 +0800

    [docs] Clarify compaction thread count versus CPU allocation (#4613)
    
    The log-analysis guide described `max_cumu_compaction_threads = 8` as
    assigning fixed CPU shares to ingestion, compaction, and queries. This
    setting controls a thread pool, so that description promised resource
    isolation it does not provide.
    
    Clarify the 32-core example and distinguish the tuning recommendation
    from a CPU quota in the English and Chinese dev, 4.x, and 3.x pages,
    including retained active-version copies. Fixes #1737.
    
    Validation: checked the cumulative thread-pool implementation on Doris
    branch-3.0, branch-4.1, and master; front matter preservation and MDX
    parsing passed for all 10 changed pages (after removing HTML comments);
    `git diff --check` passed. This is a prose-only correction with stable
    page paths, headings, and navigation.
    
    Co-authored-by: morningman <[email protected]>
---
 docs/observability/log.md                                               | 2 +-
 i18n/zh-CN/docusaurus-plugin-content-docs/current/observability/log.md  | 2 +-
 .../version-3.x/data-operate/import/import-way/log-storage-analysis.md  | 2 +-
 .../version-3.x/observability/log-storage-analysis.md                   | 2 +-
 .../docusaurus-plugin-content-docs/version-3.x/observability/log.md     | 2 +-
 .../docusaurus-plugin-content-docs/version-4.x/observability/log.md     | 2 +-
 .../version-3.x/data-operate/import/import-way/log-storage-analysis.md  | 2 +-
 versioned_docs/version-3.x/observability/log.md                         | 2 +-
 versioned_docs/version-3.x/practical-guide/log-storage-analysis.md      | 2 +-
 versioned_docs/version-4.x/observability/log.md                         | 2 +-
 10 files changed, 10 insertions(+), 10 deletions(-)

diff --git a/docs/observability/log.md b/docs/observability/log.md
index 653948540a9a..f851115bd7bd 100644
--- a/docs/observability/log.md
+++ b/docs/observability/log.md
@@ -230,7 +230,7 @@ In `be/conf/be.conf`, adjust the BE configurations 
according to the following ta
 | Storage     | `enable_file_cache = true`                                     
                                                                                
                                                                                
                           | Enable file cache                                  
                                                                                
                                                        |
 | Storage     | `file_cache_path = [{"path": "/mnt/datadisk0/file_cache", 
"total_size":53687091200, "query_limit": "10737418240"},{"path": 
"/mnt/datadisk1/file_cache", "total_size":53687091200,"query_limit": 
"10737418240"}]`                                          | Configure the cache 
paths and settings for cold data:<br />`path`: cache path<br />`total_size`: 
total size of the cache path, in bytes; 53687091200 bytes = 50 GB<br 
/>`query_limit`: maximum data a single query can read from [...]
 | Write       | `write_buffer_size = 1073741824`                               
                                                                                
                                                                                
                           | Increase the write buffer file size to reduce 
small files and random I/O, improving performance                               
                                                             |
-| Compaction  | `max_cumu_compaction_threads = 8`                              
                                                                                
                                                                                
                           | Set to CPU cores / 4, meaning 1/4 of CPU is for 
writes, 1/4 for background compaction, and 1/2 is reserved for queries and 
other operations                                               |
+| Compaction | `max_cumu_compaction_threads = 8` | For a 32-core BE, this 
limits the cumulative compaction thread pool to 8 threads. CPU core count / 4 
is only a tuning starting point, not a CPU quota or reservation. This setting 
does not allocate CPU to ingestion, queries, or base compaction; adjust it 
using compaction backlog and workload measurements. |
 | Compaction  | `inverted_index_compaction_enable = true`                      
                                                                                
                                                                                
                           | Enable index compaction to reduce CPU consumption 
during compaction                                                               
                                                         |
 | Compaction  | `enable_segcompaction = false`<br 
/>`enable_ordered_data_compaction = false`                                      
                                                                                
                                                        | Disable two 
compaction features that are not needed in log scenarios                        
                                                                                
               |
 | Compaction  | `enable_compaction_priority_scheduling = false`                
                                                                                
                                                                                
                           | Low-priority compaction is limited to 2 tasks per 
disk, which slows compaction speed                                              
                                                         |
diff --git 
a/i18n/zh-CN/docusaurus-plugin-content-docs/current/observability/log.md 
b/i18n/zh-CN/docusaurus-plugin-content-docs/current/observability/log.md
index f25cb86c88c7..1660ae6f07a4 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/observability/log.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/observability/log.md
@@ -230,7 +230,7 @@ Apache Doris 通过以下两种机制支持 Flexible Schema:
 | 存储       | `enable_file_cache = true`                                        
                                                                                
                                                                                
                        | 开启文件缓存                                                
                                                                                
                                        |
 | 存储       | `file_cache_path = [{"path": "/mnt/datadisk0/file_cache", 
"total_size":53687091200, "query_limit": "10737418240"},{"path": 
"/mnt/datadisk1/file_cache", "total_size":53687091200,"query_limit": 
"10737418240"}]`                                          | 配置冷数据的缓存路径与设置:<br 
/>`path`:缓存路径<br />`total_size`:该缓存路径的总大小,单位字节,53687091200 字节 = 50 GB<br 
/>`query_limit`:单次查询可从缓存路径查询的最大数据量,单位字节,10737418240 字节 = 10 GB |
 | 写入       | `write_buffer_size = 1073741824`                                  
                                                                                
                                                                                
                        | 增大写入缓冲区文件大小,减少小文件与随机 I/O,提升性能                         
                                                                                
                     |
-| Compaction | `max_cumu_compaction_threads = 8`                               
                                                                                
                                                                                
                          | 设为 CPU 核数 / 4,意味着 1/4 CPU 用于写入、1/4 用于后台 
Compaction,1/2 留给查询和其他操作                                                        
                                 |
+| Compaction | `max_cumu_compaction_threads = 8` | 以 32 核 BE 为例,将 Cumulative 
Compaction 线程池限制为 8 个线程。CPU 核数 / 4 只是调优起点,不是 CPU 配额或预留比例。该配置不为导入、查询或 Base 
Compaction 分配 CPU;请结合 Compaction 积压情况和实际负载调整。 |
 | Compaction | `inverted_index_compaction_enable = true`                       
                                                                                
                                                                                
                          | 开启索引合并(Index Compaction),减少 Compaction 时的 CPU 消耗    
                                                                                
                                 |
 | Compaction | `enable_segcompaction = false`<br 
/>`enable_ordered_data_compaction = false`                                      
                                                                                
                                                        | 关闭日志场景不需要的两个 
Compaction 功能                                                                   
                                                                         |
 | Compaction | `enable_compaction_priority_scheduling = false`                 
                                                                                
                                                                                
                          | 低优先级 Compaction 在一块盘上限制 2 个任务,会影响 Compaction 速度     
                                                                                
                            |
diff --git 
a/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.x/data-operate/import/import-way/log-storage-analysis.md
 
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.x/data-operate/import/import-way/log-storage-analysis.md
index aa2036aecde9..17643d48f73b 100644
--- 
a/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.x/data-operate/import/import-way/log-storage-analysis.md
+++ 
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.x/data-operate/import/import-way/log-storage-analysis.md
@@ -87,7 +87,7 @@
 | -          | `file_cache_path = [{"path": "/mnt/datadisk0/file_cache", 
"total_size":53687091200, "query_limit": "10737418240"},{"path": 
"/mnt/datadisk1/file_cache", "total_size":53687091200,"query_limit": 
"10737418240"}]` | 配置冷数据的缓存路径和相关设置,具体配置说明如下:<br />`path`:缓存路径<br 
/>`total_size`:该缓存路径的总大小,单位为字节,53687091200 字节等于 50 GB<br 
/>`query_limit`:单次查询可以从缓存路径中查询的最大数据量,单位为字节,10737418240 字节等于 10 GB |
 | 写入       | `write_buffer_size = 1073741824`                             | 
增加写入缓冲区(buffer)的文件大小,减少小文件和随机 I/O 操作,提升性能。 |
 | -          | `max_tablet_version_num = 20000`                             | 
配合建表的 time_series compaction 策略,允许更多版本暂时未合并。3.0.7 版本后不再需要,有单独的 
time_series_max_tablet_version_num 配置 |
-| Compaction | `max_cumu_compaction_threads = 8`                            | 
设置为 CPU 核数 / 4,意味着 CPU 资源的 1/4 用于写入,1/4 用于后台 Compaction,2/1 留给查询和其他操作。 |
+| Compaction | `max_cumu_compaction_threads = 8` | 以 32 核 BE 为例,将 Cumulative 
Compaction 线程池限制为 8 个线程。CPU 核数 / 4 只是调优起点,不是 CPU 配额或预留比例。该配置不为导入、查询或 Base 
Compaction 分配 CPU;请结合 Compaction 积压情况和实际负载调整。 |
 | -          | `inverted_index_compaction_enable = true`                    | 
开启索引合并(index compaction),减少 Compaction 时的 CPU 消耗。 |
 | -          | `enable_segcompaction = false` `enable_ordered_data_compaction 
= false` | 关闭日志场景不需要的两个 Compaction 功能。                   |
 | -          | `enable_compaction_priority_scheduling = false` | 低优先级 
compaction 在一块盘上限制 2 个任务,会影响 compaction 速度。 |
diff --git 
a/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.x/observability/log-storage-analysis.md
 
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.x/observability/log-storage-analysis.md
index ac532a01f6a6..532a1ff69d4d 100644
--- 
a/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.x/observability/log-storage-analysis.md
+++ 
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.x/observability/log-storage-analysis.md
@@ -87,7 +87,7 @@
 | -          | `file_cache_path = [{"path": "/mnt/datadisk0/file_cache", 
"total_size":53687091200, "query_limit": "10737418240"},{"path": 
"/mnt/datadisk1/file_cache", "total_size":53687091200,"query_limit": 
"10737418240"}]` | 配置冷数据的缓存路径和相关设置,具体配置说明如下:<br />`path`:缓存路径<br 
/>`total_size`:该缓存路径的总大小,单位为字节,53687091200 字节等于 50 GB<br 
/>`query_limit`:单次查询可以从缓存路径中查询的最大数据量,单位为字节,10737418240 字节等于 10 GB |
 | 写入       | `write_buffer_size = 1073741824`                             | 
增加写入缓冲区(buffer)的文件大小,减少小文件和随机 I/O 操作,提升性能。 |
 | -          | `max_tablet_version_num = 20000`                             | 
配合建表的 time_series compaction 策略,允许更多版本暂时未合并。 |
-| Compaction | `max_cumu_compaction_threads = 8`                            | 
设置为 CPU 核数 / 4,意味着 CPU 资源的 1/4 用于写入,1/4 用于后台 Compaction,2/1 留给查询和其他操作。 |
+| Compaction | `max_cumu_compaction_threads = 8` | 以 32 核 BE 为例,将 Cumulative 
Compaction 线程池限制为 8 个线程。CPU 核数 / 4 只是调优起点,不是 CPU 配额或预留比例。该配置不为导入、查询或 Base 
Compaction 分配 CPU;请结合 Compaction 积压情况和实际负载调整。 |
 | -          | `inverted_index_compaction_enable = true`                    | 
开启索引合并(index compaction),减少 Compaction 时的 CPU 消耗。 |
 | -          | `enable_segcompaction = false` `enable_ordered_data_compaction 
= false` | 关闭日志场景不需要的两个 Compaction 功能。                   |
 | -          | `enable_compaction_priority_scheduling = false` | 低优先级 
compaction 在一块盘上限制 2 个任务,会影响 compaction 速度。 |
diff --git 
a/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.x/observability/log.md 
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.x/observability/log.md
index 9824f49d61ea..7a4529e73e9a 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.x/observability/log.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.x/observability/log.md
@@ -94,7 +94,7 @@
 | -          | `file_cache_path = [{"path": "/mnt/datadisk0/file_cache", 
"total_size":53687091200, "query_limit": "10737418240"},{"path": 
"/mnt/datadisk1/file_cache", "total_size":53687091200,"query_limit": 
"10737418240"}]` | 配置冷数据的缓存路径和相关设置,具体配置说明如下:<br />`path`:缓存路径<br 
/>`total_size`:该缓存路径的总大小,单位为字节,53687091200 字节等于 50 GB<br 
/>`query_limit`:单次查询可以从缓存路径中查询的最大数据量,单位为字节,10737418240 字节等于 10 GB |
 | 写入       | `write_buffer_size = 1073741824`                             | 
增加写入缓冲区(buffer)的文件大小,减少小文件和随机 I/O 操作,提升性能。 |
 | -          | `max_tablet_version_num = 20000`                             | 
配合建表的 time_series compaction 策略,允许更多版本暂时未合并。 |
-| Compaction | `max_cumu_compaction_threads = 8`                            | 
设置为 CPU 核数 / 4,意味着 CPU 资源的 1/4 用于写入,1/4 用于后台 Compaction,2/1 留给查询和其他操作。 |
+| Compaction | `max_cumu_compaction_threads = 8` | 以 32 核 BE 为例,将 Cumulative 
Compaction 线程池限制为 8 个线程。CPU 核数 / 4 只是调优起点,不是 CPU 配额或预留比例。该配置不为导入、查询或 Base 
Compaction 分配 CPU;请结合 Compaction 积压情况和实际负载调整。 |
 | -          | `inverted_index_compaction_enable = true`                    | 
开启索引合并(index compaction),减少 Compaction 时的 CPU 消耗。 |
 | -          | `enable_segcompaction = false` `enable_ordered_data_compaction 
= false` | 关闭日志场景不需要的两个 Compaction 功能。                   |
 | -          | `enable_compaction_priority_scheduling = false` | 低优先级 
compaction 在一块盘上限制 2 个任务,会影响 compaction 速度。 |
diff --git 
a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/observability/log.md 
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/observability/log.md
index f25cb86c88c7..1660ae6f07a4 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/observability/log.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/observability/log.md
@@ -230,7 +230,7 @@ Apache Doris 通过以下两种机制支持 Flexible Schema:
 | 存储       | `enable_file_cache = true`                                        
                                                                                
                                                                                
                        | 开启文件缓存                                                
                                                                                
                                        |
 | 存储       | `file_cache_path = [{"path": "/mnt/datadisk0/file_cache", 
"total_size":53687091200, "query_limit": "10737418240"},{"path": 
"/mnt/datadisk1/file_cache", "total_size":53687091200,"query_limit": 
"10737418240"}]`                                          | 配置冷数据的缓存路径与设置:<br 
/>`path`:缓存路径<br />`total_size`:该缓存路径的总大小,单位字节,53687091200 字节 = 50 GB<br 
/>`query_limit`:单次查询可从缓存路径查询的最大数据量,单位字节,10737418240 字节 = 10 GB |
 | 写入       | `write_buffer_size = 1073741824`                                  
                                                                                
                                                                                
                        | 增大写入缓冲区文件大小,减少小文件与随机 I/O,提升性能                         
                                                                                
                     |
-| Compaction | `max_cumu_compaction_threads = 8`                               
                                                                                
                                                                                
                          | 设为 CPU 核数 / 4,意味着 1/4 CPU 用于写入、1/4 用于后台 
Compaction,1/2 留给查询和其他操作                                                        
                                 |
+| Compaction | `max_cumu_compaction_threads = 8` | 以 32 核 BE 为例,将 Cumulative 
Compaction 线程池限制为 8 个线程。CPU 核数 / 4 只是调优起点,不是 CPU 配额或预留比例。该配置不为导入、查询或 Base 
Compaction 分配 CPU;请结合 Compaction 积压情况和实际负载调整。 |
 | Compaction | `inverted_index_compaction_enable = true`                       
                                                                                
                                                                                
                          | 开启索引合并(Index Compaction),减少 Compaction 时的 CPU 消耗    
                                                                                
                                 |
 | Compaction | `enable_segcompaction = false`<br 
/>`enable_ordered_data_compaction = false`                                      
                                                                                
                                                        | 关闭日志场景不需要的两个 
Compaction 功能                                                                   
                                                                         |
 | Compaction | `enable_compaction_priority_scheduling = false`                 
                                                                                
                                                                                
                          | 低优先级 Compaction 在一块盘上限制 2 个任务,会影响 Compaction 速度     
                                                                                
                            |
diff --git 
a/versioned_docs/version-3.x/data-operate/import/import-way/log-storage-analysis.md
 
b/versioned_docs/version-3.x/data-operate/import/import-way/log-storage-analysis.md
index 2c43a0d06696..6819b0b0b289 100644
--- 
a/versioned_docs/version-3.x/data-operate/import/import-way/log-storage-analysis.md
+++ 
b/versioned_docs/version-3.x/data-operate/import/import-way/log-storage-analysis.md
@@ -190,7 +190,7 @@ You can find BE configuration fields in `be/conf/be.conf`. 
Refer to the followin
 | -          | `file_cache_path = [{"path": "/mnt/datadisk0/file_cache", 
"total_size":53687091200, "query_limit": "10737418240"},{"path": 
"/mnt/datadisk1/file_cache", "total_size":53687091200,"query_limit": 
"10737418240"}]` | Configure the cache path and related settings for cold data 
with the following specific configurations:<br/>`path`: cache 
path<br/>`total_size`: total size of the cache path in bytes, where 53687091200 
bytes equals 50 GB<br/>`query_limit`: maximum amount of data tha [...]
 | Write      | `write_buffer_size = 1073741824`                             | 
Increase the file size of the write buffer to reduce small files and random I/O 
operations, improving performance. |
 | -          | `max_tablet_version_num = 20000`                             | 
In coordination with the time_series compaction strategy for table creation, 
allow more versions to remain temporarily unmerged. No longer required after 
version 3.0.7, as there is a time_series_max_tablet_version_num configuration |
-| Compaction | `max_cumu_compaction_threads = 8`                            | 
Set to CPU core count / 4, indicating that 1/4 of CPU resources are used for 
writing, 1/4 for background compaction, and 2/1 for queries and other 
operations. |
+| Compaction | `max_cumu_compaction_threads = 8` | For a 32-core BE, this 
limits the cumulative compaction thread pool to 8 threads. CPU core count / 4 
is only a tuning starting point, not a CPU quota or reservation. This setting 
does not allocate CPU to ingestion, queries, or base compaction; adjust it 
using compaction backlog and workload measurements. |
 | -          | `inverted_index_compaction_enable = true`                    | 
Enable inverted index compaction to reduce CPU consumption during compaction. |
 | -          | `enable_segcompaction = false` `enable_ordered_data_compaction 
= false` | Disable two compaction features that are unnecessary for log 
scenarios. |
 | -          | `enable_compaction_priority_scheduling = false` | Low-priority 
compaction is limited to 2 tasks on a single disk, which can affect the speed 
of compaction. |
diff --git a/versioned_docs/version-3.x/observability/log.md 
b/versioned_docs/version-3.x/observability/log.md
index 38407e565ee1..ba0355736345 100644
--- a/versioned_docs/version-3.x/observability/log.md
+++ b/versioned_docs/version-3.x/observability/log.md
@@ -104,7 +104,7 @@ You can find BE configuration fields in `be/conf/be.conf`. 
Refer to the followin
 | -          | `file_cache_path = [{"path": "/mnt/datadisk0/file_cache", 
"total_size":53687091200, "query_limit": "10737418240"},{"path": 
"/mnt/datadisk1/file_cache", "total_size":53687091200,"query_limit": 
"10737418240"}]` | Configure the cache path and related settings for cold data 
with the following specific configurations:<br/>`path`: cache 
path<br/>`total_size`: total size of the cache path in bytes, where 53687091200 
bytes equals 50 GB<br/>`query_limit`: maximum amount of data tha [...]
 | Write      | `write_buffer_size = 1073741824`                             | 
Increase the file size of the write buffer to reduce small files and random I/O 
operations, improving performance. |
 | -          | `max_tablet_version_num = 20000`                             | 
In coordination with the time_series compaction strategy for table creation, 
allow more versions to remain temporarily unmerged |
-| Compaction | `max_cumu_compaction_threads = 8`                            | 
Set to CPU core count / 4, indicating that 1/4 of CPU resources are used for 
writing, 1/4 for background compaction, and 2/1 for queries and other 
operations. |
+| Compaction | `max_cumu_compaction_threads = 8` | For a 32-core BE, this 
limits the cumulative compaction thread pool to 8 threads. CPU core count / 4 
is only a tuning starting point, not a CPU quota or reservation. This setting 
does not allocate CPU to ingestion, queries, or base compaction; adjust it 
using compaction backlog and workload measurements. |
 | -          | `inverted_index_compaction_enable = true`                    | 
Enable inverted index compaction to reduce CPU consumption during compaction. |
 | -          | `enable_segcompaction = false` `enable_ordered_data_compaction 
= false` | Disable two compaction features that are unnecessary for log 
scenarios. |
 | -          | `enable_compaction_priority_scheduling = false` | Low-priority 
compaction is limited to 2 tasks on a single disk, which can affect the speed 
of compaction. |
diff --git a/versioned_docs/version-3.x/practical-guide/log-storage-analysis.md 
b/versioned_docs/version-3.x/practical-guide/log-storage-analysis.md
index 9ad4259adcdc..5ca122092da3 100644
--- a/versioned_docs/version-3.x/practical-guide/log-storage-analysis.md
+++ b/versioned_docs/version-3.x/practical-guide/log-storage-analysis.md
@@ -190,7 +190,7 @@ You can find BE configuration fields in `be/conf/be.conf`. 
Refer to the followin
 | -          | `file_cache_path = [{"path": "/mnt/datadisk0/file_cache", 
"total_size":53687091200, "query_limit": "10737418240"},{"path": 
"/mnt/datadisk1/file_cache", "total_size":53687091200,"query_limit": 
"10737418240"}]` | Configure the cache path and related settings for cold data 
with the following specific configurations:<br/>`path`: cache 
path<br/>`total_size`: total size of the cache path in bytes, where 53687091200 
bytes equals 50 GB<br/>`query_limit`: maximum amount of data tha [...]
 | Write      | `write_buffer_size = 1073741824`                             | 
Increase the file size of the write buffer to reduce small files and random I/O 
operations, improving performance. |
 | -          | `max_tablet_version_num = 20000`                             | 
In coordination with the time_series compaction strategy for table creation, 
allow more versions to remain temporarily unmerged |
-| Compaction | `max_cumu_compaction_threads = 8`                            | 
Set to CPU core count / 4, indicating that 1/4 of CPU resources are used for 
writing, 1/4 for background compaction, and 2/1 for queries and other 
operations. |
+| Compaction | `max_cumu_compaction_threads = 8` | For a 32-core BE, this 
limits the cumulative compaction thread pool to 8 threads. CPU core count / 4 
is only a tuning starting point, not a CPU quota or reservation. This setting 
does not allocate CPU to ingestion, queries, or base compaction; adjust it 
using compaction backlog and workload measurements. |
 | -          | `inverted_index_compaction_enable = true`                    | 
Enable inverted index compaction to reduce CPU consumption during compaction. |
 | -          | `enable_segcompaction = false` `enable_ordered_data_compaction 
= false` | Disable two compaction features that are unnecessary for log 
scenarios. |
 | -          | `enable_compaction_priority_scheduling = false` | Low-priority 
compaction is limited to 2 tasks on a single disk, which can affect the speed 
of compaction. |
diff --git a/versioned_docs/version-4.x/observability/log.md 
b/versioned_docs/version-4.x/observability/log.md
index be4606cdbb21..33c831e112f8 100644
--- a/versioned_docs/version-4.x/observability/log.md
+++ b/versioned_docs/version-4.x/observability/log.md
@@ -230,7 +230,7 @@ In `be/conf/be.conf`, adjust the BE configurations 
according to the following ta
 | Storage     | `enable_file_cache = true`                                     
                                                                                
                                                                                
                           | Enable file cache                                  
                                                                                
                                                        |
 | Storage     | `file_cache_path = [{"path": "/mnt/datadisk0/file_cache", 
"total_size":53687091200, "query_limit": "10737418240"},{"path": 
"/mnt/datadisk1/file_cache", "total_size":53687091200,"query_limit": 
"10737418240"}]`                                          | Configure the cache 
paths and settings for cold data:<br />`path`: cache path<br />`total_size`: 
total size of the cache path, in bytes; 53687091200 bytes = 50 GB<br 
/>`query_limit`: maximum data a single query can read from [...]
 | Write       | `write_buffer_size = 1073741824`                               
                                                                                
                                                                                
                           | Increase the write buffer file size to reduce 
small files and random I/O, improving performance                               
                                                             |
-| Compaction  | `max_cumu_compaction_threads = 8`                              
                                                                                
                                                                                
                           | Set to CPU cores / 4, meaning 1/4 of CPU is for 
writes, 1/4 for background compaction, and 1/2 is reserved for queries and 
other operations                                               |
+| Compaction | `max_cumu_compaction_threads = 8` | For a 32-core BE, this 
limits the cumulative compaction thread pool to 8 threads. CPU core count / 4 
is only a tuning starting point, not a CPU quota or reservation. This setting 
does not allocate CPU to ingestion, queries, or base compaction; adjust it 
using compaction backlog and workload measurements. |
 | Compaction  | `inverted_index_compaction_enable = true`                      
                                                                                
                                                                                
                           | Enable index compaction to reduce CPU consumption 
during compaction                                                               
                                                         |
 | Compaction  | `enable_segcompaction = false`<br 
/>`enable_ordered_data_compaction = false`                                      
                                                                                
                                                        | Disable two 
compaction features that are not needed in log scenarios                        
                                                                                
               |
 | Compaction  | `enable_compaction_priority_scheduling = false`                
                                                                                
                                                                                
                           | Low-priority compaction is limited to 2 tasks per 
disk, which slows compaction speed                                              
                                                         |


---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]

Reply via email to