OpenTelemetry Collector Contrib: qué componentes elegir para producción

OpenTelemetry Collector Contrib: elige receivers, processors y exporters según la necesidad y pasa después a la distribución de Dynatrace o a OCB.
OpenTelemetry Collector Contrib : quels composants choisir pour la production

La imagen otel/opentelemetry-collector-contrib arranca en dos minutos y todo funciona. Seis meses después, el Collector consume más memoria de la prevista, una actualización rompe un componente que nadie usaba y el equipo de seguridad pregunta por qué un binario de producción incluye exporters hacia una decena de backends. El OpenTelemetry Collector Contrib es una excelente caja de herramientas; la trampa es usarlo como distribución de producción sin hacer una selección.

Objetivo de este artículo: entender qué contiene Contrib, elegir los componentes que realmente necesitas según la señal y la fuente, y construir con ellos un Collector específico: distribución de Dynatrace, distribución oficial para Kubernetes o build propio con el OpenTelemetry Collector Builder. Los ejemplos exportan por OTLP a Dynatrace SaaS o Dynatrace Managed; solo cambia la URL del endpoint.

Si el pipeline de receivers, processors y exporters es nuevo para ti, lee primero el Collector de OpenTelemetry hacia Dynatrace.

Qué contiene el OpenTelemetry Collector Contrib

El repositorio opentelemetry-collector-contrib aloja los componentes que no forman parte del núcleo del Collector: receivers para decenas de fuentes, processors avanzados, exporters hacia backends de terceros. Su configuración de build de prueba hace referencia a más de 250 módulos. La distribución Contrib los compila casi todos en un único binario.

Cada componente tiene su propio nivel de estabilidad, por señal: un mismo componente puede ser Stable para las trazas, Alpha para las métricas y estar en desarrollo para los logs. El README de cada componente lo indica, junto con sus mantenedores.

El proyecto OpenTelemetry publica varias distribuciones listas para usar, cada una descrita por un manifest.yaml:

Distribución Contenido Cuándo usarla
Core (otelcol) Receiver OTLP, batch, memory_limiter, exporters OTLP y debug Relé OTLP sencillo, conversión de gRPC a HTTP
Contrib (otelcol-contrib) Core más casi todos los componentes de terceros Pruebas, prototipos, búsqueda del componente adecuado
Kubernetes (otelcol-k8s) Subconjunto de Core y Contrib (Alpha o superior) para Kubernetes Collector dentro de un clúster
OTLP (otelcol-otlp) Solo receiver y exporters OTLP Pasarela mínima
Build propio (OCB) Exactamente lo que listes Producción con necesidades precisas

Por parte de Dynatrace, la documentación del Collector es clara: Contrib es ideal para pruebas, pero por lo general no se recomienda en producción, porque consume más recursos y puede ser menos estable que un build optimizado. Recomienda la distribución Dynatrace OTel Collector, un conjunto de componentes verificados, cubierto por el soporte de Dynatrace (cada versión menor tiene soporte durante tres meses). Para Core, Contrib y los builds propios, el soporte se limita a los componentes y las versiones incluidos en la distribución de Dynatrace.

Elegir los componentes de OpenTelemetry Collector Contrib según la necesidad

Parte de la necesidad, no del catálogo. Los nombres de abajo son los de las versiones recientes, que pasan progresivamente a snake_case (otlp_http desde la v0.144.0 del Collector, y después file_log, host_metrics, k8s_attributes…); los nombres antiguos (otlphttp, filelog, hostmetrics, k8sattributes) se siguen aceptando como alias obsoletos.

