año constante de exportación = 2023; export const gaDate = '4 de abril'; exportar const gaDateAndYear = gaDate + ', ' + año;
OpenTelemetry métrica es ampliamente compatible con New Relic dimensional métrica. Soportamos OpenTelemetry métrica v0.10. Todos los tipos métricos admitidos incluyen un conjunto independiente de atributos asociados (pares nombre-valor) que se asignan directamente a dimensiones que puede utilizar para facetar o filtrar datos métricos en el momento de la consulta. Las métricas de OpenTelemetry van acompañadas de un conjunto de atributos de recursos que identifican la entidad de origen que las produjo y las asignan a dimensiones para facetado y filtrado.
El modelo de datos de OpenTelemetry para métrica define varios tipos de métricas diferentes: suma, medidor, histograma y resumen.
Suma métrica
Las sumas de OpenTelemetry son una métrica escalar que es la suma de todos los puntos de datos durante un período de tiempo determinado. Las sumas tienen una noción de temporalidad que indica si los valores reportados incorporan mediciones anteriores (temporalidad acumulativa) o no (temporalidad delta).
Además, las sumas pueden ser monótonas (sólo suben o sólo bajan) o no monótonas (suben y bajan).
Sumas delta
Las sumas delta se manejan de manera diferente dependiendo de si son monótonas o no monótonas:
- Las sumas delta monótonas se asignan al tipo de métrica de recuento .
- No se admiten sumas delta no monótonas. Las cosas medidas de esta manera no generan datos significativos, ya que lo más probable es que se sumen para su uso. Para obtener más información, consulte esta solicitud de extracción de la comunidad [la] y nuestros documentos sobre medidor versus contadores.
Sumas acumuladas
Las sumas acumuladas se manejan de manera diferente dependiendo de si son monótonas o no monótonas.
- Las sumas acumulativas no monótonas se asignan al tipo métrico medidor .
- Las sumas acumulativas monótonas se asignan a nuestro tipo de métrica cumulativeCount .
Ejemplos de configuración de suma
Para comprender cómo configurar la temporalidad de agregación, consulte estos ejemplos utilizando los SDK de OpenTelemetry de Java y Python .
Medidor metrico
Los puntos de datos del medidor métrico de OpenTelemetry representan un valor muestreado en un momento dado. Estos valores se convierten al tipo métrico del medidor New Relic. El medidor OpenTelemetry no tiene una temporalidad de agregación, pero los valores muestreados se pueden agregar en el momento de la consulta.
Histograma métrico
El histograma de OpenTelemetry representa de forma compacta una población de valores registrados junto con un recuento total y una suma. Opcionalmente, el histograma puede incluir una serie de depósitos con límites explícitos y un valor de recuento para la población de ese depósito.
Todos los histogramas de OpenTelemetry se convierten al tipo de métrica de distribución de New Relic, que está respaldado por un histograma exponencial escalado de base 2 (consulte NrSketch para obtener una explicación más detallada).
Histograma delta
Para histograma exponencial, podemos hacer una traducción directa a NrSketch.
Para histogramas de límites explícitos, los recuentos de los depósitos de histograma de OpenTelemetry se asignan a los depósitos métricos de distribución de New Relic mediante interpolación lineal. Además, OpenTelemetry tiene depósitos con límite infinito negativo y positivo que representamos en New Relic como depósitos de ancho cero. Hacemos esto porque no tenemos una representación para el infinito negativo y positivo. Por ejemplo, un depósito de OpenTelemetry con límites \[-∞, 10)
se representará mediante un depósito New Relic de ancho cero \[10,10)
. Es posible que vea recuentos de depósitos exagerados en el extremo de su distribución debido a esta traducción.
Histograma acumulativo
Los histogramas acumulativos se convierten en un histograma Delta. Para más información sobre el proceso de traducción, consulte Métrica acumulativa.
Resumen métrica
Los puntos de datos métricos de resumen de OpenTelemetry se utilizan para representar resúmenes de cuantiles (por ejemplo, latencia P99). Estos se asignan directamente al tipo de métrica de resumen de New Relic; sin embargo, los únicos cuantiles que mantenemos son los cuantiles 0,0 y 1,0 para el mínimo y el máximo. Si el percentil es algo que desea capturar, prefiera Histograma métrico.
Los puntos de datos métricos resumidos incluyen valores de recuento, suma y cuantiles, con 0,0 como mínimo y 1,0 como máximo. OpenTelemetry proporciona un resumen métrico para compatibilidad con otros formatos.
Hora de inicio
El campo startTimeUnixNano
es opcional según la especificación de OpenTelemetry. Para la temporalidad de agregación delta, cuando está presente, se utiliza para la timestamp en la métrica New Relic resultante y el duration
se calcula como timeUnixNano - startTimeUnixNano
. El campo duration
se utiliza para calcular el atributo consultable endTimeStamp
en la métrica New Relic, pero no tiene ningún otro propósito semántico.
Si no se proporciona startTimeUnixNano
, entonces se utiliza timeUnixNano
para el campo timestamp en la métrica New Relic resultante y el campo de duración se establece en cero.
Para la temporalidad de agregación acumulativa, startTimeUnixNano
representa la primera observación de la serie temporal y se utiliza para detectar restablecimientos. timeUnixNano
se interpreta como la timestamp del punto de datos acumulativo. Los puntos de datos acumulativos se convierten luego en temporalidad de agregación delta.
Valores de matriz para atributo
OpenTelemetry métrica y otras señales pueden incluir atributos que constan de una matriz homogénea de tipos primitivos. New Relic admite matrices homogéneas no anidadas con menos de 65 elementos.
Ejemplares
OpenTelemetry define valores ejemplares que permiten que otras señales, como traza, se conecten a un evento métrico y proporcionen contexto. New Relic no admite ejemplares.
Cómo consultar métrica
Considere estos consejos para crear una consulta métrica NRQL en New Relic.
Consulta sumas acumuladas almacenadas como acumulativeCounts
A continuación te indicamos algunas formas de consultar tus datos:
Consultar sumas acumuladas almacenadas como medidor
Los clientes de New Relic que informaron sumas acumuladas antes de gaDateAndYear, convierten sus sumas acumuladas a nuestro tipo gauge
.
Si sus sumas acumuladas se almacenan como del tipo gauge
, aquí hay algunas formas de consultar sus datos:
Consulta medidor metrico
Cuando New Relic convierte sumas acumuladas a medidor, puedes consultarlas usando las funciones latest()
o derivative()
NRQL. La función que elija depende de si desea ver el valor bruto o calcular la tasa de cambio.
Consulta histograma métrica
El histograma New Relic traducido de OpenTelemetry métrica tiene la misma semántica de consulta que otros histogramas New Relic. Es decir, la función histogram()
NRQL se puede utilizar para representar el histograma con un número configurable de depósitos y un ancho de depósito. Traducimos el histograma acumulativo a histograma delta, por lo que se consultan de la misma manera que se consultaría un histograma delta. Tenga en cuenta que para el histograma de límites explícitos, es posible que vea recuentos de depósitos más grandes en los depósitos extremos. Esto se debe a que estamos agregando depósitos de OpenTelemetry con límite infinito negativo y positivo en un depósito New Relic de ancho cero.
Importante
La palabra clave TIMESERIES
no es compatible con el histograma de New Relic a menos que charle percentiles()
.