Métricas de OpenTelemetry en New Relic

OpenTelemetry proporciona un modelo de datos métrico dimensional, una API para registrar telemetría métrica y un SDK para agregar y exportar datos métricos.

Esta página describe cómo New Relic maneja OpenTelemetry métrica que recibe a través del extremo OTLPNew Relic . La integración de OpenTelemetry métrica con New Relic requiere configurar la fuente métrica para exportar a este extremo; revise los requisitos de configuración del extremo. Para información sobre la configuración de servicios con OpenTelemetry métrica consulte OpenTelemetry APM monitoreo.

Tipo de instrumento para mapeo tipo métrica

La OpenTelemetry métrica API define varios tipos de instrumentos. mediciones de registro instrumentado, que se agregan y exportan a través de OTLP como un tipo métrico particular. La siguiente tabla describe el comportamiento predeterminado sobre cómo cada instrumento OpenTelemetry agrega y exporta. Consulte OTLP métrica mapeo para obtener detalles sobre cómo se trata cada tipo de métrica en New Relic.

Consulte las pautas complementariasOpenTelemetry métrica para obtener detalles sobre cómo elegir el tipo de instrumento correcto.

[1] El histograma instrumentado también se puede agregar al histograma métrico exponencial. Consulte el histograma métrico de OTLP para obtener más detalles.

Mapeo de métrica OTLP

New Relic asigna OTLP métrica al tipo de datosMetric . La siguiente tabla describe cómo se interpretan los campos de los protomensajes métricos. Consulte tipo de instrumento a tipo métrico para obtener detalles sobre cómo los SDK/OpenTelemetry API producen los distintos tipos de métrica.

[1]: En caso de conflicto en los campos atributo de recurso, atributo alcance, atributo punto métrico y campos métricos de nivel superior, el orden de precedente (de mayor a menor) es: campos Metric.* de nivel superior > Metric.*.data_points.attributes > ScopeMetrics.InstrumentationScope.attributes > ResourceMetrics.Resource.attributes.

Métrica OTLP sum

OTLP suma métrica representa la suma de medidas a lo largo del tiempo. Las sumas incluyen un campo aggregation_temporality y un campo is_monotonic , que indica si los valores aumentan monótonamente (es decir, solo pueden subir) o no (es decir, pueden subir y bajar). La siguiente tabla describe cómo New Relic trata las diferentes variedades de suma:

Histograma métrico OTLP

El histograma métrico OTLP y el histograma métrico exponencial resumen una población de mediciones con información como suma, recuento, mínimo, máximo y depósitos que describen la distribución de los valores de medición. La variedad de histograma (también llamado histograma de depósito explícito) tiene depósitos con límites explícitos. La variedad exponencial tiene categorías con límites descritos por una fórmula exponencial. Ambas variedades incluyen un campo de temporalidad de agregación.

Ambas variedades de histograma se traducen a New Relic distribution, que está respaldado por una representación interna de histograma exponencial de base 2. Esta representación refleja fielmente el formato de histograma exponencial de OpenTelemetry. Por esta razón, New Relic prefiere el histograma exponencial (consulte Agregación de mistogramas métricos para obtener detalles sobre cómo configurar OTLP para preferir el histograma exponencial). La variedad de histograma de depósito explícito de OpenTelemetry se traduce a la representación exponencial mediante interpolación lineal. Consulte NrSketch para obtener una explicación detallada.

Los depósitos con límites en el infinito negativo y positivo se representan en New Relic como depósitos de ancho cero. Por ejemplo, un depósito de OpenTelemetry con límites [-∞, 10) se representa en New Relic como [10, 10). Como resultado, es posible que vea recuentos de depósitos exagerados al final de su distribución.

Métrica de resumen OTLP

Las métricas resumidas de OTLP son similares al histograma en que resumen una población de medidas, incluida la suma y el conteo. Sin embargo, cuando los histogramas incluyen categorías para describir la distribución de las mediciones, los resúmenes incluyen cuantiles. Estos cuantiles son de uso limitado ya que no pueden sufrir reagregación espacial o temporal. Los resúmenes incluidos en OpenTelemetry para legacy soporte , y OpenTelemetry API y el SDK no producen resúmenes.

Los resúmenes están traducidos a New Relic summary.

Temporalidad de agregación

La OpenTelemetry noción de temporalidad de agregación define si un punto de datos métrico individuo agrega un conjunto acumulativo de mediciones (generalmente desde el inicio de la aplicación) o el conjunto delta de mediciones desde la última exportación. OTLP sum métrica y histograma métrica tienen un campo aggregation_temporality que describe la semántica de sus puntos.

Aunque aceptamos tanto la temporalidad métrica acumulativa como la delta, New Relic es generalmente un sistema delta métrica, y recomendamos al usuario que configure su exportador OTLP para que prefiera la temporalidad delta.

Cuando la temporalidad es acumulativa, las métricas se convierten en una representación delta (con el valor acumulativo retenido para cumulativeCount, el uso de una traducción con estado es un proceso con estado en el que se calcula el delta a partir de dos puntos acumulativos consecutivos del mismo serial. El Metric.*.data_points.start_time_unix_nano se emplea para detectar reinicios de seriales.

Apoyo de ejemplares

Ejemplares métricos de OpenTelemetry no son actualmente compatibles con New Relic.