altinity-expert-clickhouse-reporting

Diagnose ClickHouse SELECT query performance issues by analyzing system.query_log and checks.sql outputs.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnosing and correlating ClickHouse SELECT query performance issues across workloads to reduce latency and improve throughput.

Core Features & Use Cases

  • Identify slow queries, frequent offenders, and their patterns from system.query_log and checks.sql outputs.
  • Suggest index usage improvements, MV/Materialized View considerations, and query rewrites to reduce latency.
  • Use during cluster health audits, routine performance troubleshooting, and post-deploy performance verification.

Quick Start

Run the checks.sql file and review the results to pinpoint top offenders and bottlenecks.

Frequently Asked Questions about altinity-expert-clickhouse-reporting

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

FAQPage Schema
How do I diagnose slow ClickHouse queries using system.query_log?

You can optimize ClickHouse query performance by analyzing query patterns to suggest index usage improvements, Materialized View considerations, and query rewrites that reduce latency and improve throughput.

What is the best way to analyze ClickHouse SELECT query performance?

The best way to analyze ClickHouse SELECT query performance is running a checks.sql file against your cluster to pinpoint top offenders and data access bottlenecks, producing actionable optimization recommendations for safe operations.

Can I use query log diagnostics for ClickHouse cluster health audits?

Yes, you can use query log diagnostics for ClickHouse cluster health audits, routine performance troubleshooting, and post-deploy performance verification across both production and development workloads to detect abnormal query durations.

Why does ClickHouse query latency spike and how do I find the bottleneck?

ClickHouse query latency spikes occur due to data access bottlenecks and inefficient query patterns. You find the bottleneck by parsing system.query_log and checks.sql outputs to detect slow queries and abnormal durations.

What are the limitations of optimizing ClickHouse queries using query log analysis?

A limitation of optimizing ClickHouse queries via query log analysis is the requirement to parse system.query_log and checks.sql outputs, meaning optimization recommendations depend entirely on the availability and accuracy of those logged execution metrics.