altinity-expert-clickhouse-caches

Analyze ClickHouse cache health and report sizing guidance for Mark, Uncompressed, Query, and Compiled Expression caches.

16|2|Updated Jan 8, 2026
One-click install
npx skills add https://github.com/Altinity/Skills --skill altinity-expert-clickhouse-caches-altinity
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: altinity-expert-clickhouse-caches
Source: https://github.com/Altinity/Skills/tree/main/altinity-expert-clickhouse/skills/altinity-expert-clickhouse-caches
Command: npx skills add https://github.com/Altinity/Skills --skill altinity-expert-clickhouse-caches-altinity

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Identify and analyze cache health across ClickHouse caches to detect sizing gaps and performance risks.

Core Features & Use Cases

  • Cross-cache health checks for Mark Cache, Uncompressed Cache, Query Cache, and Compiled Expression Cache
  • Per-host and per-database/table sizing guidance and actionable tuning recommendations
  • Diagnostic queries and reports to locate bottlenecks and optimize cache configuration

Quick Start

Run the checks.sql script against your ClickHouse cluster to generate cache health metrics and guidance.

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 check ClickHouse cache health and identify sizing gaps?

To check ClickHouse cache health, run diagnostic queries against your cluster to analyze Mark Cache, Uncompressed Cache, Query Cache, and Compiled Expression Cache. This identifies sizing gaps and performance risks, generating actionable per-host and per-database tuning recommendations.

What ClickHouse cache settings should I tune for faster queries?

Key ClickHouse cache settings to tune include mark_cache_size, uncompressed_cache_size, query_cache_max_size, and compiled_expression_cache_size. Adjusting these parameters based on diagnostic reports resolves bottlenecks and optimizes cache configuration for faster query performance.

Why does ClickHouse query performance degrade and how do caches affect it?

ClickHouse query performance degrades when caches like Mark Cache or Uncompressed Cache are undersized, causing excessive disk reads. Analyzing cache health detects these performance risks and sizing gaps, guiding necessary configuration adjustments to restore query speed.

Can I get per-database cache sizing guidance for my ClickHouse cluster?

Yes, you can get per-database and per-host cache sizing guidance for ClickHouse clusters. The analysis verifies settings like mark_cache_size and query_cache_max_size, providing actionable tuning recommendations tailored to your specific database and table requirements.

What is the best way to diagnose ClickHouse cache bottlenecks?

The best way to diagnose ClickHouse cache bottlenecks is to run cross-cache health checks using diagnostic queries. This evaluates Mark Cache, Uncompressed Cache, Query Cache, and Compiled Expression Cache to locate performance risks and generate actionable tuning recommendations.