Doris 自己管理的 Cache 目前均为 LRU 淘汰策略,均支持单独通过参数控制容量和淘汰时长。

Doris Cache 类型

  1. Page Cache

用于加速数据扫描。

  1. - DataPageCache: 缓存数据 Page
  2. - IndexPageCache: 缓存数据 Page 的索引。
  3. - PKIndexPageCache: 缓存 Page 的主键索引。
  1. Metadata Cache

用于加速元数据读取。

  1. - SegmentCache: 缓存已打开的 Segment,如索引信息。
  2. - SchemaCache: 缓存 Rowset Schema
  3. - TabletSchemaCache: 缓存 Tablet Schema
  4. - CreateTabletRRIdxCache: 缓存 Create Tabelt 索引。
  5. - MowTabletVersionCache: 缓存 Mow Tablet Version
  6. - MowDeleteBitmapAggCache: 缓存 Mow DeleteBitmap
  1. Cloud Cache

云上专用的缓存。

  1. - CloudTabletCache: Cloud 上缓存 Tablet
  2. - CloudTxnDeleteBitmapCache: Cloud 上缓存 DeleteBitmap
  1. Inverted Index Cache

加速倒排索引。

  1. - InvertedIndexSearcherCache
  2. - InvertedIndexQueryCache
  1. Point Query Cache

加速点查询执行,主要用于日志分析。

  1. - PointQueryRowCache
  2. - PointQueryLookupConnectionCache
  1. Other Cache
  1. - FileCache: 外表查询和 Cloud 使用的文件缓存。
  2. - CommonObjLRUCache
  3. - LastSuccessChannelCache

Doris Cache 查看方法

有三种方式查看 Doris Cache 相关指标。

  1. Doris BE Metrics

Web 页面 http://http://{be_host}:{be_web_server_port}/metrics 可以看到 BE 进程内存监控(Metrics),包括每个 Cache 的容量、使用率、元素个数、查找和命中次数等指标。

  1. - `doris_be_cache_capacity{name="TabletSchemaCache"} 102400`Cache 容量,内存大小或者元素个数两种限制方法。
  2. - `doris_be_cache_usage{name="TabletSchemaCache"} 40838`Cache 使用量,内存大小或者元素个数,对应 Cache 容量的限制。
  3. - `doris_be_cache_usage_ratio{name="TabletSchemaCache"} 0.398809`Cache 使用率,等于`(cache_usage / cache_capacity)`
  4. - `doris_be_cache_element_count{name="TabletSchemaCache"} 1628`Cache 元素个数,当 Cache 容量限制元素个数时等于 Cache Usage
  5. - `doris_be_cache_lookup_count{name="TabletSchemaCache"} 63393`:查找 Cache 的次数。
  6. - `doris_be_cache_hit_count{name="TabletSchemaCache"} 61765`:查找 Cache 时命中的次数。
  7. - `doris_be_cache_hit_ratio{name="TabletSchemaCache"} 0.974319`:命中率,等于`(hit_count / lookup_count)`
  1. Doris BE Bvar

Web 页面 http://http://{be_host}:{brpc_port}/vars/*cache* 可以看到部分 Cache 独有的一些指标。

未来会将 Doris BE Metrics 中的指标移动到 Doris BE Bvar 中。

  1. Memory Trakcer

实时查看每个 Cache 占用内存大小,参考 全局内存分析,当存在内存报错时在 be/log/be.INFO 日志中可以找到 Memory Tracker Summary 中,其中包含当时的 Cache 内存大小。

Cache 内存分析

Doris BE 运行时存在各种 Cache,通常无需关注 Cache 内存,因为在 BE 进程可用内存不足时会触发内存 GC 首先清理 Cache。

但 Cache 过大会增加内存 GC 的压力,增加查询或导入报错进程可用内存不足的风险,以及 BE 进程 OOM Crash 的风险。所以如果内存持续紧张,可以考虑优先降低 Cache 的上限、关闭 Cache 或降低 Cache entry 的存活时间,更小的 Cache 在某些场景中可能会降低查询性能,但在生产环境中通常可以被容忍,调整后可以观察一段时间的查询和导入的性能。

Doris 2.1 之前 Memory GC 还不完善,内存不足时可能无法及时释放 Cache,如果内存持续紧张,常常需要考虑手动降低 Cache 上限。

Doris 2.1.6 之后,如果希望在 BE 运行中手动清理所有 Cache,执行 curl http://{be_host}:{be_web_server_port}/api/clear_cache/all,将返回释放的内存大小。

下面分析不同 Cache 内存使用多的情况。

DataPageCache 内存使用多

  • Doris 2.1.6 之后,执行 curl http://{be_host}:{be_web_server_port}/api/clear_cache/DataPageCache 可以在 BE 运行中手动清理。

  • 执行 curl -X POST http://{be_host}:{be_web_server_port}/api/update_config?disable_storage_page_cache=true 对正在运行的 BE 禁用 DataPageCache,并默认在最长 10 分钟后清空,但这是临时方法,BE 重启后 DataPageCache 将重新生效。

  • 若确认要长期减少 DataPageCache 的内存使用,参考 BE 配置项,在 conf/be.conf 中调小 storage_page_cache_limit 减小 DataPageCache 的容量,或调小 data_page_cache_stale_sweep_time_sec 减小 DataPageCache 缓存有效时长,或增加 disable_storage_page_cache=true 禁用 DataPageCache,然后重启 BE 进程。

SegmentCache 内存使用多

  • Doris 2.1.6 之后,执行 curl http://{be_host}:{be_web_server_port}/api/clear_cache/SegmentCache 可以在 BE 运行中手动清理。

  • 执行 curl -X POST http:/{be_host}:{be_web_server_port}/api/update_config?disable_segment_cache=true 对正在运行的 BE 禁用 SegmentCache,并默认在最长 10 分钟后清空,但这是临时方法,BE 重启后 SegmentCache 将重新生效。

  • 若确认要长期减少 SegmentCache 的内存使用,参考 BE 配置项,在 conf/be.conf 中调整 segment_cache_capacitysegment_cache_memory_percentage 减小 SegmentCache 的容量,或调小 tablet_rowset_stale_sweep_time_sec 减小 SegmentCache 缓存有效时长,或者在 conf/be.conf 中增加 disable_segment_cache=true 禁用 SegmentCache 并重启 BE 进程。

PKIndexPageCache 内存使用多

  • Doris 2.1.6 之后,执行 curl http://{be_host}:{be_web_server_port}/api/clear_cache/PKIndexPageCache 可以在 BE 运行中手动清理。

  • 参考 BE 配置项,在 conf/be.conf 中调小 pk_storage_page_cache_limit 减小 PKIndexPageCache 的容量,或调小 pk_index_page_cache_stale_sweep_time_sec 减小 PKIndexPageCache 缓存有效时长,或者在 conf/be.conf 中增加 disable_pk_storage_page_cache=true 禁用 PKIndexPageCache,然后重启 BE 进程。