Saltar al contenido principal
Todos los datos se ingieren en ClickStack Open Source o Managed ClickStack a través de un OpenTelemetry (OTel) collector. Este actúa como el punto de entrada principal para logs, métricas, traces y datos de sesión. La diferencia clave entre ambas arquitecturas está en dónde se alojan los componentes. En ambos casos, ejecutas un OpenTelemetry Collector para recibir los datos de telemetría de tus aplicaciones. Con ClickStack Open Source, además administras y alojas tú mismo tanto ClickHouse como la UI de ClickStack (HyperDX). Con Managed ClickStack, ClickHouse y la UI de HyperDX se alojan y administran en ClickHouse Cloud, con autenticación integrada y la gestión operativa a cargo de ClickHouse Cloud.
En ambos modelos de despliegue, el collector expone dos endpoints OTLP:
  • HTTP - puerto 4318
  • gRPC - puerto 4317
Puedes enviar datos a estos endpoints directamente desde los SDK de lenguaje o desde agentes de recopilación de datos compatibles con OTel, por ejemplo, otros OTel collectors que recopilan métricas y logs de infraestructura. Más concretamente:
  • Los SDK de lenguaje se encargan de recopilar telemetría desde dentro de tu aplicación — especialmente traces y logs — y exportar estos datos al OpenTelemetry collector, a través del endpoint OTLP, que gestiona la ingestión en ClickHouse. Para más información sobre los SDK de lenguaje disponibles con ClickStack, consulta SDKs.
  • Los agentes de recopilación de datos son agentes desplegados en el edge — en servidores, nodos de Kubernetes o junto a las aplicaciones. Recopilan telemetría de infraestructura (p. ej., logs, métricas) o reciben eventos directamente de aplicaciones instrumentadas con SDKs. En este caso, el agente se ejecuta en el mismo host que la aplicación, a menudo como sidecar o como conjunto de daemon. Estos agentes reenvían los datos al OTel collector central de ClickStack, que actúa como gateway, normalmente desplegado una vez por cluster, centro de datos o región. El gateway recibe eventos OTLP de agentes o aplicaciones y gestiona la ingestión en ClickHouse. Consulta OTel collector para más información. Estos agentes pueden ser otras instancias del OTel collector u otras tecnologías, como Fluentd o Vector.
Compatibilidad con OpenTelemetryAunque ClickStack ofrece sus propios SDK de lenguaje y una implementación personalizada de OpenTelemetry, con telemetría y funciones mejoradas, también puedes usar sin problemas tus SDK y agentes de OpenTelemetry existentes.
Última modificación el 10 de junio de 2026