HyperDX, la plataforma de observabilidad de código abierto que unifica logs, métricas, trazas, errores y grabaciones de sesión, se presenta ahora como ClickStack, la propuesta de observabilidad de ClickHouse. Mantiene la licencia MIT y el repositorio original en GitHub, que roza las 10.000 estrellas, y se puede levantar en un solo contenedor Docker que incluye la base de datos, la interfaz y un colector de OpenTelemetry.
Las claves de ClickStack, antes HyperDX, en 30 segundos
- HyperDX ha pasado a llamarse ClickStack y forma parte de la oferta de observabilidad de ClickHouse.
- Reúne logs, métricas, trazas, errores y session replay en una sola interfaz, con licencia MIT.
- La imagen todo en uno trae ClickHouse, la interfaz, el colector OpenTelemetry y MongoDB.
- Para pruebas se recomiendan 4 GB de RAM y 2 núcleos.
- Recoge datos de uso anónimos, desactivables con una variable de entorno.
El proyecto nació con una premisa que su documentación explica sin rodeos: las herramientas de observabilidad suelen ser caras cuando el volumen de telemetría llega a terabytes, exigen especialistas para montarlas y obligan a saltar de una aplicación a otra para reconstruir un incidente. Su respuesta es apoyarse en ClickHouse, una base de datos columnar muy rápida en agregaciones, y ofrecer encima una interfaz que la documentación compara con Kibana.
Qué ofrece para depurar producción
La idea central es correlacionar. Desde una traza lenta se puede saltar a los logs de esa petición y a la grabación de la sesión del usuario que la provocó, sin cambiar de herramienta. La búsqueda admite texto libre y una sintaxis por propiedades del tipo level:err, de modo que el SQL es opcional, aunque está disponible para quien lo prefiera.
Según el repositorio, ClickStack trabaja sobre el esquema de ClickHouse que ya exista, permite seguir en directo logs y trazas, crear alertas en pocos pasos, montar paneles con eventos de alta cardinalidad sin un lenguaje de consultas complejo y consultar JSON de forma nativa. También cubre monitorización de rendimiento de aplicaciones (APM), desde la petición HTTP hasta la consulta a base de datos, y una función de deltas de eventos para analizar anomalías.
Instalación con Docker y puertos necesarios
La forma más rápida de probarlo es la imagen todo en uno, que agrupa ClickHouse, la interfaz de ClickStack, el colector de OpenTelemetry y MongoDB:
docker run -p 8080:8080 -p 4317:4317 -p 4318:4318
docker.clickhouse.com/clickhouse/clickstack-all-in-oneDespués, la interfaz queda en http://localhost:8080. Los puertos 4317 y 4318 son los habituales de OpenTelemetry para gRPC y HTTP. Si el servidor está detrás de un cortafuegos, la documentación pide abrir el 8080 para la interfaz, el 8000 para la API y el 4318 para el colector. Para pruebas recomienda al menos 4 GB de RAM y 2 núcleos. Quien ya tenga un clúster de ClickHouse, o necesite un despliegue de producción, tiene otras opciones en la documentación de despliegue de ClickHouse, además de una versión gestionada en ClickHouse Cloud.
Para enviar datos hay SDK propios para navegador, Node.js y Python, y compatibilidad con cualquier SDK de OpenTelemetry: Kubernetes, JavaScript, Python, Java, Go, Ruby, PHP, .NET, Elixir o Rust, entre otros. Basta con apuntar el exportador al colector, en http://localhost:4318 en una instalación local.
CLI para la terminal y datos de uso
Para quien no quiera salir de la shell, el paquete @hyperdx/cli instala el comando hdx, con una interfaz de texto que permite buscar, seguir logs en directo y ver trazas en cascada con atajos de estilo vim. También dibuja paneles como salida ANSI y ofrece consultas SQL y salida NDJSON pensadas para scripts y agentes de IA:
npm install -g @hyperdx/cli
hdx auth login
hdx tuiLenguaje del código: CSS (css)Un detalle que conviene conocer antes de desplegar: las instalaciones de código abierto envían datos de uso anónimos. Se desactiva con la variable de entorno USAGE_STATS_ENABLED=false, algo recomendable en entornos con requisitos estrictos de privacidad o sin salida a internet. El proyecto, por otra parte, ha endurecido su política de contribuciones: un mantenedor debe avalar a cada nuevo colaborador antes de revisar su primera petición de cambios, para filtrar aportaciones generadas con IA sin comprensión detrás, según explica el propio repositorio.
Preguntas frecuentes
¿HyperDX y ClickStack son lo mismo?
Sí. El repositorio de HyperDX presenta ahora el producto como ClickStack, la solución de observabilidad de ClickHouse, y mantiene la licencia MIT.
¿Qué requisitos mínimos tiene?
Para pruebas, la documentación recomienda al menos 4 GB de RAM y 2 núcleos. En producción dependerá del volumen de telemetría y del dimensionado de ClickHouse.
¿Funciona con OpenTelemetry?
Sí. Incluye un colector de OpenTelemetry y acepta datos de cualquier SDK compatible a través de los puertos 4317 y 4318.
¿Envía datos a terceros?
Las instalaciones de código abierto envían datos de uso anónimos por defecto. Se desactivan con USAGE_STATS_ENABLED=false.
Fuentes:
