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ñadezipkinojaegersolo para aplicaciones heredadas. - Logs de archivos y del sistema:
file_logpara los archivos (incluido/var/log/pods),journald,syslog,fluent_forwardpara 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_eventsok8s_objects(eventos). - Ecosistema Prometheus y StatsD:
prometheuspara hacer scraping de exporters,statsd. - Kafka:
kafkapara consumir telemetría,kafka_metricspara monitorizar el clúster.
Procesar
- Protección:
memory_limiteral principio de cada pipeline. - Contexto:
k8s_attributesyresource_detectionañaden pod, namespace, host, nube. - Transformación y filtrado:
transform(lenguaje OTTL),filter,attributes,resource. - Datos sensibles:
redactionpara enmascarar según patrones. - Muestreo:
tail_samplingo 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), ymetric_start_timepara las métricas de Prometheus.
Exportar y conectar
otlp_httphacia Dynatrace,debugpara la resolución de problemas,load_balancingpara enrutar los spans de una misma traza al mismo Collector antes de untail_sampling.- Conectores:
span_metricspara derivar métricas RED de los spans,forwardpara encadenar pipelines. - Extensiones:
health_check,file_storagepara una cola persistente, autenticaciónbearertokenauthuoidc.
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:

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
- Valida la configuración antes de desplegar:
otelcol-contrib validate --config config.yamlUn componente ausente del binario produce un error explícito sobre el tipo desconocido.
- Activa
health_checky consúltalo (puerto 13133 en los ejemplos de Dynatrace). - 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_metricsyresource_detection:

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.