Envoyer des données OpenTelemetry vers ClickStack avec Odigos

Odigos est un plan de contrôle de l’instrumentation pour Kubernetes et les VM, qui instrumente les applications au niveau du noyau à l’aide d’eBPF. Comme la collecte s’exécute dans le noyau, la surcharge applicative reste faible tout en conservant une visibilité élevée. Vous obtenez des traces, métriques, logs et profils OpenTelemetry prêts pour la production, sans déployer de nouveaux agents dans le code applicatif ni attendre des mises à niveau de bibliothèques dans chaque service.

Cette couche eBPF rend possible une télémétrie fine et cohérente à grande échelle. Odigos peut automatiquement activer et désactiver une instrumentation plus poussée lorsque nécessaire pour faciliter le débogage et la résolution de problèmes :

• Contexte au niveau du code — attributs liés aux fonctions et au comportement du runtime
• Trafic HTTP — requêtes et réponses entre vos services
• Systèmes de messagerie — payloads et messages provenant de Kafka et de brokers similaires
• Détails des erreurs — stack traces en cas d’échec
• Instrumentation personnalisée — étend la couverture là où l’auto-instrumentation s’arrête, sans modification du code ni redémarrage

En coulisses, Odigos crée et gère un pipeline OpenTelemetry complet pour votre cluster : des collecteurs qui s’adaptent à la charge, un routage vers les backends de votre choix et une logique de pipeline que vous contrôlez dans l’UI. Définissez le échantillonnage pour gérer le volume, le masquage des PII pour empêcher les données sensibles d’apparaître dans les exports, et des règles OTTL pour filtrer, transformer ou enrichir la télémétrie avant qu’elle ne quitte le cluster.

Déployer OpenTelemetry sur de nombreux services prend souvent du temps et n’offre qu’une visibilité limitée des applications. Odigos gère l’instrumentation eBPF pour une télémétrie plus approfondie ainsi que les opérations du collecteur sur Kubernetes ; ClickStack fournit un stockage basé sur ClickHouse et la HyperDX UI pour interroger la télémétrie à grande échelle.

• ClickStack installé et accessible depuis votre cluster Kubernetes. Voir Premiers pas avec ClickStack open source ou Premiers pas avec Managed ClickStack.
• Votre endpoint HTTP OTLP ClickStack (port 4318) et la valeur d’authentification qu’Odigos transmettra dans l’en-tête Authorization. Avec ClickStack open source, il s’agit de la clé d’ingestion de l’API disponible dans Team Settings → API Keys de l’interface HyperDX. Avec Managed ClickStack, il s’agit du OTLP_AUTH_TOKEN que vous avez défini au démarrage de votre propre collecteur ClickStack autonome.
• Un cluster Kubernetes (nœuds Linux avec un noyau 4.18 ou ultérieur pour l’instrumentation eBPF)
• Helm, kubectl et les identifiants du cluster pour l’installation dans l’espace de noms odigos-system
• Un jeton Odigos Enterprise on-premises — contactez l’équipe Odigos pour obtenir l’accès

export ODIGOS_ONPREM_TOKEN="<your-enterprise-token>"

helm repo add odigos https://odigos-io.github.io/odigos/
helm repo update

helm upgrade --install odigos odigos/odigos \
  --namespace odigos-system \
  --create-namespace \
  --set onPremToken=$ODIGOS_ONPREM_TOKEN

kubectl get pods -n odigos-system

kubectl port-forward svc/ui -n odigos-system 3000:3000

Si vous exportez directement vers ClickHouse avec la destination ClickHouse native d'Odigos (au lieu d'OTLP HTTP vers ClickStack), activez le normaliseur de logs HyperDX (HYPERDX_LOG_NORMALIZER: true). Il analyse les corps de logs au format JSON et normalise les attributs pour faciliter les requêtes dans l'interface ClickStack.

Lorsque ClickHouse est directement accessible depuis votre cluster, vous pouvez utiliser la destination ClickHouse native d’Odigos au lieu d’OTLP HTTP. Configurez l’endpoint ClickHouse, le nom de la base de données et les options de schéma dans l’UI ou à l’aide d’un manifeste — voir Odigos ClickHouse destination.

• Schéma de production : définissez CLICKHOUSE_CREATE_SCHEME sur false et appliquez votre propre DDL.
• TLS / authentification : utilisez CLICKHOUSE_TLS_ENABLED, CLICKHOUSE_USERNAME et un Secret Kubernetes pour le mot de passe.

OTLP HTTP (ClickStack)

apiVersion: odigos.io/v1alpha1
kind: Destination
metadata:
  name: clickstack
  namespace: odigos-system
spec:
  type: otlphttp
  destinationName: otlphttp
  signals:
    - TRACES
    - METRICS
    - LOGS
  data:
    OTLP_HTTP_ENDPOINT: 'http://clickstack.example.com:4318'
    # API ingestion key for open source ClickStack, or OTLP_AUTH_TOKEN for Managed ClickStack
    OTLP_HTTP_HEADERS: 'Authorization:<YOUR_AUTHORIZATION_VALUE>'

ClickHouse (direct)

apiVersion: odigos.io/v1alpha1
kind: Destination
metadata:
  name: clickhouse
  namespace: odigos-system
spec:
  type: clickhouse
  destinationName: clickhouse
  signals:
    - TRACES
    - METRICS
    - LOGS
  data:
    CLICKHOUSE_ENDPOINT: 'http://clickstack.example.com:8123'
    CLICKHOUSE_DATABASE_NAME: 'otel'
    CLICKHOUSE_CREATE_SCHEME: 'true'

Appliquez le manifeste :

kubectl apply -f destination.yaml

L’Odigos VM Agent instrumente les processus Linux, les services systemd et/ou les conteneurs Docker à l’aide d’eBPF. La télémétrie est exportée vers les mêmes destinations qu’avec Odigos déployé sur cluster, y compris ClickStack via OTLP HTTP.

Le VM Agent fait partie d’Odigos Pro. Consultez la VM Agent overview pour l’installation, les sources et la configuration de la destination.

Odigos Central est un plan de contrôle centralisé qui permet de gérer l’instrumentation, les destinations et la configuration des pipelines sur plusieurs clusters Kubernetes depuis une seule UI, au lieu de configurer chaque cluster séparément.

Odigos Central est disponible dans Odigos Enterprise. Consultez la présentation de Central pour la gestion de plusieurs clusters, le SSO et des règles d’échantillonnage unifiées.

• Explorez les traces sur l’ensemble des services instrumentés dans ClickStack
• Créez des tableaux de bord pour les métriques exportées par Odigos
• Ajustez le schéma et le TTL de ClickHouse en fonction de votre rétention et de vos patterns de requêtes

• Installation d’Odigos Enterprise
• Destination ClickHouse d’Odigos
• Présentation de VM Agent d’Odigos
• Présentation d’Odigos Central
• Ne tâtonnez plus en production : un traçage haute fidélité à grande échelle avec ClickHouse et Odigos
• Prise en main de ClickStack open source