Integrado en ClickHouse

Uso de ClickStack integrado en ClickHouse Server: la pila de observabilidad de 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 despliegue

Docker

1. ​

   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ña

   Si 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
   
2. ​

   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.

3. ​

   Crea una fuente

   Si ya tienes tablas de OpenTelemetry, ClickStack las detectará y creará las fuentes automáticamente.

   En una instalación nueva, 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 Source.

   Si todavía no tienes datos, consulta Ingesting data para ver las opciones disponibles.

Binary

1. ​

   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
   
2. ​

   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.

3. ​

   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 está listo para avanzar más allá de la evaluación, considere un despliegue preparado para producción:

• Todo en uno — 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 despliegues de Kubernetes en producción
• Managed ClickStack — totalmente gestionado en ClickHouse Cloud