Ctrl K
ComunidadGuías…
GITHUB · ANALIZADO

chmonitor

chmonitor es un asesor operativo open-source para ClickHouse que combina monitorización en tiempo real con recomendaciones impulsadas por IA sobre índices, particiones y vistas materializadas.

Ficha actualizada 25 sept 2026, 7:50 · upstream 25 sept 2026, 7:49 · release v0.3.5

Ver códigoProblemas y ayudaRepositorio ↗Sitio oficial
00

Qué es chmonitor

Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.

chmonitor funciona como un panel de control integral para clusters ClickHouse, leyendo tablas system.* para mostrar el estado del clúster incluyendo consultas, fusiones, replicación, almacenamiento y salud. La herramienta no aplica cambios DDL automáticamente - todas las recomendaciones son sugerencias que el administrador debe evaluar antes de implementar.

El sistema soporta múltiples entornos de despliegue: Docker, Kubernetes (con Helm), bare metal, ClickHouse Cloud y plataformas como Railway/Render/Fly. Incluye una CLI llamada chm con TUI en terminal y comandos como `chm doctor` para diagnósticos rápidos. La versión actual es v0.3.0 bajo licencia GPL-3.0 gratuita para uso comunitario.

La plataforma incluye capacidades de análisis avanzado: explorador de datos, métricas de compresión, TTLs, cola de replicación, Keeper y más de 30 gráficos en tiempo real. También ofrece una edición Enterprise con licenciamiento por número de hosts ClickHouse.

CASOS DE USO
  • Monitorización en tiempo real de clusters ClickHouse con dashboards visuales
  • Detección automática de consultas costosas, lentas o fallidas históricas
  • Recomendaciones de IA para optimizar índices, proyecciones y vistas materializadas
  • Gestión de salud de réplicas, fusiones y mutaciones en clústeres distribuidos
  • Análisis de almacenamiento: tamaños de tablas, partes, compresión y TTLs
  • Integración con agentes AI vía MCP para Claude, Cursor y otras herramientas
PUNTOS DESTACADOS
  • Soporte multiplataforma: Docker, Kubernetes, bare metal y cloud nativo
  • Agent AI integrado con compatibilidad MCP para integración con LLMs externos
  • Dashboard unificado que soporta múltiples hosts ClickHouse desde una sola interfaz
  • CLI `chm` con TUI en terminal para operaciones rápidas sin navegador
  • Licencia GPL-3.0 gratuita para uso comunitario sin costes ocultos
PRECAUCIONES
  • No aplica cambios DDL automáticamente - requiere intervención manual del administrador
  • Requiere configuración de credenciales ClickHouse (host, usuario, contraseña) en cada despliegue
  • La versión Enterprise tiene funcionalidades adicionales detrás de gates de licencia
VISUAL

Capturas del proyecto

Imágenes reales detectadas en la documentación del repositorio.

Overview charts: query count, duration, and data written over timeCluster insights: findings, record-breaking queries, storage statsSQL console: read-only SQL with history and EXPLAINWatch the chmonitor v0.3 launch filmCluster topology: nodes, shards, replicas, and Keeper quorumAI agent: ask about schema, storage, queries, and healthchmonitor
01

Perfil de infraestructura

Estimación inicial derivada del repositorio y de los servicios detectados.

CPU4 vCPUrecomendación inicial
MEMORIA4 GBRAM estimada
DISCO40 GBalmacenamiento base
COMPLEJIDADhighnivel de operación
02

Despliegue detectado

Qué señales reales de instalación hemos encontrado.

Docker Compose detectado

Usar imagen con tag específico en producción (no :latest). Configurar CLICKHOUSE_HOST, CLICKHOUSE_USER y CLICKHOUSE_PASSWORD como variables de entorno. Soporta despliegue en Docker, Kubernetes con Helm, Cloudflare Workers o plataformas PaaS como Railway/Render/Fly mediante opciones one-click. Verificar compatibilidad con versiones ClickHouse OSS, Altinity o Cloud.

✓Dockerfile
✓Compose
—One-click
03

Stack y dependencias

Componentes inferidos a partir de manifests, configuración y documentación.

FRAMEWORKS
Next.jsNode.js
SERVICIOS
PostgreSQLClickHouse
BASES DE DATOS
PostgreSQLClickHouse
PUERTOS
30008123
05

Puede sustituir a

Relaciones detectadas por el análisis del repositorio y su categoría.

06

Experiencia real de la comunidad

Ayuda a contrastar la estimación automática con instalaciones reales.

Todavía no hay datos comunitarios para este proyecto.