Este documento describe los requisitos de datos para la API métrica, incluyendo:
- Límites máximos
- Atributo restringido
- Valores métricos restringidos
Límites máximos
Los siguientes límites predeterminados se aplican a todos los datos métricos:
Condición | Límite |
---|---|
Rango de edad para valores timestamp | Métrica reportados con una timestamp anterior a 48 horas o posterior a 24 horas desde el momento en que se informan se eliminan. |
Puntos de datos máximos por minuto (DPM) | 3-15 millones de DPM (más información) |
Máximo serial temporal única (cardinalidad) por cuenta por día | 1-15 millones (más información) Un serial temporal es una combinación única y única de un nombre de métrica y cualquier atributo. |
Máximo serial temporal única (cardinalidad) por nombre de métrica por día | 100k |
Carga máxima por minuto | 100k (más información) |
Atributo máximo por métrica | 100 |
Longitud máxima del nombre del atributo de métrica | 255 caracteres |
Caracteres máximos para una clave de atributo | 255 caracteres |
Longitud máxima del valor del atributo de métrica | 4096 caracteres |
Protocolos HTTP permitidos | Solo HTTPS |
Valores largos numéricos que quedan fuera de los valores largos mínimos o máximos de Java | Se rechazarán los valores largos numéricos que queden fuera del valor largo mínimo o máximo de Java.
|
Valores dobles numéricos que quedan fuera de los valores dobles mínimos o máximos de Java | Se rechazarán los valores dobles numéricos que queden fuera del valor doble mínimo o máximo de Java.
|
Valores numéricos dobles que requieren redondeo para convertirse en un número de coma flotante de doble precisión. | Se rechazarán los valores numéricos dobles que requieran redondeo para convertirlos en un número de coma flotante de doble precisión. Un ejemplo de esto es
|
Tamaño de carga útil | Tamaño o longitud máxima total: 1MB (10^6 bytes) maximum per POST. Recomendamos encarecidamente utilizar compresión. |
Formato de carga útil | La carga útil debe codificarse como UTF-8. |
Sintaxis de nomenclatura de atributos | Los nombres de atributos pueden ser una combinación de caracteres alfanuméricos, dos puntos ( |
Los siguientes límites predeterminados se aplican solo a los datos recopilados a través de la integración de escritura remota de Prometheus:
Condición | Límite |
---|---|
Máximo recuento único y seriales de tiempo de resumen (cardinalidad) por cuenta por intervalo de 5 minutos | 1-15 millones (más información) Un serial temporal es una combinación única y única de un nombre de métrica y cualquier atributo. Los seriales de tiempo recibidas por encima de este límite se descartan. Este límite se aplica antes y además de los límites métricos estándar. |
Condiciones adicionales de la cuenta
Los límites de la API métrica se aplican a nivel de cuenta individual. Los límites predeterminados para DPM y cardinalidad varían desde 3M para organizaciones en nuestra edición gratis, hasta 10,2M para algunas organizaciones pagas. Para comprender los límites de su organización, consulte la UIde Límites. El DPM y la cardinalidad se pueden aumentar hasta 15M a solicitud de la organización pagadora. La carga máxima por minuto se puede ajustar por encima de 100k caso por caso. Para aplicar cambios en los límites de su tasa métrica, comunicar con su representante de cuenta de New Relic o visite nuestro portal de soporte.
Incidencia límite de tarifa
Esta sección describe cómo se comporta la API de métrica cuando se exceden los límites de velocidad y cómo responder si se exceden los límites.
Atributo restringido
Estos atributos están restringidos por la plataforma New Relic. Cualquier valor enviado con estas claves en la sección de atributos de un punto de datos métrico hará que el punto de datos se elimine, o que el valor se omita o se sobrescriba:
Atributo | Descripción |
---|---|
| Esto se restablece al valor |
| Esto se restablece al valor |
|
|
Estos atributos se utilizan internamente para identificar la entidad. Cualquier valor enviado con estas claves en la sección de atributos de un punto de datos métrico puede causar un comportamiento indefinido, como la falta de entidad en la UI o la telemetría que no se asocia con la entidad esperada. Para obtener más información, consulte la síntesis de entidades:
Atributo | Descripción |
---|---|
| Identificador único asignado a una entidad por New Relic. |
| Nombre legible por humanos de una entidad, que a menudo se usa para identificar una entidad en la UI. |
| Se utiliza para diferenciar entre diferentes tipos de entidades, como hosts, aplicaciones, etc. |
Las restricciones adicionales incluyen:
Restricción | Comentarios |
---|---|
Nombres métricos y de atributos | No puede pasar el mismo valor para el nombre de la métrica y el nombre del atributo. En el siguiente ejemplo, la métrica no es válida porque la métrica se llama Example: Metric value used as an attribute (invalid)
|
Palabras reservadas | Evite emplear palabras reservadas, como |
Claves dentro de la métrica JSON | Todas las claves utilizadas dentro del JSON métrico no pueden ser claves de atributo. Esto incluye Exception: Puede utilizar |
Valores métricos restringidos
Cualquier dato métrico enviado a la API métrica con un value
igual a NaN
(no un número), positive infinity
o negative infinity
será descartado. Los valores no finitos pueden provocar que se emita el evento NrIntegrationError
.