AgentSkillsCN

altinity-expert-clickhouse-storage

诊断 ClickHouse 的磁盘使用情况、压缩效率、分区大小以及存储瓶颈。适用于处理磁盘空间不足或 IO 性能缓慢等问题。

SKILL.md
--- frontmatter
name: altinity-expert-clickhouse-storage
description: Diagnose ClickHouse disk usage, compression efficiency, part sizes, and storage bottlenecks. Use for disk space issues and slow IO.

Storage and Disk Usage Analysis

Diagnose disk usage, compression efficiency, part sizes, and storage bottlenecks.


Diagnostics

Run all queries from the file checks.sql and analyze the results.


Ad-Hoc Query Guidelines

Required Safeguards

sql
-- Always limit results
limit 100

-- For part_log
where event_date >= today() - 1

Key Tables

  • system.disks - Disk configuration
  • system.parts - Part storage details
  • system.columns - Column compression
  • system.storage_policies - Tiered storage
  • system.detached_parts - Orphaned parts

Cross-Module Triggers

FindingLoad ModuleReason
Poor compressionaltinity-expert-clickhouse-schemaCodec recommendations
Many small partsaltinity-expert-clickhouse-mergesMerge backlog
High write IOaltinity-expert-clickhouse-ingestionBatch sizing
System logs largealtinity-expert-clickhouse-logsTTL configuration
Slow disk + mergesaltinity-expert-clickhouse-mergesMerge optimization

Settings Reference

SettingNotes
min_bytes_for_wide_partThreshold for Wide vs Compact parts
min_rows_for_wide_partRow threshold for Wide parts
max_bytes_to_merge_at_max_space_in_poolMax merge size
prefer_not_to_mergeDisable merges (emergency)