clickhouse-managed-postgres-rca

Diagnose ClickHouse-managed Postgres performance issues using Prometheus metrics and Slow Query Patterns API evidence.

512|33|Updated Jan 15, 2026
One-click install
npx skills add https://github.com/ClickHouse/agent-skills --skill clickhouse-managed-postgres-rca
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clickhouse-managed-postgres-rca
Source: https://github.com/ClickHouse/agent-skills/tree/main/skills/clickhouse-managed-postgres-rca
Command: npx skills add https://github.com/ClickHouse/agent-skills --skill clickhouse-managed-postgres-rca

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This RCA workflow guides an agent to diagnose performance issues on a ClickHouse-managed Postgres instance by correlating Prometheus metrics with per-digest evidence from the Slow Query Patterns API, and to produce a safe, recommend-only RCA report.

Core Features & Use Cases

  • Collect Prometheus metrics for system signals to establish workload context.
  • Retrieve per-pattern latency, IO and error evidence from Slow Query Patterns API to identify dominant patterns.
  • Triages signals via a compact heuristic library (full-scan, hot-loop, write-congestion) and generate structured, actionable recommendations that do not mutate the target instance.
  • OpenAPI-driven discovery builds a role map to adapt to evolving API shapes.

Quick Start

Trigger the RCA workflow to fetch Prometheus metrics, retrieve slow-query patterns, and produce a structured, recommendation-only RCA report.

Frequently Asked Questions about clickhouse-managed-postgres-rca

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

FAQPage Schema
How do I diagnose slow queries on managed Postgres using Prometheus metrics?

Diagnose slow queries on managed Postgres by collecting Prometheus metrics to establish workload context and retrieving per-pattern latency evidence from the Slow Query Patterns API to identify dominant bottlenecks.

What is evidence-based root cause analysis for managed Postgres performance issues?

Evidence-based root cause analysis for managed Postgres correlates system signals from Prometheus with per-digest evidence from the Slow Query Patterns API to triage issues and output a structured, recommend-only action plan.

How do I triage full-scan and hot-loop slow query patterns in Postgres?

Triage full-scan, hot-loop, and write-congestion slow query patterns in Postgres by applying a compact heuristic library that correlates Prometheus system signals with API-retrieved per-pattern evidence to generate actionable recommendations.

Can I use OpenAPI discovery to resolve endpoints for Postgres slow query analysis?

Yes, OpenAPI-driven discovery resolves endpoints for Postgres slow query analysis by dynamically building a role map that adapts to evolving API shapes to successfully retrieve per-pattern evidence.

Does managed Postgres root cause analysis require mutating the target instance?

No, managed Postgres root cause analysis produces a safe, recommend-only RCA report that explicitly avoids mutating the target instance during the diagnostic triage and recommendation workflow.