Primeros pasos con Managed ClickStack

Implementa Managed ClickStack en ClickHouse Cloud, envía un evento de prueba a través de tu pipeline de ingestión y confirma que el evento esté disponible en la UI de ClickStack. ClickHouse Cloud opera el backend de ClickHouse, mientras conservas el control sobre el pipeline de ingestión y el esquema. Managed ClickStack proporciona:

Escalado automático del cómputo, independiente del almacenamiento
Retención de bajo costo y prácticamente ilimitada basada en almacenamiento de objetos
Aislamiento independiente de las cargas de trabajo de lectura y escritura con warehouses
Autenticación integrada
Backups automatizados
Funciones de seguridad y cumplimiento normativo
Actualizaciones sin interrupciones

Antes de empezar

También puede enviar datos directamente a ClickHouse mediante una integración compatible y un esquema propio.

Crea un servicio de ClickHouse Cloud

Completa el paso Crear un servicio de ClickHouse de la guía de inicio rápido de ClickHouse Cloud. Antes de continuar, confirma que el servicio esté en ejecución.

Esta página muestra la ruta de OpenTelemetry. Use el selector situado en la parte superior de la guía para alternar entre OpenTelemetry (recomendado) y Vector.

Prepare su entorno de ingestión

Para iniciar un nuevo OpenTelemetry Collector, instale Docker. En Kubernetes, despliegue el collector con Helm.
Para usar un collector existente, ejecútelo como gateway y asegúrese de que su distribución incluya el exporter de ClickHouse. En esta guía añadirá la configuración necesaria.

Configurar Managed ClickStack

Elija una fuente de ingestión y configure el collector

Desde tu servicio de ClickHouse Cloud, inicia ClickStack. En la página Primeros pasos de ClickStack, selecciona Iniciar la ingestión.En la página Elegir una fuente de ingestión, selecciona OpenTelemetry.

OpenTelemetry recomendadoOpenTelemetry proporciona esquemas preconfigurados para registros, trazas, métricas y sesiones.

Iniciar un nuevo colector
Usar un colector existente

ClickStack genera el comando del colector con las credenciales de administrador default. Recomendamos usar credenciales de ingestión específicas para mantener el acceso de ingestión separado de las tareas de administración y evitar depender de la contraseña de administrador.

Crear credenciales específicas para la ingestión (recomendado)

En ClickHouse Cloud, abre la consola SQL de tu servicio y ejecuta:

CREATE USER `clickstack-ingest` IDENTIFIED WITH sha256_password BY '<password>';
GRANT SELECT, INSERT, CREATE DATABASE, CREATE TABLE, CREATE VIEW ON default.* TO `clickstack-ingest`;

En el comando generado, reemplaza CLICKHOUSE_USER="default" por CLICKHOUSE_USER="clickstack-ingest" y establece CLICKHOUSE_PASSWORD con la contraseña del usuario específico.

Para continuar con las credenciales de administrador default, copia el comando de la pestaña Iniciar colector. ClickStack rellena previamente el endpoint del servicio. Sustituye el marcador de posición de la contraseña por la contraseña de tu servicio. Si ya no la tienes, consulta o restablece tus datos de conexión.El comando tiene este formato:

docker run -e CLICKHOUSE_ENDPOINT="https://<host>:8443" \
    -e CLICKHOUSE_USER="default" \
    -e CLICKHOUSE_PASSWORD="<your_password_here>" \
    -p 4317:4317 -p 4318:4318 \
    clickhouse/clickstack-otel-collector:latest

Sustituye <host> y <your_password_here> por los valores de tu servicio de ClickHouse Cloud y ejecuta el comando.El colector se ejecuta en primer plano. Mantén esta terminal abierta y usa una segunda terminal para los comandos restantes de esta guía.

Este comando expone los puertos OTLP sin autenticación y está destinado a evaluaciones locales. Antes de enviar tráfico de producción, protege el colector.

Selecciona Configurar un colector existente y adapta la configuración de tu colector.Ejecuta el colector como puerta de enlace entre tus aplicaciones y ClickHouse Cloud. La siguiente configuración añade los exportadores de ClickHouse y los pipelines de señales necesarios.El ejemplo usa las credenciales default generadas por ClickStack. Para usar credenciales específicas para la ingestión, sigue la configuración opcional de la pestaña Iniciar un nuevo colector. En ambos bloques del exportador de ClickHouse, reemplaza username: default por username: clickstack-ingest y establece password con la contraseña del usuario específico.Integra los siguientes componentes en tu configuración existente en lugar de reemplazar receivers, procesadores, exportadores o extensiones no relacionados.

