Envío de OpenTelemetry a ClickStack con Odigos

Odigos es un plano de control de instrumentación para Kubernetes y VM que instrumenta aplicaciones a nivel del kernel mediante eBPF. Como la recopilación se ejecuta en el kernel, la sobrecarga de la aplicación se mantiene baja mientras la visibilidad sigue siendo alta. Obtienes trazas, métricas, logs y perfiles de OpenTelemetry listos para producción sin incorporar nuevos agentes en el código de la aplicación ni tener que esperar actualizaciones de bibliotecas en cada servicio.

Esa capa de eBPF es lo que hace posible una telemetría profunda y consistente a escala. Odigos puede activar y desactivar automáticamente una instrumentación más profunda cuando sea necesario para ayudar a depurar o diagnosticar problemas:

• Contexto a nivel de código — atributos vinculados a funciones y al comportamiento en tiempo de ejecución
• Tráfico HTTP — solicitudes y respuestas entre tus servicios
• Sistemas de mensajería — payloads y mensajes de Kafka y brókers similares
• Errores en detalle — stack traces cuando algo falla
• Instrumentación personalizada — amplía la cobertura allí donde termina la autoinstrumentación sin requerir cambios de código ni reinicios

Entre bastidores, Odigos crea y gestiona un pipeline completo de OpenTelemetry para tu clúster: collectors que escalan con la carga, enrutamiento a los backends que elijas y lógica de pipeline que controlas en la UI. Define sampling para gestionar el volumen, enmascaramiento de PII para mantener los datos sensibles fuera de las exportaciones y reglas OTTL para filtrar, transformar o enriquecer la telemetría antes de que salga del clúster.

Implementar OpenTelemetry en muchos servicios suele llevar tiempo y solo ofrece visibilidad superficial de las aplicaciones. Odigos se encarga de la instrumentación con eBPF para obtener una telemetría más profunda y de la operación del collector en Kubernetes; ClickStack proporciona almacenamiento basado en ClickHouse y la UI de HyperDX para consultar la telemetría a escala.

• ClickStack instalado y accesible desde su clúster de Kubernetes. Consulte Primeros pasos con ClickStack de código abierto o Primeros pasos con ClickStack gestionado.
• El endpoint HTTP de OTLP de su ClickStack (puerto 4318) y el valor de autenticación que Odigos enviará en el encabezado Authorization. Con ClickStack de código abierto, este es la API key de ingesta de configuración del equipo → Claves de API en la UI de HyperDX. Con ClickStack gestionado, este es el OTLP_AUTH_TOKEN que configuró al iniciar su propio ClickStack collector independiente.
• Un clúster de Kubernetes (nodos Linux con kernel 4.18 o posterior para la instrumentación eBPF)
• Helm, kubectl y credenciales del clúster para instalar en el espacio de nombres odigos-system
• Un token local de Odigos Enterprise — póngase en contacto con el equipo de Odigos para obtener acceso

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 exporta directamente a ClickHouse con el destino nativo de ClickHouse de Odigos (en lugar de usar OTLP HTTP hacia ClickStack), habilite el normalizador de logs de HyperDX (HYPERDX_LOG_NORMALIZER: true). Analiza los cuerpos de los logs en JSON y normaliza los atributos para facilitar las consultas en la UI de ClickStack.

Si se puede acceder directamente a ClickHouse desde tu clúster, puedes usar el destino nativo de ClickHouse de Odigos en lugar de OTLP HTTP. Configura el endpoint de ClickHouse, el nombre de la base de datos y las opciones de esquema en la UI o con un manifest; consulta Odigos ClickHouse destination.

• Esquema de producción: Configura CLICKHOUSE_CREATE_SCHEME como false y aplica tu propio DDL.
• TLS / autenticación: Usa CLICKHOUSE_TLS_ENABLED, CLICKHOUSE_USERNAME y un Kubernetes Secret para la contraseña.

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 key de ingesta para ClickStack de código abierto, o OTLP_AUTH_TOKEN para ClickStack gestionado
    OTLP_HTTP_HEADERS: 'Authorization:<YOUR_AUTHORIZATION_VALUE>'

ClickHouse (directo)

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'

Aplica el manifiesto:

kubectl apply -f destination.yaml

El Odigos VM Agent instrumenta procesos de Linux, servicios de systemd y/o contenedores de Docker mediante eBPF. La telemetría se exporta a los mismos destinos que en Odigos basado en clústeres, incluido ClickStack a través de OTLP HTTP.

El VM Agent forma parte de Odigos Pro. Consulta la descripción general de VM Agent para obtener información sobre la instalación, las fuentes y la configuración de destinos.

Odigos Central es un plano de control centralizado para gestionar la instrumentación, los destinos y la configuración de canalizaciones en varios clústeres de Kubernetes desde una única UI, en lugar de configurar cada clúster por separado.

Odigos Central está disponible en Odigos Enterprise. Consulta la descripción general de Central para obtener información sobre la gestión multiclúster, SSO y las reglas de sampling unificadas.

• Explore las trazas en los servicios instrumentados de ClickStack
• Cree paneles para las métricas exportadas por Odigos
• Ajuste el esquema y el TTL de ClickHouse según sus necesidades de retención y patrones de consulta

• Instalación de Odigos Enterprise
• Odigos ClickHouse destination
• Descripción general de Odigos VM Agent
• Descripción general de Odigos Central
• Deja de hacer suposiciones en producción: tracing con total fidelidad a escala con ClickHouse y Odigos
• Primeros pasos con ClickStack de código abierto