Skip to main content
En resumenEsta guía muestra cómo enviar telemetría a ClickStack desde OpenTelemetry Collectors gestionados por Telflo. Aprenderá a:
  • Crear una configuración de collector en el editor visual de Telflo o mediante la CLI
  • Enviar la telemetría a ClickStack de código abierto o a Managed ClickStack, o escribirla directamente en ClickHouse
  • Desplegar configuraciones de forma remota en una flota de collectors
  • Comprobar que la telemetría llega a ClickStack o a sus tablas de ClickHouse
Tiempo necesario: 15-20 minutos

​
¿Qué es Telflo?

Telflo es un control plane neutral respecto al proveedor para OpenTelemetry Collectors, que ofrece gestión centralizada de la configuración de los collectors en toda una flota. Facilita la gestión de flotas grandes gracias a un editor visual, pruebas de canalizaciones y el despliegue remoto de configuraciones. Telflo gestiona builds estándar upstream del collector de OpenTelemetry, sin ninguna distribución específica de Telflo ni agente propietario, de modo que los collectors que tus equipos ya ejecutan siguen usando el mismo build. Telflo también es accesible fuera del navegador, mediante una interfaz de línea de comandos. Combina eso con el MCP server de ClickStack y el mismo agente que consulta tu telemetría podrá corregir la canalización que la generó.

​
¿Por qué Telflo + ClickStack?

ClickStack se encarga de la ingestión, el almacenamiento y las consultas analíticas a gran volumen. Telflo opera de forma centralizada la flota de OpenTelemetry Collectors que lo alimenta, en hosts, clústeres y regiones. Telflo ofrece:
  • Gestión centralizada de OpenTelemetry Collectors en hosts, contenedores y Kubernetes
  • Edición visual de pipelines, con despliegues controlados a toda la flota o a un solo grupo
  • Validación de los cambios contra telemetría de muestra antes de que lleguen a los collectors de producción
  • Enrutamiento de la misma telemetría a ClickStack y a otros destinos de forma simultánea
  • Visibilidad de la flota: qué collectors están en línea, qué ejecuta cada uno y cuáles se han desviado de su configuración
Puntos clave
  • ClickStack ingesta, almacena y consulta a escala
  • Telflo opera la flota de collectors que lo alimenta

​
Prerequisitos

​
Integrar ClickStack con Telflo

1

Crear una configuración del collector

  1. Inicie sesión en Telflo. En la lista Configurations, haga clic en New Configuration y luego en Blank configuration.
  2. En Name Your Configuration, introduzca un nombre y haga clic en Create.
  3. Añada receivers: arrastre uno desde la paleta al lienzo por cada tipo de telemetría que recopile.
  4. Añada processors: Memory Limiter y Batch, además de los que necesite para dar forma a los datos antes de que salgan del collector. Consulte la lista completa de processors compatibles con Telflo.
2

Agregue el exporter

Las tres rutas usan el mismo editor, el mismo paso de publicación y la misma flota; solo cambia el exportador. Elija la pestaña correspondiente a su despliegue: Open Source ClickStack recibe OTLP con una clave de ingestión; Managed ClickStack y ClickHouse autogestionado reciben escrituras directas en las tablas de ClickStack.
  1. Arrastre el exporter OTLP/HTTP al lienzo.
  2. Establezca Endpoint con el endpoint OTLP HTTP de su ClickStack, por ejemplo http://clickstack.example.com:4318.
  3. En HTTP Headers, haga clic en Add header e introduzca authorization como Header name y ${env:CLICKSTACK_INGESTION_KEY} como Header value. Telflo solicita el valor durante la instalación de los collectors, de modo que la clave nunca queda almacenada en la configuración.
Para gRPC, utilice el exporter OTLP en el puerto 4317 con el mismo header en gRPC Metadata Headers.
Trace aristas desde los receivers, pasando por los processors, hasta el exporter: un pipeline por cada señal. La fila de status indica config valid o el número de errores por corregir, y la pestaña YAML muestra la configuración generada.Antes de desplegar nada, puede pasar telemetría de muestra por la configuración y comprobar qué sale por el otro extremo. Consulte pruebas en Telflo. Como alternativa, puede describir lo que quiere hacer y el asistente de IA de Telflo, que se abre con el botón AI de la barra de herramientas, creará, validará y probará la configuración por usted. Su propio agente puede hacer lo mismo mediante la CLI de Telflo.
3

Publicar una versión

Haga clic en Publish en la barra de herramientas. Las versiones publicadas son de solo lectura; para seguir iterando, haga clic en Create New Version.
4

Crear una flota e implementarla

  1. Vaya a Fleet, haga clic en New Fleet y elija dónde se ejecutan sus collectors: en VMs o en Kubernetes. Introduzca un Name y haga clic en Create fleet.
  2. En la pestaña Deploy Groups de la fleet, haga clic en Assign en el grupo Default y elija la configuración y la versión publicadas.
  3. Haga clic en Install en el grupo e introduzca un valor para cada environment variable a la que haga referencia su configuración; Telflo las añade al comando de instalación. Ejecute ese comando allí donde deban ejecutarse los collectors, siguiendo las instrucciones de instalación de Telflo. El comando incluye el token de instalación de la fleet junto con su valor, por lo que debe tratarse como información sensible.
  4. En la pestaña Collectors, los collectors indican Pending pickup, luego Applying y finalmente In sync.
Para desplegar un cambio, publique una nueva versión y asígnela al grupo; para revertirlo, asigne una versión desplegada anteriormente.
5

Verificar la telemetría

Abra HyperDX y busque uno de sus servicios en la vista Search; utilice Chart Explorer para las métricas. Con Managed ClickStack, abra su servicio en la consola de ClickHouse Cloud y haga clic en Launch ClickStack. Con ClickHouse autogestionado, consulte directamente las tablas de ClickStack; por ejemplo, SELECT ServiceName, count() FROM otel_logs GROUP BY ServiceName.

​
Configuración avanzada

​
Fan-out routing

Los mismos datos de telemetría pueden enviarse a la vez a ClickStack para su almacenamiento a largo plazo, a otra plataforma durante una migración y a un SIEM para el análisis de seguridad. Añada los exporters en el lienzo y conéctelos a las canalizaciones que deban alimentarlos, o parta de una canalización predefinida de la biblioteca de flujos de Telflo.

​
Compresión y rendimiento

  • Exporters OTLP/HTTP y OTLP: mantén Compression en gzip.
  • ClickHouse exporter: mantén Async Insert activado, deja Compression en lz4 y añade un processor Batch antes en la canalización. Consulta Optimizar los inserts.

​
Próximos pasos

  • Crear dashboards: cree visualizaciones en HyperDX para logs, métricas y trazas
  • Configurar alertas: defina alertas en ClickStack para condiciones críticas
  • Refinar con el asistente de IA: pídale que ajuste una canalización o que proponga pruebas
  • Si viene de otro proveedor: los flows se encargan de la conmutación, sustituyen los agentes ya instalados en su flota y envían los datos simultáneamente a ambos backends mientras usted los compara

​
Más información

Última modificación el 26 de septiembre de 2026