Saltar al contenido principal
Al igual que la imagen todo en uno, esta imagen de Docker completa agrupa todos los componentes de ClickStack:
  • ClickHouse
  • HyperDX
  • colector de OpenTelemetry (OTel) (expone OTLP en los puertos 4317 y 4318)
  • MongoDB (para el estado persistente de la aplicación)
Sin embargo, la autenticación de usuarios está deshabilitada para esta distribución de HyperDX

Adecuado para

  • Demos
  • Depuración
  • Desarrollo con HyperDX

Pasos de implementación


1

Implementar con Docker

El modo local implementa la UI de HyperDX en el puerto 8080.
docker run -p 8080:8080 clickhouse/clickstack-local:latest
2

Acceder a la UI de HyperDX

Visita http://localhost:8080 para acceder a la UI de HyperDX.No se solicitará crear un usuario, ya que la autenticación no está habilitada en este modo de implementación.Conéctate a tu propio clúster externo de ClickHouse, por ejemplo, ClickHouse Cloud.Crea una fuente, conserva todos los valores predeterminados y completa el campo Table con el valor otel_logs. El resto de la configuración debería detectarse automáticamente, lo que te permitirá hacer clic en Save New Source.

Elección del esquema: Map vs JSON

ClickStack almacena los atributos como columnas Map(LowCardinality(String), String) de forma predeterminada. Este es el esquema recomendado para las cargas de trabajo de observabilidad. En combinación con la serialización de mapas por buckets y los índices de texto sobre las claves y los valores del mapa, ofrece lookups selectivos sin la sobrecarga de ingesta por clave de las subcolumnas JSON dinámicas. También hay disponible, en fase beta, un esquema de tipo JSON para evaluarlo en cargas de trabajo con un conjunto pequeño y estable de claves de atributos. No se recomienda como opción predeterminada. Consulta Map vs tipo JSON para ver la comparación completa y las variables de entorno necesarias para habilitar la compatibilidad con JSON.
Última modificación el 10 de junio de 2026