clickhouse

Query OpenTelemetry logs, traces, and metrics in ClickHouse to investigate incidents.

12|2|Updated May 19, 2026
One-click install
npx skills add https://github.com/har-ki/claude-code-sre-handbook --skill clickhouse-har-ki
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clickhouse
Source: https://github.com/har-ki/claude-code-sre-handbook/tree/main/skills/clickhouse
Command: npx skills add https://github.com/har-ki/claude-code-sre-handbook --skill clickhouse-har-ki

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps SREs investigate incidents by querying OpenTelemetry logs, traces, and metrics stored in ClickHouse to quickly identify likely root causes.

Core Features & Use Cases

  • Focused OTel querying: Queries only the supported OTel tables (otel_logs, otel_traces, and otel_metrics_*), with correct column handling for timestamps and service identity.
  • Incident workflow across signals: Runs a scoped-to-triage-drill-measure-correlate analysis path, and exits early as soon as a root cause is identified.
  • Evidence-driven conclusions: Produces a conclusion that references specific query outputs (error patterns, exception stack traces, latency percentiles, and correlated logs/traces/metrics).

Quick Start

Use the clickhouse skill to investigate a production incident by querying recent OTel logs, traces, and metrics for the affected services and summarizing the root cause with evidence.

Frequently Asked Questions about clickhouse

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

FAQPage Schema
How do I investigate production incidents using OpenTelemetry data stored in ClickHouse?

To investigate incidents using OpenTelemetry data in ClickHouse, query the otel_logs, otel_traces, and otel_metrics tables to analyze error patterns, latency percentiles, and exception details for affected services within a bounded time window.

How does cross-signal correlation work for SRE incident troubleshooting with logs, traces, and metrics?

Cross-signal correlation for SRE incident troubleshooting works by querying OTel logs, traces, and metrics together to identify correlated error patterns and latency spikes, running a scoped-to-triage-drill-measure-correlate analysis path to pinpoint root causes.

Do I need read-only access to query OpenTelemetry logs and traces in ClickHouse?

Yes, you need ClickHouse read-only access to query OpenTelemetry logs and traces. The investigation requires strict table and column usage, including correct handling for timestamps and service names, with bounded queries using LIMIT and time filters.

What is the best way to identify root causes from OTel observability data during an on-call incident?

The best way to identify root causes from OTel observability data is to use an early-exit workflow that stops after evidence is sufficient, producing conclusions that reference specific query outputs like exception stack traces and correlated metrics.

Can I query latency percentiles and exception stack traces for specific services in ClickHouse?

Yes, you can query latency percentiles and exception stack traces for specific services in ClickHouse by targeting the supported OTel tables with bounded time filters, analyzing cross-signal correlations to measure service performance during incidents.