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 OTLP New Relic . Vea las siguientes páginas:
- Para conocer los requisitos de configuración del extremo, consulte Extremo OTLP New Relic .
- Para obtener instrucciones sobre cómo configurar servicios con OpenTelemetry, consulte MonitoreoOpenTelemetry APM .
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.
Tipo de instrumento | Uso de ejemplo | Agregación predeterminada | Tipo de métrica exportada |
|---|---|---|---|
Bytes procesados |
| ||
Observe el tiempo total de CPU del proceso |
| ||
Artículos en una cola |
| ||
Observe el uso actual de la memoria |
| ||
Duración de las solicitudes http | |||
Cambiar evento para la velocidad del ventilador de la CPU | |||
Observe la temperatura ambiente actual |
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 mensajes del proto métrica . Consulte el tipo de instrumento a tipo métrica para obtener detalles sobre cómo los diversos tipos de métricas son producidos por OpenTelemetry API y los SDK .
Protocampo métrico OTLP | Campo New Relic |
|---|---|
| Cada valor principal es un atributo en el |
|
|
|
|
| Cada valor principal es un atributo en el |
|
|
|
|
|
|
|
|
|
|
| Cada valor principal es un atributo en el |
| Mapas de New Relic |
| Mapas de New Relic |
| Mapas de New Relic |
| Mapas de New Relic |
| Mapas de New Relic |
[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.
Consulta los tipos de atributos OTLP para obtener detalles sobre los tipos de atributos compatibles con OTLP extremo New Relic .
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:
|
| Comportamiento |
|---|---|---|
|
| Mapas de New Relic |
|
| Mapas de New Relic |
|
| Mapas de New Relic |
|
| No se admite porque los datos no son significativos. Vea esta discusión para más detalles. |
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
Los resúmenes métricos de OTLP son similares al histograma en que resumen una población de mediciones, incluida la suma y el recuento. Sin embargo, cuando el histograma incluye segmentos 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. Resúmenes incluidos en OpenTelemetry para legacy soporte , y OpenTelemetry API y el SDK no producen resúmenes.
Los resúmenes se traducen a New Relic summary. Tenga en cuenta que el tipo de resumen New Relic no admite cuantiles.
Importante
Si bien los resúmenes se ingieren y traducen a un New Relic summary, no reciben el soporte adecuado. New Relic asume que los resúmenes representan un delta desde la última medición cuando en realidad son métricas acumulativas (ver temporalidad de agregación). Los resúmenes son emitidos más comúnmente por Prometheus, que es un sistema métrico acumulativo. Por lo tanto, New Relic actualmente no admite el caso de uso más común. Como tal, experimentará un comportamiento inesperado para su métrica de resumen, incluida una ingesta fallida.
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.