altinity-expert-clickhouse-reporting

Diagnose slow ClickHouse queries by analyzing system.query_log and related system views.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnose and optimize ClickHouse query performance by analyzing queries, logs, and patterns to identify bottlenecks and opportunities for optimization.

Core Features & Use Cases

  • Diagnose slow queries and identify patterns across query logs
  • Analyze query duration, read bytes, memory usage, and CPU time to guide optimizations
  • Provide actionable recommendations and targeted diagnostics for ClickHouse deployments
  • Use cases include investigating timeouts, high latency, and poorly performing queries in production environments

Quick Start

Run the provided diagnostic SQL snippets to surface slow queries, recent failures, and insights for optimizing ClickHouse performance.

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 in a production cluster?

To diagnose slow ClickHouse queries, you analyze system.query_log and system.processes to surface query duration, read bytes, memory usage, and CPU time. This reveals bottlenecks and failure patterns over defined time windows for optimization.

What ClickHouse system views are needed for query performance analysis?

ClickHouse query performance analysis relies on querying system.query_log, system.processes, and related system views. These views compute duration, read bytes, memory usage, and sample queries to identify optimization opportunities.

How do I find recent ClickHouse query failures and timeouts?

To find recent ClickHouse query failures and timeouts, run diagnostic SQL snippets against system.query_log to surface recent failures and slow queries. This identifies failure patterns and high latency issues in production environments.

Can I identify ClickHouse query bottlenecks by analyzing memory and CPU usage?

Yes, you can identify ClickHouse query bottlenecks by analyzing memory and CPU usage. By querying system.query_log to compute CPU time, read bytes, and memory usage, you can pinpoint resource-heavy queries for optimization.

What is the best way to optimize poorly performing ClickHouse queries?

The best way to optimize poorly performing ClickHouse queries is to analyze query logs for duration, read bytes, memory usage, and CPU time, then apply targeted diagnostics to surface bottlenecks and guide optimizations.