This page is not yet available in Spanish. We are working on its translation.
If you have any questions or feedback about our current translation project, feel free to reach out to us!

Información general

El Datadog Agent y el exportador Datadog del recopilador OpenTelemetry pueden consumir métricas en el formato OpenTelemetry (OTLP), que puede ser generado por aplicaciones instrumentadas por OpenTelemetry.

Los siguientes tipos de métricas OTLP pueden ser consumidos por el Datadog Agent y el exportador Datadog del recopilador OpenTelemetry:

  • Suma
  • Indicadores
  • Histogramas
  • Resúmenes

Estos tipos de métricas OTLP se asignan a los tipos de métricas de Datadog:

  • RECUENTO
  • INDICADOR
  • DISTRIBUCIÓN

Una única métrica OTLP puede asignarse a varias métricas de Datadog con un sufijo que indica su significado.

Nota: OpenTelemetry proporciona instrumentos API de métricas (Gauge, Counter, UpDownCounter, Histogram, y así sucesivamente), cuyas mediciones se pueden exportar como métricas OTLP (Suma, Indicador, Histograma). Pueden existir otros orígenes de métricas OTLP. Las aplicaciones y bibliotecas pueden aportar una personalización a las métricas OTLP que producen. Para entender las métricas OTLP generadas y cómo personalizarlas, consulta la documentación de tu SDK OpenTelemetry o de la aplicación generadora de OTLP.

Nota: El protocolo OpenTelemetry admite dos formas de representar métricas en el tiempo: Temporalidad Acumulativa y Delta, que afectan a las métricas descritas a continuación. Configura la preferencia de temporalidad de la aplicación OpenTelemetry como DELTA, ya que configurarla como “ACUMULATIVA” puede descartar algunos puntos de datos durante el inicio de la aplicación (o del recopilador). Para obtener más información, consulta Generación de métricas de temporalidad Delta con OpenTelemetry.

Tipos de métricas

Asignación

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

Asignación de atributos

OTLP admite dos tipos de atributos: atributos a nivel de punto de datos y atributos de recursos. Estos atributos pueden seguir las convenciones semánticas de OpenTelemetry y tener una semántica bien conocida.

El Datadog Agent y el exportador Datadog del recopilador OpenTelemetry asignan los atributos de nivel de puntos de datos como etiquetas. Los atributos de recursos que siguen las convenciones semánticas de OpenTelemetry se asignan a las convenciones equivalentes de Datadog, si existen.

Puedes añadir todos los atributos de recursos como etiquetas utilizando la marca resource_attributes_as_tags.

Ejemplo

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:

Período de recopilaciónValores de contadorValor de la suma OTLPValor informado a DatadogTipo Datadog en aplicaciónNotas
#1[1,1,1,2,2,2,3,3]15NingunoRECUENTONo se indica el valor del primer periodo de recopilación.
#2[3,4,1,2]2510RECUENTOSe informa la diferencia entre los valores.
#3[]250RECUENTONo se informaron nuevos valores en este periodo.

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:

Período de recopilaciónValores de UpDownCounterValor de la suma OTLPValor informado a DatadogTipo Datadog en aplicación
#1[1,1,1,2,2,2,3,3]1515INDICADOR
#2[3,-4,1,2]1717INDICADOR
#3[-1]1616INDICADOR

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

Período de recopilaciónInstrumento indicadorValor del indicador OTLPValor informado a DatadogTipo Datadog en aplicación
#171.571.571.5INDICADOR
#2727272INDICADOR
#3707070INDICADOR

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:

Nombre de la métricaValorTipo Datadog en aplicación
avg:request.response_time.distribution1.73INDICADOR
count:request.response_time.distribution11RECUENTO
max:request.response_time.distribution3INDICADOR
min:request.response_time.distribution1INDICADOR
sum:request.response_time.distribution19RECUENTO

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:

Nombre de la métricaValorEtiquetasTipo Datadog en aplicación
request.response_time.distribution.count8n/aRECUENTO
request.response_time.distribution.sum15n/aRECUENTO
request.response_time.distribution.max3n/aINDICADOR
request.response_time.distribution.min1n/aINDICADOR
request.response_time.distribution.bucket6lower_bound:-inf, upper_bound:2INDICADOR
request.response_time.distribution.bucket2lower_bound:2, upper_bound:infINDICADOR

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:

Nombre de la métricaValorEtiquetasTipo Datadog en aplicación
request.response_time.distribution.count8n/aRECUENTO
request.response_time.distribution.sum15n/aRECUENTO
request.response_time.distribution.quantile1quantile:0INDICADOR
request.response_time.distribution.quantile2quantile:0.5INDICADOR
request.response_time.distribution.quantile3quantile:1.0INDICADOR

Leer más