CH-Ops
CHOps es una herramienta de administración y interfaz gráfica para la base de datos ClickHouse®. Permite el auto-alojamiento del servidor de ClickHouse® con facilidad.
Ficha actualizada 23 sept 2026, 13:08 · upstream 23 sept 2026, 12:53 · release v0.3.0
Qué es CH-Ops
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
CHOps funciona con clusters en hardware bare metal, VMs, Docker, Kubernetes bajo un operador, instancias de nube y servicios gestionados. Es una herramienta que convierte la tarea diaria de operar ClickHouse® en una interfaz web única. No se requiere instalar nada sobre los servidores de ClickHouse®, solo conectarse vía HTTP al endpoint del servidor.
El proyecto está diseñado para equipos de plataforma de datos, DBAs y ingenieros DevOps que heredan clusters de ClickHouse®. CHOps centraliza las tareas diarias como consultas lentas, detección de runaway queries, verificación de replicación, observación de merges, revisión de acceso, etc., en una sola interfaz gráfica.
La arquitectura es minimalista: CHOps solo necesita un endpoint HTTP accesible desde la red del cluster. No se requiere instalar nada adicional sobre los servidores de ClickHouse®. Esto permite que cualquier equipo con conocimientos básicos de Linux y redes pueda operar el sistema sin depender de especialistas.
El proyecto está construido en Bun, una runtime JavaScript moderna, con un frontend React y un backend Express. Se compila a un único binario autocontenido sin dependencias de tiempo de ejecución.
- Monitorizar consultas lentas y detenerlas automáticamente
- Seguir el estado del cluster en tiempo real (replicación, merges, partes)
- Auditoría de acceso y gestión de permisos
- Exportar resultados a múltiples formatos (CSV, JSON, Parquet, ORC)
- Generar dashboards personalizados con filtros dinámicos
- Alertas automáticas basadas en métricas definidas por el usuario
- Gestión de usuarios y roles sin necesidad de scripts de CLI
- Visualización de índices y estructuras de datos del cluster
- Interfaz web única que centraliza la operación del cluster sin necesidad de conocimientos avanzados de SQL o comandos de CLI
- No requiere instalación adicional sobre los servidores de ClickHouse®, solo conexión HTTP al endpoint
- Soporte para clusters bajo Kubernetes con operadores oficiales (Altinity, OCKO) y no operativos
- Base de datos SQLite local que guarda configuración sin tocar el esquema o datos del cluster
- Editor SQL completo con autocompletado, tabulación, estimación de costo y exportación a 22 formatos
- Motor de IA (Qurioz) para generar consultas SQL desde preguntas en lenguaje natural
- Diseño modular que permite extender la funcionalidad sin modificar el núcleo del proyecto
- No soporta clusters con múltiples instancias de ClickHouse® separadas por nodos distintos (solo funciona con un único nodo)
- La interfaz web no es nativa para Linux ni Windows, solo para macOS y Unix
- El editor SQL tiene límites de longitud de consulta y de ancho de pantalla
- No incluye herramientas de backup en la nube como AWS RDS o Azure SQL Database
- Depende de un endpoint HTTP externo accesible desde la red del cluster
- La versión actual no soporta bases de datos distribuidas (Distributed ClickHouse®)
- El almacenamiento de consultas exportadas se realiza en segundo plano y puede consumir recursos del sistema
Capturas del proyecto
Imágenes reales detectadas en la documentación del repositorio.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Recomendación: usar Docker para despliegue, ya que simplifica la gestión de dependencias y permite actualizar sin reiniciar el servidor de ClickHouse®,Configurar el entorno: crear un archivo .env con variables como SUPER_ADMIN_1_PASSWORD, ENCRYPTION_SECRET (32+ caracteres), y SMTP_* si se desea activar alertas por correo,Para Kubernetes: usar el operador oficial de ClickHouse® (OCKO) o Altinity Operator para gestionar la infraestructura, y CHOps solo necesita conectar al endpoint HTTP del cluster,El volumen 'chops-data' persiste los datos de configuración entre actualizaciones,No se recomienda actualizar manualmente el binario: usar siempre las imágenes oficiales desde GitHub Container Registry (ghcr.io/quantrail-data/ch-ops),Para producción, implementar un sistema de autenticación robusto y monitorizar la salud del endpoint HTTP del cluster
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
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.