Componentes necesarios del colectorLa distribución de tu colector debe incluir el exportador de ClickHouse y el conector de enrutamiento. La distribución OpenTelemetry Collector Contrib incluye ambos componentes.

El ejemplo añade receivers OTLP, procesamiento por lotes, limitación de memoria, enrutamiento de Session Replay y exportadores de ClickHouse.Sustituya los marcadores de posición de endpoint y contraseña por las credenciales generadas por ClickStack:

receivers:
  otlp/hyperdx:
    protocols:
      grpc:
        include_metadata: true
        endpoint: "0.0.0.0:4317"
      http:
        cors:
          allowed_origins: ["*"]
          allowed_headers: ["*"]
        include_metadata: true
        endpoint: "0.0.0.0:4318"
processors:
  batch:
  memory_limiter:
    # 80% of maximum memory up to 2G, adjust for low memory environments
    limit_mib: 1500
    # 25% of limit up to 2G, adjust for low memory environments
    spike_limit_mib: 512
    check_interval: 5s
connectors:
  routing/logs:
    default_pipelines: [logs/out-default]
    error_mode: ignore
    table:
      - context: log
        statement: route() where IsMatch(attributes["rr-web.event"], ".*")
        pipelines: [logs/out-rrweb]
exporters:
  clickhouse/rrweb:
    database: default
    endpoint: <clickhouse_cloud_endpoint>
    password: <your_password_here>
    username: default
    ttl: 720h
    logs_table_name: hyperdx_sessions
    timeout: 5s
    retry_on_failure:
      enabled: true
      initial_interval: 5s
      max_interval: 30s
      max_elapsed_time: 300s
  clickhouse:
    database: default
    endpoint: <clickhouse_cloud_endpoint>
    password: <your_password_here>
    username: default
    ttl: 720h
    timeout: 5s
    retry_on_failure:
      enabled: true
      initial_interval: 5s
      max_interval: 30s
      max_elapsed_time: 300s

service:
  pipelines:
    traces:
      receivers: [otlp/hyperdx]
      processors: [memory_limiter, batch]
      exporters: [clickhouse]
    metrics:
      receivers: [otlp/hyperdx]
      processors: [memory_limiter, batch]
      exporters: [clickhouse]
    logs/in:
      receivers: [otlp/hyperdx]
      exporters: [routing/logs]
    logs/out-default:
      receivers: [routing/logs]
      processors: [memory_limiter, batch]
      exporters: [clickhouse]
    logs/out-rrweb:
      receivers: [routing/logs]
      processors: [memory_limiter, batch]
      exporters: [clickhouse/rrweb]

Reutiliza tu receiver OTLP existente y conserva su configuración de autenticación y TLS. Si tu configuración ya utiliza los ID de componentes o pipelines del ejemplo, intégralos o cámbiales el nombre en lugar de crear ID duplicados. Ejecutar dos receivers en los puertos 4317 y 4318 provoca un conflicto de puertos.Después de integrar la configuración, vuelve a cargar o reinicia el colector mediante tu proceso de implementación habitual.Para obtener más información sobre cómo configurar colectores de OpenTelemetry, consulta Ingestión con OpenTelemetry.

Enviar datos de prueba

Envía un registro de prueba con la marca de tiempo actual:

NOW_NANO="$(date +%s)000000000"

curl -i "http://localhost:4318/v1/logs" \
  -H "Content-Type: application/json" \
  --data-binary @- <<EOF
{
  "resourceLogs": [{
    "resource": {
      "attributes": [{
        "key": "service.name",
        "value": {"stringValue": "clickstack-docs-test"}
      }]
    },
    "scopeLogs": [{
      "scope": {"name": "clickstack-docs-test"},
      "logRecords": [{
        "timeUnixNano": "${NOW_NANO}",
        "severityText": "INFO",
        "body": {"stringValue": "ClickStack ingestion test"}
      }]
    }]
  }]
}
EOF

