chmonitorTroubleshooting
Diagnose and fix common chmonitor issues — connection failures, auth errors, performance problems, and Kubernetes probe failures.
Common issues and how to diagnose them, grouped by symptom. Expand the entry that matches what you're seeing.
Connection failures
Auth failures (401 / white screen)
Performance / timeouts
AI agent / LLM failures
Kubernetes / Helm health probes
Related
ClickHouse User & Grants
The least-privilege monitoring user and grants the dashboard needs.
Connection errors
Diagnose 'Test connection' failures kind by kind.
MCP Server — Permissions
Open and secure the MCP endpoint.
Authentication
Compare and configure chmonitor auth providers.
Upgrading ClickHouse
Upgrade safely while chmonitor stays connected.
Slack app
Install the native chmonitor Slack app — OAuth setup, the /chmonitor slash command (status, read-only query, alerts), a Home tab, and Acknowledge buttons on alert messages.
Upgrading ClickHouse
Safely upgrade ClickHouse when chmonitor is connected — pre-upgrade checks, version-by-version dashboard changes, and post-upgrade validation.