altinity-expert-clickhouse-caches

Analyze ClickHouse cache systems and produce a prioritized tuning plan.

42|7|Updated Dec 26, 2025
One-click install
npx skills add https://github.com/ntk148v/clicklens --skill altinity-expert-clickhouse-caches
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: altinity-expert-clickhouse-caches
Source: https://github.com/ntk148v/clicklens/tree/main/.agent/skills/altinity-expert-clickhouse-caches
Command: npx skills add https://github.com/ntk148v/clicklens --skill altinity-expert-clickhouse-caches

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnose and optimize ClickHouse cache layers (mark cache, uncompressed cache, query cache, and compiled expression cache) to improve response times and reduce memory pressure.

Core Features & Use Cases

  • Cache health assessment across multiple cache systems
  • Guidance on tuning cache sizes, eviction behavior, and workload-specific optimizations
  • Use cases for workloads with high cache churn, large datasets, or complex queries

Quick Start

Run a cache health audit across mark, uncompressed, query, and compiled caches to identify hot spots and tuning opportunities.

Frequently Asked Questions about altinity-expert-clickhouse-caches

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I analyze ClickHouse cache hit ratios to improve query performance?

Analyze ClickHouse cache hit ratios by examining system events, asynchronous metrics, and query cache views to compute memory usage and cache effectiveness. This process identifies health issues and generates a prioritized tuning plan for optimal response times.

What is the best way to tune ClickHouse mark cache and uncompressed cache sizes?

The best way to tune ClickHouse mark cache and uncompressed cache sizes is to assess cache health across typical deployment scenarios and datasets. This produces actionable recommendations for adjusting cache sizes and eviction behavior to reduce memory pressure.

Why does my ClickHouse query cache experience high churn with large datasets?

ClickHouse query cache experiences high churn with large datasets due to frequent eviction from memory pressure. Analyzing system parts statistics and asynchronous metrics helps identify these hot spots and provides workload-specific optimization opportunities to stabilize cache effectiveness.

How do I diagnose ClickHouse compiled expression cache and query cache issues?

Diagnose ClickHouse compiled expression cache and query cache issues by running a health audit across all cache systems. This identifies hot spots and optimization opportunities by relying on system events and asynchronous metrics to compute cache effectiveness.

Can I use cache analysis to reduce memory pressure in ClickHouse workloads with complex queries?

Yes, cache analysis reduces memory pressure in ClickHouse workloads with complex queries by computing memory usage and cache effectiveness. It provides a prioritized tuning plan with actionable recommendations to optimize cache sizes and eviction behavior for these workloads.