Un token de autorización aparece en un atributo de log, una métrica llega con un nombre que nadie reconoce y los health checks inflan la factura de trazas. Son tres problemas con una sola respuesta posible dentro del Collector: el lenguaje OTTL OpenTelemetry, que corrige la telemetría en tránsito, antes de que salga hacia el backend.
Este artículo parte de tres decisiones de operación y no de una lista de funciones: qué hay que ocultar, qué hay que renombrar y qué hay que descartar. Cada respuesta cabe en unas pocas instrucciones. Para ver todos los componentes del Collector, consulta el artículo sobre los componentes de Collector contrib; aquí nos centramos en el lenguaje.
Los datos proceden de la página «Transforming telemetry» de opentelemetry.io y de los README del repositorio opentelemetry-collector-contrib (pkg/ottl, transformprocessor, filterprocessor), leídos el 12 de noviembre de 2026. El tratamiento ocurre en el Collector, antes de la exportación OTLP, así que el razonamiento sirve para Dynatrace SaaS, para Dynatrace Managed y para cualquier otro backend.
Leer una instrucción OTTL en treinta segundos
Una instrucción OTTL tiene una función y, de forma opcional, una condición. La función transforma la telemetría; la condición, introducida con where, decide si la función se ejecuta. El ejemplo del README cabe en una línea: set(span.attributes["test"], "pass") where span.attributes["test"] == nil.
El primer argumento es una ruta (path) hacia un campo: span.attributes, resource.attributes, log.body, metric.name. El prefijo indica el contexto. El README enumera los contextos resource, scope, span, span event, span link, metric, datapoint, exemplar y log. Un detalle importante: OTTL no admite interacciones entre señales, de modo que copiar el cuerpo de un log a un atributo de span se rechaza.
Hay dos familias de funciones. Los editores modifican el dato (set, delete_key, replace_pattern, keep_keys, truncate_all). Los conversores calculan un valor y se escriben con mayúscula inicial (SHA256, IsMatch, Concat, Substring, ParseJSON). El lenguaje se usa en varios sitios: el procesador transform, el procesador filter, el tail sampling y el routing connector.
Ocultar: quitar el secreto antes de exportar
Ante una fuga, lo primero es eliminar la clave culpable y después limpiar lo que quede en el texto. El procesador transform recibe listas de instrucciones por señal (log_statements, trace_statements, metric_statements). La siguiente configuración de logs borra una cabecera, enmascara una contraseña en el cuerpo y sustituye un identificador por su huella.

delete_keyelimina el atributohttp.request.header.authorization, que es el ejemplo de la documentación.replace_patterncambia cualquier secuenciapassword=…del cuerpo porpassword=***. Da por hecho que el cuerpo es una cadena; si es estructurado, pruébalo antes de fiarte.setconSHA256guarda la huella deuser.iden un atributo nuevo, solo si el atributo existe.- El último
delete_keyborra después el valor original.
Ojo con lo que significa «ocultar». Una huella SHA-256 permite correlacionar los eventos de un mismo usuario sin ver su identificador. Pero si el identificador es corto o predecible, alguien puede recalcular la huella de cada valor posible. Es un razonamiento general, no una promesa de la documentación: con datos regulados, elige borrar.
En Dynatrace también existe el enmascarado en la ingesta, con funciones propias de la plataforma, descrito en el artículo sobre enmascarado en OpenPipeline. Los dos enfoques no se mezclan: este actúa en el Collector y aquel cuando los datos ya han llegado.
Renombrar: alinear los nombres con tus convenciones
Renombrar sirve para una cosa: que los mismos datos se llamen igual en todas partes, por ejemplo para cumplir las convenciones semánticas. En los extractos leídos, OTTL no tiene un editor «rename» específico, así que se combinan dos gestos: copiar el valor al nombre nuevo y borrar el antiguo. Para el nombre de una métrica, replace_pattern actúa directamente sobre metric.name.

La primera instrucción viene del README y convierte kube_pod_… en k8s.pod…. Fíjate en el $$1. En un archivo de configuración del Collector, el signo de dólar se usa para expandir variables, por eso se duplica para obtener un grupo de captura. Sin ello, la referencia se interpreta antes de llegar a OTTL.
El segundo par mueve el atributo route a http.route. El orden importa: la instrucción que copia debe ir antes que la que borra, o el valor desaparece antes de copiarse. Las instrucciones se ejecutan en el orden en que están escritas.
La página de opentelemetry.io presenta también el procesador metricstransform, que renombra métricas y etiquetas con coincidencias por expresión regular. Es otro camino, con su propia sintaxis. Elige una sola herramienta por transformación para que quien venga después sepa dónde mirar.
Filtrar: descartar el ruido, pero con criterio
El procesador filter también usa OTTL, pero con condiciones en lugar de instrucciones. La regla de lectura es contraintuitiva: si una condición es verdadera, el dato se elimina. Varias condiciones de la misma lista se combinan con un OR: basta con que coincida una. Dentro de una condición se admiten and, or y paréntesis.

