altinity-expert-clickhouse-errors

Analyzes ClickHouse errors and crashes from system logs to identify root causes.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Investigate ClickHouse errors, exceptions, crashes, and error patterns to enable rapid fault diagnosis and remediation.

Core Features & Use Cases

  • Error Investigation & Analysis: Deep dive into system.query_log and system.crash_log to identify failure patterns and responsible queries or users.
  • Pattern & Crash Diagnostics: Correlate exception codes, crash signals, and text_log messages to prioritize fixes and prevent recurrences.
  • Operational Scenarios: Useful for production troubleshooting, post-mortems, and performance regression debugging.

Quick Start

Run a diagnostic workflow to surface the most recent exceptions and crash events from ClickHouse logs.

Frequently Asked Questions about altinity-expert-clickhouse-errors

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

FAQPage Schema
How do I diagnose ClickHouse errors from system.query_log?

Diagnose ClickHouse errors by querying system.query_log to identify failure patterns, responsible queries, and exception codes. You can correlate these errors with system.crash_log to pinpoint root causes and apply targeted remediations.

What is the best way to analyze ClickHouse crash logs and stack traces?

Analyzing ClickHouse crash logs involves examining system.crash_log for crash signals and stack traces. Correlating these crash events with system.text_log messages helps prioritize fixes and prevent recurrences in production deployments.

How do I investigate ClickHouse memory errors and query failures in production?

Investigate ClickHouse memory errors by surfacing recent exceptions and query failures from system.query_log. Deep dive into these logs to identify specific error patterns, enabling rapid fault diagnosis and operational post-mortems.

Can I use system.text_log to correlate ClickHouse exception codes with crash events?

Yes, use system.text_log to correlate ClickHouse exception codes and crash signals. Matching text_log messages with crash events allows you to prioritize fixes and prevent error recurrences across your deployment.

Why does ClickHouse query log analysis fail to surface actionable insights?

Query log analysis lacks actionable insights when exception codes and crash events are viewed in isolation. Correlating system.query_log failures with system.crash_log and system.text_log patterns surfaces deeper operational insights.