En résuméCe guide explique comment envoyer des données de télémétrie vers ClickStack depuis des OpenTelemetry Collectors gérés par Telflo. Vous apprendrez à :
- créer une configuration de collector dans l’éditeur visuel de Telflo ou via la CLI
- envoyer les données de télémétrie vers ClickStack en version open source ou Managed ClickStack, ou les écrire directement dans ClickHouse
- déployer à distance des configurations sur une flotte de collectors
- vérifier que les données de télémétrie arrivent bien dans ClickStack ou dans vos tables ClickHouse
Qu’est-ce que Telflo ?
Telflo est un control plane indépendant de tout fournisseur pour les OpenTelemetry Collectors, qui offre une gestion centralisée de la configuration des collectors à l’échelle d’un parc. Il rend les grands parcs gérables grâce à un éditeur visuel, des tests de pipeline et le déploiement à distance des configurations. Telflo gère les builds standard du collector OpenTelemetry upstream, sans distribution spécifique à Telflo ni agent propriétaire : les collectors que vos équipes exploitent déjà conservent donc le même build. Telflo est également accessible en dehors du navigateur, via une interface en ligne de commande. Associez-la au serveur MCP ClickStack et l’agent qui interroge votre télémétrie pourra corriger le pipeline qui l’a produite.Pourquoi Telflo + ClickStack ?
ClickStack prend en charge l’ingestion, le stockage et les requêtes analytiques à grand volume. Telflo exploite de façon centralisée le parc d’OpenTelemetry Collectors qui l’alimente, sur l’ensemble des hôtes, des clusters et des régions. Telflo offre :- La gestion centralisée des OpenTelemetry Collectors sur les hôtes, les conteneurs et Kubernetes
- L’édition visuelle des pipelines, avec des déploiements contrôlés vers l’ensemble du parc ou vers un seul groupe
- La vérification des modifications sur un échantillon de télémétrie avant qu’elles n’atteignent les collectors de production
- Le routage simultané de la même télémétrie vers ClickStack et vers d’autres destinations
- La visibilité sur le parc : quels collectors sont en ligne, ce que chacun exécute et lesquels ont dérivé
Prérequis
- Une destination : Open Source ClickStack, Managed ClickStack ou une instance ClickHouse self-managed
- Un compte Telflo (créez un compte sur telflo.com)
- Un environnement où exécuter les collectors : une VM ou un cluster Kubernetes
- Open Source ClickStack : votre endpoint OTLP ClickStack (
4318pour HTTP,4317pour gRPC) et votre ingestion API key, disponible dans HyperDX sous Team Settings → API Keys (consultez la documentation pour référence) - Managed ClickStack : le point de terminaison de votre ClickHouse Cloud service (port
8443) et un utilisateur d’ingestion (voir Création d’un utilisateur d’ingestion) - Self-managed ClickHouse : votre endpoint ClickHouse, une database pour les tables ClickStack et un utilisateur habilité à les créer et à y écrire (voir Création d’un utilisateur d’ingestion)
- Une connectivité réseau entre les collectors et votre endpoint ClickStack ou ClickHouse
Intégrer ClickStack à Telflo
1
Créez une configuration du collecteur
- Connectez-vous à Telflo. Dans la liste Configurations, cliquez sur New Configuration, puis sur Blank configuration.
- Dans Name Your Configuration, saisissez un nom et cliquez sur Create.
- Ajoutez des receivers : faites glisser un élément de la palette vers le canevas pour chaque type de telemetry que vous collectez.
- Ajoutez des processors : Memory Limiter et Batch, ainsi que tous ceux dont vous avez besoin pour mettre en forme les données avant qu’elles ne quittent le collector. Consultez la liste complète des processors pris en charge par Telflo.
2
Ajoutez l’exportateur
Les trois approches utilisent le même éditeur, la même étape de publication et la même flotte ; seul l’exporter diffère. Choisissez l’onglet correspondant à votre déploiement : Open Source ClickStack accepte OTLP avec une clé d’ingestion ; Managed ClickStack et ClickHouse self-managed acceptent des écritures directes dans les tables ClickStack.Tracez les edges depuis les receivers, en passant par les processors, jusqu’à l’exporter, à raison d’un pipeline par signal. La row status indique config valid ou le nombre d’errors à corriger, et le tab YAML affiche la configuration générée.Avant tout déploiement, vous pouvez faire passer un échantillon de telemetry dans la configuration et vérifier ce qui en ressort. Consultez les tests dans Telflo. Vous pouvez également décrire ce que vous cherchez à faire : l’AI assistant de Telflo, ouvert à l’aide du bouton AI de la barre d’outils, construit, valide et teste la configuration à votre place. Votre propre agent peut faire de même via la CLI Telflo.
- Open Source ClickStack
- Managed ClickStack
- Self-managed ClickHouse
- Faites glisser l’exporter OTLP/HTTP sur le canevas.
- Définissez Endpoint sur le point de terminaison OTLP HTTP de votre ClickStack, par exemple
http://clickstack.example.com:4318. - Sous HTTP Headers, cliquez sur Add header, puis saisissez
authorizationcomme Header name et${env:CLICKSTACK_INGESTION_KEY}comme Header value. Telflo demande cette valeur lors de l’installation des collectors : la clé n’est ainsi jamais stockée dans la configuration.
4317 avec le même header sous gRPC Metadata Headers.3
Publier une version
Cliquez sur Publish dans la barre d’outils. Les versions publiées sont en lecture seule ; pour continuer à itérer, cliquez sur Create New Version.
4
Créez un parc et déployez-le
- Rendez-vous dans Fleet, cliquez sur New Fleet, puis indiquez où s’exécutent vos collectors : sur des VM ou dans Kubernetes. Saisissez un Name et cliquez sur Create fleet.
- Dans l’onglet Deploy Groups de la fleet, cliquez sur Assign pour le groupe Default, puis choisissez votre configuration publiée et sa version.
- Cliquez sur Install au niveau du groupe et saisissez une valeur pour chaque environment variable référencée par votre configuration ; Telflo les ajoute à la commande d’installation. Exécutez cette commande là où les collectors doivent tourner, en suivant les instructions d’installation de Telflo. Elle contient l’install token de la fleet en plus de votre valeur : traitez-la donc comme une donnée sensible.
- Dans l’onglet Collectors, les collectors passent par les états Pending pickup, puis Applying, puis In sync.
5
Vérifier la télémétrie
Ouvrez HyperDX et recherchez l’un de vos services dans la vue Search ; utilisez Chart Explorer pour les metrics. Avec Managed ClickStack, ouvrez votre service dans la console ClickHouse Cloud et cliquez sur Launch ClickStack. Avec ClickHouse self-managed, interrogez directement les tables ClickStack, par exemple
SELECT ServiceName, count() FROM otel_logs GROUP BY ServiceName.Configuration avancée
Routage fan-out
Les mêmes données de télémétrie peuvent être envoyées simultanément à ClickStack pour un stockage à long terme, à une autre plateforme lors d’une migration et à un SIEM pour l’analyse de sécurité. Ajoutez les exporters sur le canevas et reliez-les aux pipelines qui doivent les alimenter, ou partez d’un pipeline prédéfini de la bibliothèque de flux de Telflo.Compression et performance
- Exporters OTLP/HTTP et OTLP : conservez Compression à gzip.
- ClickHouse exporter : laissez Async Insert activé, conservez Compression à lz4 et ajoutez un processor Batch en amont. Consultez Optimiser les inserts.
Étapes suivantes
- Créer des dashboards : créez des visualisations dans HyperDX pour les logs, les metrics et les traces
- Mettre en place des alerts : configurez des alerts dans ClickStack pour les conditions critiques
- Affiner avec l’AI assistant : demandez-lui d’ajuster un pipeline ou de proposer des tests
- Vous venez d’un autre fournisseur : les flows prennent en charge le basculement, en remplaçant les agents déjà déployés sur votre parc et en envoyant les données simultanément vers les deux backends le temps de les comparer