Integrado en ClickHouse

ClickStack viene integrado directamente en el binario del servidor de ClickHouse. Esto significa que puedes acceder a la UI de ClickStack (HyperDX) desde tu instancia de ClickHouse sin desplegar ningún componente adicional. Esta implementación es similar a la demo pública en play-clickstack.clickhouse.com, pero se ejecuta con tu propia instancia de ClickHouse y tus propios datos.

Ideal para

Probar ClickStack con una configuración mínima
Explorar tus datos de ClickHouse con una UI de observabilidad
Demos y evaluaciones

Limitaciones

Esta versión integrada no está diseñada para su uso en producción. En comparación con las implementaciones OSS listas para producción, no están disponibles las siguientes funcionalidades:

Alertas
Persistencia de dashboards y búsquedas: los dashboards y las búsquedas guardadas no se conservan entre sesiones
Parámetros de consulta personalizables
Patrones de eventos

Pasos de implementación

Docker
Binary

Inicia ClickHouse

Descarga y ejecuta la imagen del servidor de ClickHouse con una contraseña definida:

docker run --rm -it -p 8123:8123 -e CLICKHOUSE_PASSWORD=password clickhouse/clickhouse-server:head-alpine

Ejecución sin contraseñaSi prefieres ejecutarlo sin contraseña, debes habilitar explícitamente la gestión de acceso predeterminada:

docker run --rm -it -p 8123:8123 -e CLICKHOUSE_DEFAULT_ACCESS_MANAGEMENT=1 clickhouse/clickhouse-server:head-alpine

Abre la UI de ClickStack

Abre http://localhost:8123 en tu navegador y haz clic en ClickStack.Introduce el nombre de usuario default y la contraseña password para conectarte a la instancia local.

Crea una fuente

Si ya tienes tablas de OpenTelemetry, ClickStack las detectará y creará las fuentes automáticamente.En una instalación limpia, se te pedirá que crees una fuente. Completa el campo Table con el nombre de tabla adecuado (por ejemplo, otel_logs) y haz clic en Save New fuente.Si todavía no tienes datos, consulta Ingesting data para ver las opciones disponibles.

Inicia ClickHouse

Descarga e inicia ClickHouse:

curl https://clickhouse.com/ | sh

Opcional: habilitar las tablas de logs del sistema

Para explorar los propios logs y métricas internas de ClickHouse, crea un fragmento de configuración en tu directorio de trabajo antes de iniciar el servidor:

mkdir -p config.d && cat > config.d/query_logs.xml << 'EOF'
<clickhouse>
    <query_log>
        <database>system</database>
        <table>query_log</table>
    </query_log>
    <query_thread_log>
        <database>system</database>
        <table>query_thread_log</table>
    </query_thread_log>
    <query_views_log>
        <database>system</database>
        <table>query_views_log</table>
    </query_views_log>
    <metric_log>
        <database>system</database>
        <table>metric_log</table>
    </metric_log>
    <asynchronous_metric_log>
        <database>system</database>
        <table>asynchronous_metric_log</table>
    </asynchronous_metric_log>
</clickhouse>
EOF

Con esto habilitado, puedes crear una fuente de logs que apunte a system.query_log después de abrir ClickStack:

Configuración	Valor
Nombre	`Query Logs`
Base de datos	`system`
Tabla	`query_log`
Columna de marca temporal	`event_time`
Selección predeterminada	`event_time, query_kind, query, databases, tables, initial_user, projections, memory_usage, written_rows, read_rows, query_duration_ms`

Inicia el servidor:

./clickhouse server

Abre la UI de ClickStack

Abre http://localhost:8123 en tu navegador y haz clic en ClickStack. La conexión con la instancia local se crea automáticamente.

Crea una fuente

Si ya tienes tablas de OpenTelemetry, ClickStack las detectará y creará las fuentes automáticamente.Si todavía no tienes datos, consulta Ingesting data para ver las opciones disponibles.

Siguientes pasos

Si ya está listo para pasar de la evaluación, considere una implementación preparada para producción:

All-in-One — un único contenedor con todos los componentes, incluida la persistencia y la autenticación
Docker Compose — componentes individuales para un mayor control
Helm — recomendado para implementaciones de Kubernetes en producción
Managed ClickStack — totalmente gestionado en ClickHouse Cloud

Características

Guías

Ideal para

Limitaciones

Pasos de implementación

Siguientes pasos

​Ideal para

​Limitaciones

​Pasos de implementación

​Siguientes pasos

Ideal para

Limitaciones

Pasos de implementación

Siguientes pasos