Recibir

  • Aplicaciones instrumentadas: otlp (Core). Añade zipkin o jaeger solo para aplicaciones heredadas.
  • Logs de archivos y del sistema: file_log para los archivos (incluido /var/log/pods), journald, syslog, fluent_forward para recibir de un Fluent Bit o Fluentd.
  • Métricas de host: host_metrics (CPU, memoria, disco, red, procesos).
  • Kubernetes: kubelet_stats (pods y contenedores por nodo), k8s_cluster (estado de los objetos), k8s_events o k8s_objects (eventos).
  • Ecosistema Prometheus y StatsD: prometheus para hacer scraping de exporters, statsd.
  • Kafka: kafka para consumir telemetría, kafka_metrics para monitorizar el clúster.

Procesar

  • Protección: memory_limiter al principio de cada pipeline.
  • Contexto: k8s_attributes y resource_detection añaden pod, namespace, host, nube.
  • Transformación y filtrado: transform (lenguaje OTTL), filter, attributes, resource.
  • Datos sensibles: redaction para enmascarar según patrones.
  • Muestreo: tail_sampling o el procesador de muestreo probabilístico.
  • Compatibilidad con Dynatrace: cumulative_to_delta, porque Dynatrace espera métricas con temporalidad delta (consulta la temporalidad de las métricas OTLP), y metric_start_time para las métricas de Prometheus.

Exportar y conectar

  • otlp_http hacia Dynatrace, debug para la resolución de problemas, load_balancing para enrutar los spans de una misma traza al mismo Collector antes de un tail_sampling.
  • Conectores: span_metrics para derivar métricas RED de los spans, forward para encadenar pipelines.
  • Extensiones: health_check, file_storage para una cola persistente, autenticación bearertokenauth u oidc.

La distribución de Dynatrace cubre la mayoría de estas necesidades. Su manifiesto, en un repositorio público con licencia Apache 2.0, lista con precisión lo que incluye:

Extracto del manifest.yaml de la distribución Dynatrace OTel Collector v0.57.0: 17 receivers, entre ellos filelog, hostmetrics, prometheus, kubeletstats, k8scluster, y 14 processors, entre ellos k8sattributes, transform, tailsampling, redaction (rutas de módulos abreviadas)

Pasar de Contrib a un Collector específico

Paso 1: inventariar lo que usas

Lista los componentes presentes en tu binario actual, con su nivel de estabilidad:

otelcol-contrib components

Compáralos con las secciones receivers, processors, exporters, connectors y extensions de tu archivo de configuración: solo sirven realmente los componentes referenciados en service.pipelines y service.extensions.

Paso 2: comprobar la cobertura de la distribución de Dynatrace

Si todos tus componentes figuran en el manifiesto de la distribución de Dynatrace, cámbiate a ella: mismo modelo de configuración, componentes verificados y soporte. Aprovecha para adoptar los nuevos nombres:

exporters:
  otlp_http:
    endpoint: ${env:DT_ENDPOINT}
    headers:
      Authorization: "Api-Token ${env:DT_API_TOKEN}"
processors:
  memory_limiter:
    check_interval: 1s
    limit_percentage: 80
    spike_limit_percentage: 25
  cumulative_to_delta: {}

El token lleva los scopes openTelemetryTrace.ingest, metrics.ingest y logs.ingest según las señales que exportes.

Paso 3: si no, construir el tuyo con OCB

¿Falta un componente? Construye una distribución con el OpenTelemetry Collector Builder. El archivo reproduce la estructura del manifiesto de Dynatrace:

dist:
  name: otelcol-equipe
  description: Collector de l'équipe plateforme
  output_path: ./build

receivers:
  - gomod: go.opentelemetry.io/collector/receiver/otlpreceiver v0.161.0
  - gomod: github.com/open-telemetry/opentelemetry-collector-contrib/receiver/filelogreceiver v0.161.0
processors:
  - gomod: go.opentelemetry.io/collector/processor/memorylimiterprocessor v0.161.0
  - gomod: github.com/open-telemetry/opentelemetry-collector-contrib/processor/k8sattributesprocessor v1.0.0
exporters:
  - gomod: go.opentelemetry.io/collector/exporter/otlphttpexporter v0.161.0
# même version que les composants listés
go install go.opentelemetry.io/collector/cmd/builder@v<version>
builder --config builder-config.yaml

Mantén versiones coherentes, procedentes de una misma release, como en el manifiesto de Dynatrace. El procesador k8sattributes tiene ahora su propia numeración (v1.0.0 en el manifiesto de Dynatrace).

Cómo comprobar que funciona

  1. Valida la configuración antes de desplegar:
    otelcol-contrib validate --config config.yaml

    Un componente ausente del binario produce un error explícito sobre el tipo desconocido.

  2. Activa health_check y consúltalo (puerto 13133 en los ejemplos de Dynatrace).
  3. En Dynatrace SaaS, comprueba la llegada de cada señal:
    fetch logs, from: now() - 15m
    | summarize logs = count(), by: {k8s.namespace.name}

    Para las métricas de host, el repositorio de Dynatrace ofrece un dashboard que aprovecha host_metrics y resource_detection:

OpenTelemetry Host Dashboard en Dynatrace: nombre del host, tipo y arquitectura del SO, número de CPU, memoria, capacidad de disco, indicadores de uso de CPU, memoria y sistema de archivos, curva de caudal de red, alimentados por el receiver hostmetrics
Source : github.com

En Managed, comprueba las trazas en la vista de trazas distribuidas y las métricas en Data Explorer. Para seguir la salud del propio Collector, consulta monitorizar el Collector de OpenTelemetry.

Buenas prácticas

  • Contrib para explorar, una distribución específica para producir: menos código, menos superficie de ataque, menos memoria.
  • Leer el nivel de estabilidad por señal antes de adoptar un componente Alpha en producción.
  • Fijar las versiones de la imagen o del build, y leer el CHANGELOG en cada actualización: los cambios de nombre a snake_case se anuncian allí.
  • memory_limiter en todas partes, y un solo rol por Collector (agente DaemonSet o pasarela), como en el Collector de OpenTelemetry en Kubernetes.
  • Configuración en Git y validación en CI para reducir el toil de las actualizaciones.

Preguntas frecuentes

¿Puedo mantener Contrib en producción?

Técnicamente sí, pero Dynatrace lo desaconseja y solo da soporte a los componentes presentes en su distribución. Si lo mantienes, fija la versión y vigila el consumo de memoria.

¿Qué hago si falta un componente en la distribución de Dynatrace?

Construye una distribución con OCB que añada ese componente, o ejecuta dos Collectors encadenados: la distribución con soporte en la salida hacia Dynatrace y un build propio aguas arriba para la fuente exótica.

¿Desaparecerán los nombres antiguos como otlphttp?

Están obsoletos y por ahora se siguen aceptando como alias. Adopta los nombres nuevos en tu próxima modificación de la configuración, para evitar una ruptura en una futura actualización de versión.

Conclusión

El OpenTelemetry Collector Contrib sirve para descubrir y probar; la producción merece una distribución elegida. Inventaria tus componentes, comprueba si figuran en la distribución de Dynatrace y, si no, construye la tuya con OCB. Un Collector más pequeño se reinicia más rápido, se actualiza con más tranquilidad y protege mejor los SLO de tu pipeline.

span.observer es un blog independiente de la comunidad, no afiliado a Dynatrace LLC. Dynatrace es una marca de Dynatrace LLC. Comprueba siempre los valores (puertos, versiones, tamaños) en la documentación oficial correspondiente a tu versión.

Total
0
Shares
Leave a Reply

Your email address will not be published. Required fields are marked *

Previous Post
Log ingestion API Dynatrace : envoyer, transférer et enrichir vos logs

API de ingesta de logs de Dynatrace: enviar, reenviar y enriquecer tus logs

Next Post
OpenTelemetry vs Prometheus (OTel vs Prometheus) : complémentaires ou concurrents ?

OpenTelemetry vs Prometheus (OTel vs Prometheus): ¿complementarios o rivales?

Related Posts