Skip to content

Fix path parameter name: serviceId → postgresId in managed-postgres-rca SKILL.md #39

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
doneyli wants to merge 2 commits into
base: main
Choose a base branch
from
+19 −1
Open

Fix path parameter name: serviceId → postgresId in managed-postgres-rca SKILL.md #39

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
78da1dd
Fix path parameter name: serviceId → postgresId in SKILL.md
doneyli Jun 8, 2026
bc52026
Add clickhouse-managed-postgres-rca to README
doneyli Jun 8, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 18 additions & 0 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down
2 changes: 1 addition & 1 deletion skills/clickhouse-managed-postgres-rca/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
Comment thread
doneyli marked this conversation as resolved.
path parameters. The user must supply both, plus the API
key/secret pair.

Expand Down