Si utiliza un collector existente, sustituya http://localhost:4318 por su endpoint HTTP de OTLP. Si el receiver requiere autenticación, añada el header necesario al comando curl.Una request correcta devuelve HTTP/1.1 200 OK.

Comience a explorar y confirme la ingestión

Cuando ClickStack detecte las fuentes de datos de OpenTelemetry, selecciona Empezar a explorar para abrir la vista de Búsqueda. Busca ClickStack ingestion test.El resultado debería incluir el evento de prueba con el nombre de servicio clickstack-docs-test.

Ahora tienes un servicio de Managed ClickStack, una ruta de ingestión operativa y un evento de prueba que puedes inspeccionar en ClickStack.

Próximos pasos

Si otra guía requiere el endpoint o la contraseña de ClickHouse Cloud, obtenga o restablezca los datos de conexión antes de continuar.

Envíe datos de aplicaciones y de infraestructura

Elija una guía según los datos que desee enviar a ClickStack:

Instrumente una aplicación

Envíe trazas y logs de aplicaciones con un SDK de OpenTelemetry compatible.

Recopile logs del host

Reenvíe logs del host desde un OpenTelemetry Collector que se ejecuta con el rol de agente.

Supervise Kubernetes

Recopile logs, métricas y trazas de un clúster de Kubernetes.

Explore otras integraciones

Encuentre guías para aplicaciones y fuentes de telemetría adicionales.

Explorar datos de muestra

Use un conjunto de datos de muestra para explorar ClickStack con telemetría más completa:

Logs, trazas y métricas de muestra

Cargue datos de la demo pública y diagnostique un issue. Esta guía presupone que inició un nuevo OpenTelemetry Collector local. Si configuró un collector existente, adapte el endpoint y la configuración de autenticación a su implementación.

Logs y métricas locales

Recopile archivos locales y métricas del sistema en macOS o Linux.

Generar datos sintéticos

Use un generador para probar la ingestión sin necesidad de contar con una aplicación o un conjunto de datos existentes:

Generar datos con otelgen

Envíe una breve ráfaga de logs, trazas y métricas sintéticos mediante OTLP.

Generar datos con telemetrygen

Genere señales de OpenTelemetry configurables en varios servicios.

Consulte todos los datos de ejemplo y demos de ClickStack.

Preparación para producción

Revise las recomendaciones de producción y dimensionamiento antes de utilizar ClickStack para cargas de trabajo continuas:

Pasar a producción

Revise las credenciales de ingestión, la seguridad, la retención y las recomendaciones operativas.

Estimar recursos

Dimensione la capacidad de cómputo según el volumen de ingestión previsto.

Para tareas de implementación, consulte la guía de implementación de Managed ClickStack.

Primeros pasos

Características

Administración de ClickStack

Guías

Socios de integración

Antes de empezar

Crea un servicio de ClickHouse Cloud

Prepare su entorno de ingestión

Configurar Managed ClickStack

Elija una fuente de ingestión y configure el collector

Enviar datos de prueba

Comience a explorar y confirme la ingestión

Próximos pasos

Envíe datos de aplicaciones y de infraestructura

Instrumente una aplicación

Recopile logs del host

Supervise Kubernetes

Explore otras integraciones

Explorar datos de muestra

Logs, trazas y métricas de muestra

Logs y métricas locales

Generar datos sintéticos

Generar datos con otelgen

Generar datos con telemetrygen

Preparación para producción

Pasar a producción

Estimar recursos

​Antes de empezar

​Crea un servicio de ClickHouse Cloud

​Prepare su entorno de ingestión

​Configurar Managed ClickStack

Elija una fuente de ingestión y configure el collector

Enviar datos de prueba

Comience a explorar y confirme la ingestión

​Próximos pasos

​Envíe datos de aplicaciones y de infraestructura

Instrumente una aplicación

Recopile logs del host

Supervise Kubernetes

Explore otras integraciones

​Explorar datos de muestra

Logs, trazas y métricas de muestra

Logs y métricas locales

​Generar datos sintéticos

Generar datos con otelgen

Generar datos con telemetrygen

​Preparación para producción

Pasar a producción

Estimar recursos

Antes de empezar

Crea un servicio de ClickHouse Cloud

Prepare su entorno de ingestión

Configurar Managed ClickStack

Próximos pasos

Envíe datos de aplicaciones y de infraestructura

Explorar datos de muestra

Generar datos sintéticos

Preparación para producción