La configuración de arriba descarta los spans de /healthz y los logs por debajo del nivel INFO, y después coloca el filtro en el pipeline. El README del filtro advierte de varios efectos secundarios:
- si se elimina un span, sus condiciones de eventos de span se ignoran;
- si se eliminan todos los eventos de un span, el span se conserva;
- si se eliminan todos los puntos de datos de una métrica, la métrica también desaparece;
- eliminar spans puede dejar spans hijos o logs huérfanos.
Otro matiz: el README describe el formato actual (trace_conditions, log_conditions, metric_conditions) e indica que las opciones antiguas traces.*, metrics.* y logs.* están obsoletas. La página de opentelemetry.io todavía muestra la forma antigua. Si quieres decidir qué trazas conservar según su contenido global, el filtro no sirve: mira las reglas de tail sampling.
Llevar OTTL OpenTelemetry a producción
Tres ajustes evitan sorpresas desagradables.
- Elegir el
error_mode. Los valores sonignore(por defecto: se registra el error y se ejecuta la siguiente instrucción),silent(sin registro) ypropagate(el error sube y se descarta el lote). Para un enmascarado,propagatees defendible: mejor perder un lote que exportar un secreto. Un grupo de instrucciones puede sobrescribir el valor global. - Ordenar los procesadores. Se aplican en el orden del pipeline. Filtra primero para no transformar lo que se va a descartar y enmascara antes de cualquier exportación.
- Activar el log de debug para entender un resultado. Con
service.telemetry.logs.levelendebug, el Collector muestra cada instrucción, si su condición coincidió y el estado del contexto tras ejecutarla.
Para casos más ricos, el formato avanzado del procesador transform agrupa instrucciones con su propio context, sus conditions y su error_mode. Las instrucciones que mezclan rutas o funciones incompatibles fallan al cargar la configuración, y hay que separarlas en grupos. El README pone como ejemplo convert_sum_to_gauge() con una ruta datapoint.
Buenas prácticas
- Añade una condición
wherea cada instrucción para tratar solo los datos afectados: el README lo recomienda por rendimiento, y la página de opentelemetry.io avisa de que las transformaciones avanzadas pueden degradarlo de forma notable. - Prueba en un pipeline de pruebas con el exportador de debug antes de pasar a producción.
- Mantén las reglas de enmascarado en un único archivo versionado y revisado como código.
- Mide antes y después: volumen exportado, latencia del pipeline y memoria del Collector. Aquí no se garantiza ninguna cifra.
- Evita depender de funciones marcadas como experimentales; en el README, las señales de trazas, métricas y logs son estables y los perfiles están en desarrollo.
Preguntas frecuentes
¿Sustituye OTTL a los procesadores attributes y resource?
No necesariamente. Esos procesadores, presentados en opentelemetry.io, cubren casos simples (insertar, actualizar o borrar un atributo) con configuración declarativa. OTTL resulta útil en cuanto necesitas una condición, un cálculo o una expresión regular. Mezclar ambos sobre el mismo campo dificulta la revisión.
¿Se puede eliminar un span con el procesador transform?
Las fuentes leídas no describen ninguna función de eliminación en transform: ese es el papel del procesador filter. No he comprobado si una versión reciente lo permite de otra forma; manda la documentación de tu versión.
¿Cómo saber por qué una instrucción no se aplica?
Sube el nivel de log del Collector a debug. Cada instrucción aparece con el resultado de su condición. Después revisa el prefijo de contexto de la ruta: una ruta log en un pipeline de trazas no funcionará.
Conclusión
OTTL OpenTelemetry se resume en un esquema: una función, una ruta, una condición. Oculta lo que no debe salir de tu red, renombra para alinear tus convenciones, filtra el ruido y ajusta error_mode según el riesgo. Referencias: el README del paquete OTTL y la página Transforming telemetry.
span.observer es un blog independiente de la comunidad, no afiliado a Dynatrace LLC. Dynatrace es una marca de Dynatrace LLC. Los ejemplos son ficticios y no se han ejecutado en un Collector: comprueba siempre los valores (puertos, versiones, tamaños) en la documentación oficial correspondiente a tu versión.