altinity-expert-clickhouse-metrics

Monitor ClickHouse metrics, events, and asynchronous metrics via SQL checks.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Real-time monitoring of ClickHouse metrics, events, and asynchronous metrics helps operators identify health issues, performance degradation, and capacity risks across distributed clusters.

Core Features & Use Cases

  • Real-time visibility into key metrics per host, including load averages, memory usage, connections, and query throughput.
  • Cross-module diagnostics that correlate metrics from memory, replication, merges, and reporting to enable root-cause analysis.
  • Use cases include detecting high load, replication delays, memory pressure, and query bottlenecks, then guiding remediation actions.

Quick Start

Run the provided checks.sql against your ClickHouse cluster to generate a real-time health snapshot.

Frequently Asked Questions about altinity-expert-clickhouse-metrics

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

FAQPage Schema
How do I monitor real-time ClickHouse metrics to detect health issues and performance bottlenecks?

To monitor ClickHouse performance, run the provided checks.sql against your cluster to query system metrics and event logs. This generates a real-time health snapshot identifying high load, replication delays, memory pressure, and query contention.

What ClickHouse metrics should I check when my cluster is experiencing high load and queue growth?

For high load and queue growth, check real-time metrics including load averages, memory usage, active connections, and query throughput. Cross-module diagnostics correlate memory, replication, merges, and reporting metrics to isolate resource saturation and root causes.

Can I use SQL queries to diagnose replication delays and memory pressure in ClickHouse?

Yes, you can use SQL queries to diagnose replication delays and memory pressure in ClickHouse. The provided checks.sql queries asynchronous metrics and event logs to detect resource saturation and query contention across distributed cluster hosts.

How do I get a real-time health snapshot of my ClickHouse cluster?

To get a real-time health snapshot of your ClickHouse cluster, execute the checks.sql script. It queries system metrics views and asynchronous metrics to deliver structured health indicators for hosts experiencing excessive connections or bottlenecks.

Does this ClickHouse monitoring approach work for distributed clusters with resource saturation?

Yes, this monitoring approach works for distributed clusters with resource saturation. It applies cross-module diagnostics to correlate metrics from memory, merges, and replication across hosts, guiding remediation actions for capacity risks.