From 78da1dd12a37427a28ffd56eb138791c55359fc8 Mon Sep 17 00:00:00 2001 From: Doneyli De Jesus Date: Mon, 8 Jun 2026 00:00:31 -0400 Subject: [PATCH 1/2] =?UTF-8?q?Fix=20path=20parameter=20name:=20serviceId?= =?UTF-8?q?=20=E2=86=92=20postgresId=20in=20SKILL.md?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Every other file in the skill (and the May 2026 spec snapshot) uses `postgresId`. SKILL.md was the sole outlier. Co-Authored-By: Claude Opus 4.6 (1M context) --- skills/clickhouse-managed-postgres-rca/SKILL.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/skills/clickhouse-managed-postgres-rca/SKILL.md b/skills/clickhouse-managed-postgres-rca/SKILL.md index 9f43e82..a8d8678 100644 --- a/skills/clickhouse-managed-postgres-rca/SKILL.md +++ b/skills/clickhouse-managed-postgres-rca/SKILL.md @@ -27,7 +27,7 @@ using a ClickHouse Cloud API key/secret pair): under the Postgres tag. Returns per-digest latency, IO, and call statistics for normalized query patterns. **Beta.** -Both endpoints require an `organizationId` and a `serviceId` as +Both endpoints require an `organizationId` and a `postgresId` as path parameters. The user must supply both, plus the API key/secret pair. From bc52026902ec054395d50c37444917f378cb3dfd Mon Sep 17 00:00:00 2001 From: Doneyli De Jesus Date: Mon, 8 Jun 2026 00:07:21 -0400 Subject: [PATCH 2/2] Add clickhouse-managed-postgres-rca to README Co-Authored-By: Claude Opus 4.6 (1M context) --- README.md | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/README.md b/README.md index dd14b7a..6fe6efe 100644 --- a/README.md +++ b/README.md @@ -83,6 +83,24 @@ Complements `clickhouse-best-practices` by answering *when*, *why*, and *how* **For agents:** The skill activates when users report errors, unexpected behavior, or configuration questions involving the ClickHouse Node.js client — including vague symptoms like "my inserts keep failing" or "connection drops randomly" in a Node.js context. Not used for browser/Web client issues. +### ClickHouse Managed Postgres RCA + +**Evidence-based root-cause analysis** for ClickHouse-managed Postgres instances. Scrapes the Prometheus endpoint for system signal, pulls per-digest evidence from the Slow Query Patterns API, triages against a heuristic library, and produces a structured recommendation. Recommend-only — never executes DDL or kills queries. + +| Heuristic | Detects | +|-----------|---------| +| Full scan | Missing or unused index via blocks-touched-per-row ratio | +| Hot loop (N+1) | Application-side tight loop via high call count with low per-call latency | +| Write congestion | Deadlocks, slow writes, high rollback rate via WAL and Prom counters | + +Both APIs are Beta. The skill resolves paths and field names from the live OpenAPI spec on first use, so it stays correct as the surface evolves. + +**Location:** [`skills/clickhouse-managed-postgres-rca/`](./skills/clickhouse-managed-postgres-rca/) + +**For humans:** Read [SKILL.md](./skills/clickhouse-managed-postgres-rca/SKILL.md) for an overview, or [AGENTS.md](./skills/clickhouse-managed-postgres-rca/AGENTS.md) for the compiled guide. + +**For agents:** The skill activates when users report slowness, high CPU, low throughput, cache thrash, or any unexplained performance issue on a ClickHouse-managed Postgres instance. + ### chdb DataStore **Pandas-compatible API** for chdb — drop-in pandas replacement backed by ClickHouse. Write `import chdb.datastore as pd` and use the same pandas API, 10-100x faster. Supports 16+ data sources (MySQL, PostgreSQL, S3, MongoDB, Iceberg, Delta Lake, etc.) with cross-source joins.