Una suma OTLP representa una suma de las mediciones notificadas a lo largo de un periodo de tiempo. Por ejemplo, una suma puede utilizarse para registrar el número total de conexiones realizadas a una base de datos o el número total de solicitudes a un endpoint. Las sumas tienen dos características que influyen en la asignación:

• Temporalidad de agregación. Puede ser Acumulativa o Delta. Las métricas delta no se solapan en el periodo de tiempo, mientras que las métricas acumulativas representan un periodo de tiempo a partir de un punto de partida fijo en el tiempo.
• Monotonicidad. Las sumas monótonas nunca decrecen y sólo admiten la adición al recuento subyacente.

La asignación por defecto es la siguiente:

1. Para sumas monotónicas acumulativas, se calcula delta entre puntos consecutivos y se informa a Datadog como un recuento. El primer punto se almacena pero se omite. Para recuperar el valor en la carga útil OTLP, utiliza la función aritmética cumsum.
2. Las sumas acumulativas no monotónicas se exportan como indicadores de Datadog.
3. Las sumas delta se exportan como recuentos de Datadog.

Un indicador OTLP representa un valor muestreado en un momento dado. Sólo se incluye en las métricas OTLP el último valor de un periodo de tiempo determinado.

Los indicadores OTLP se asignan a indicadores Datadog, ya que no proporcionan una semántica de agregación. Los puntos de datos de indicador, tanto enteros como de coma flotante, se asignan a números de coma flotante en el formato Datadog.

Un histograma OTLP representa la distribución estadística de un conjunto de valores en un periodo de tiempo determinada, almacenando ciertas métricas de agregación como la suma o el recuento de la población junto con una serie de recuentos de buckets. Los histogramas tienen una característica que influye en la asignación:

• Temporalidad de agregación. Puede ser Acumulativa o Delta. Las métricas delta no se solapan en el periodo de tiempo, mientras que las métricas acumulativas representan un periodo de tiempo a partir de un punto de partida fijo en el tiempo.

La asignación por defecto es la siguiente:

1. Los histogramas delta se presentan como distribuciones Datadog. Para comprender las agregaciones disponibles, consulta más literatura sobre distribuciones. Los histogramas con un recuento de 0 se descartan.
2. En los histogramas acumulativos, se calcula el delta entre puntos consecutivos y se envía a Datadog como distribución. Los deltas con un recuento de 0 no se informan. Puedes utilizar la función aritmética cumsum en agregaciones individuales para recuperar el valor en la carga útil OTLP.

Nota: Las métricas de histogramas en OTLP se asignan por defecto a métricas de distribución. Debido a la forma en que OTLP envía estos datos, las agregaciones de percentiles y los máximos y mínimos (si no están disponibles en los datos OTLP originales) son aproximaciones, no cálculos exactos.

El Datadog Agent y el exportadores Datadog del recopilador OpenTelemetry permiten cambiar la exportación de histogramas en la subsección histogram.

• Si el mode se configura en counters, se generan las siguientes métricas:

<METRIC_NAME>.bucket, etiquetado por lower_bound y upper_bound

Recuento de buckets en el periodo de tiempo para el bucket con los límites inferior y superior especificados.
Datadog In-App Type: RECUENTO

• Si se activa la marca send_aggregation_metrics, se generan las siguientes métricas:

<METRIC_NAME>.sum

Suma de los valores enviados durante el periodo de tiempo.
Datadog In-App Type: RECUENTO

<METRIC_NAME>.count

Suma de los valores enviados durante el periodo de tiempo.
Datadog In-App Type: RECUENTO

<METRIC_NAME>.min

Mínimo de valores enviados durante el periodo de tiempo. Sólo disponible para los histogramas OTLP delta. Disponible desde: el exportador Datadog v0.75.0 y el Datadog Agent v6.45.0 y v7.45.0.
Datadog In-App Type: INDICADOR

<METRIC_NAME>.max

Máximo de valores enviados durante el periodo de tiempo. Sólo disponible para los histogramas OTLP delta. Disponible desde: el exportador Datadog v0.75.0 y el Datadog Agent v6.45.0 y v7.45.0.
Datadog In-App Type: INDICADOR

Nota: send_aggregation_metrics sólo es útil cuando no se utiliza el modo de distribución. Antes del exportador de Datadog v0.75.0 y del Datadog Agent v6.45.0 y v7.45.0, utiliza send_count_sum_metrics.

Un Resumen OTLP es un tipo heredado que transmite información cuantílica sobre una población durante un periodo de tiempo. Los tipos de resumen OTLP no son generados por los SDK de OpenTelemetry, pero pueden ser generados por otros componentes para la compatibilidad con versiones anteriores.

<METRIC_NAME>.sum

Suma de los valores enviados desde que la aplicación comenzó a generar métricas.
Datadog In-App Type: RECUENTO

<METRIC_NAME>.count

Suma de los valores de una población.
Datadog In-App Type: RECUENTO

<METRIC_NAME>.quantile, etiquetado por quantile

Valor de un cuantil dado.
Datadog In-App Type: INDICADOR

Supongamos que estás utilizando un instrumento de recuento OpenTelemetry desde una sola aplicación, que, por defecto, exporta métricas de tipo suma monotónica acumulativa. La siguiente tabla resume el comportamiento de Datadog:

Supón que estás utilizando un instrumento de recuento OpenTelemetry desde una sola aplicación, que, por defecto, exporta métricas de tipo suma acumulativa. La siguiente tabla resume el comportamiento de Datadog:

Supón que estás utilizando un instrumento indicador OpenTelemetry, temperature, desde una sola aplicación. La siguiente tabla resume el comportamiento de Datadog:

Supón que estás utilizando un instrumento de histograma OpenTelemetry, request.response_time.histogram, desde dos servidores web: webserver:web_1 y webserver:web_2. Supón que en un periodo de recopilación determinado, webserver:web_1 informa la métrica con los valores [1,1,1,2,2,2,3,3] y que webserver:web_2 informa la misma métrica con los valores [1,1,2]. Durante este periodo de recopilación, las cinco agregaciones siguientes representan la distribución estadística global de todos los valores recopilados de ambos servidores web:

Para saber cómo configurar más agregaciones, consulta la literatura sobre distribuciones.

Alternativamente, si estás utilizando el modo counters, la marca send_aggregation_metrics está habilitada y los límites del bucket de histogramas se configuran en [-inf, 2, inf]. Se informan las siguientes métricas:

Supón que estás enviando una métrica de resumen OTLP heredada, request.response_time.summary, desde un servidor web. Supón que en un periodo de recopilación determinado, el servidor web informa la métrica con los valores [1,1,1,2,2,2,3,3]. Las siguientes métricas serán informadas, si los cuantiles mínimo, máximo y medio están activados: