Las trazas de OpenTelemetry llegan a Dynatrace, los logs también, pero los contadores no aparecen por ninguna parte. No hay error en la aplicación y nada evidente en el Collector. En la mayoría de los casos, la causa está en la temporalidad de las métricas OTLP (delta o cumulative): la aplicación envía sumas cumulative, mientras que Dynatrace espera deltas.
Objetivo de este tutorial: entender en dos minutos la diferencia entre delta y cumulative, detectar el problema, corregirlo en el SDK (Java, Python, Go) o en el Collector, y verificar que las métricas llegan. El contenido sirve para Dynatrace SaaS y Dynatrace Managed, que exponen la misma API OTLP.
Si empiezas con la exportación OTLP, comienza por configurar el Collector de OpenTelemetry hacia Dynatrace.
Temporalidad de las métricas OTLP: delta o cumulative
Un contador de peticiones recibe 10 peticiones por minuto. El exporter puede enviarlo de dos maneras:
| Minuto | Cumulative | Delta |
|---|---|---|
| 1 | 10 | 10 |
| 2 | 20 | 10 |
| 3 | 30 | 10 |
En cumulative, cada punto contiene el total desde el arranque del proceso. En delta, contiene solo el incremento desde el punto anterior. La mayoría de los SDK de OpenTelemetry exportan en cumulative por defecto, una elección pensada para Prometheus. La API OTLP de Dynatrace, en cambio, espera contadores e histogramas en delta. Los puntos cumulative afectados no se ingieren.
Los gauges no tienen temporalidad y pasan sin cambios. Los UpDownCounter se aceptan en las dos temporalidades: en delta se convierten en contadores, en cumulative en gauges. Los histogramas cumulative, en cambio, se rechazan igual que los contadores cumulative. Detalles en la documentación de ingesta de métricas OTLP (página «About OTLP metrics ingest»).
Requisitos previos
- Un token de API con el scope
metrics.ingest. - El endpoint OTLP de tu entorno (
https://<env-id>.live.dynatrace.com/api/v2/otlpen SaaS,https://<votre-domaine>/e/<env-id>/api/v2/otlpen Managed). - Un SDK de OpenTelemetry reciente, o un Collector contrib (el processor que se usa más abajo forma parte de la distribución contrib).
Paso 1: confirmar el diagnóstico
Añade temporalmente el exporter debug al Collector para ver la temporalidad que realmente se envía:
exporters:
debug:
verbosity: detailed
service:
pipelines:
metrics:
receivers: [otlp]
exporters: [debug, otlphttp/dynatrace]
En los logs del Collector, busca la línea AggregationTemporality de tus contadores. El valor Cumulative confirma el problema. Sin Collector, la respuesta de la API OTLP puede señalar puntos rechazados (respuesta de éxito parcial): activa los logs del exporter del SDK para verla.
Paso 2: corregir en el SDK
Java, Python, .NET, Node.js: una variable de entorno
export OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE=delta
Esta variable forma parte de la especificación de OpenTelemetry y la leen los SDK de Java (y el agente de Java), Python, .NET y Node.js. Comprueba su compatibilidad en la versión del SDK que uses. En Java, ya está incluida en la configuración del agente de OpenTelemetry para Java.
Java: en código, si construyes tú mismo el exporter
import io.opentelemetry.exporter.otlp.http.metrics.OtlpHttpMetricExporter;
import io.opentelemetry.sdk.metrics.export.AggregationTemporalitySelector;
OtlpHttpMetricExporter exporter = OtlpHttpMetricExporter.builder()
.setEndpoint("https://abc12345.live.dynatrace.com/api/v2/otlp/v1/metrics")
.addHeader("Authorization", "Api-Token " + System.getenv("DT_API_TOKEN"))
.setAggregationTemporalitySelector(AggregationTemporalitySelector.deltaPreferred())
.build();
Línea crítica: deltaPreferred() pasa a delta los contadores y los histogramas. Ten en cuenta que la URL completa, con /v1/metrics, es obligatoria cuando se configura el exporter en código.
Go: un selector de temporalidad
Los exporters OTLP de métricas de Go recientes también leen esta variable, pero las versiones antiguas la ignoran. Para un comportamiento explícito, sea cual sea la versión, declara el selector:
import (
"context"
"go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetrichttp"
sdkmetric "go.opentelemetry.io/otel/sdk/metric"
"go.opentelemetry.io/otel/sdk/metric/metricdata"
)
exp, err := otlpmetrichttp.New(ctx,
otlpmetrichttp.WithTemporalitySelector(
func(sdkmetric.InstrumentKind) metricdata.Temporality {
return metricdata.DeltaTemporality
}),
)
Este ejemplo fuerza delta para todos los instrumentos. Para un UpDownCounter, el delta hace que aparezca como contador; si prefieres un gauge (valor actual), déjalo en cumulative en el selector.
Paso 3: o corregir en el Collector
Cuando no controlas las aplicaciones (bibliotecas de terceros, receiver de Prometheus), convierte en el Collector con el processor cumulative_to_delta:
processors:
cumulative_to_delta: {}
batch: {}
exporters:
otlphttp/dynatrace:
endpoint: https://abc12345.live.dynatrace.com/api/v2/otlp
headers:
Authorization: "Api-Token ${env:DT_API_TOKEN}"
service:
pipelines:
metrics:
receivers: [otlp, prometheus]
processors: [cumulative_to_delta, batch]
exporters: [otlphttp/dynatrace]
Líneas críticas: cumulative_to_delta (nuevo nombre del antiguo cumulativetodelta, que se conserva como alias obsoleto) es con estado. Guarda en memoria el último valor de cada serie. Consecuencias:
- todos los datos de una misma serie deben pasar por la misma instancia del Collector (sin reparto aleatorio entre varias instancias);
- tras un reinicio, el primer punto de una serie ya existente sirve de referencia y no se exporta (comportamiento por defecto
initial_value: auto); - la memoria crece con el número de series: vigila la cardinalidad.
Coloca el processor antes de batch, como arriba.
Cómo comprobar que funciona
- En los logs del exporter
debug, la temporalidad muestra ahoraDelta. Retira después el exporterdebug. - En Dynatrace SaaS, abre un Notebook y ejecuta (sustituye por el nombre de tu métrica):
timeseries requetes = sum(http.server.request.count), interval: 1m
| fieldsAdd total = arraySum(requetes)
La curva debe ser plana con un tráfico constante (10 por minuto en nuestro ejemplo), no una rampa que sube sin fin. Una rampa indicaría un valor cumulative interpretado como delta. El nombre de la métrica en Dynatrace puede diferir ligeramente del nombre en OpenTelemetry: búscalo en la lista de métricas. En Managed, usa el explorador de datos con la misma comprobación visual.
Resolución de problemas
- Sigue sin llegar nada tras pasar a delta: comprueba el scope
metrics.ingestdel token y la URL del endpoint (un 404 suele indicar un/v1/metricsduplicado o ausente). - Picos aislados tras cada reinicio: un processor
cumulative_to_deltasituado detrás de un balanceador de carga recibe los puntos de una misma serie en varias instancias. Enruta por serie o corrige en el SDK. - Solo llega una parte de las métricas: algunos instrumentos siguen en cumulative, por ejemplo los histogramas, que entonces se rechazan (un UpDownCounter cumulative llega, en cambio, como gauge). Compara la salida del exporter
debuginstrumento por instrumento. - Valores duplicados: la misma métrica sale a la vez directamente del SDK y a través del Collector. Mantén un solo camino de exportación.
Buenas prácticas
- Corrige lo más cerca posible del origen: el SDK en delta evita el estado del Collector.
- Mantén la misma temporalidad en todas las aplicaciones de una plataforma, documentada en tus estándares.
- Para los SLO de latencia, envía histogramas en delta: consulta las métricas de histograma con OpenPipeline.
- Una métrica perdida en silencio es un SLI ciego: añade una alerta de ausencia de datos para las métricas críticas.
Preguntas frecuentes
¿Por qué Dynatrace prefiere el delta?
El delta no tiene estado en la recepción: cada punto se basta a sí mismo, sea cual sea el número de instancias que envían. No hace falta seguir los reinicios de cada proceso.
Mis métricas de Prometheus son cumulative: ¿qué hago?
Recógelas con el receiver de Prometheus del Collector y aplica después cumulative_to_delta, como en el paso 3.
¿Afecta a los gauges?
No. Un gauge representa un valor instantáneo (memoria usada, longitud de una cola) y no tiene temporalidad de agregación.
Conclusión
La temporalidad de las métricas OTLP se ajusta con una línea, pero olvidarla hace desaparecer contadores enteros. Verifica la temporalidad con el exporter debug, pasa el SDK a delta o convierte en el Collector, y comprueba después la forma de las curvas. Tus SLI se apoyan entonces en cifras completas.
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. Las funciones evolucionan rápido: comprueba su disponibilidad en tu entorno y en la documentación oficial.