Te ofrecemos esta traducción automática para facilitar la lectura.
En caso de que haya discrepancias entre la versión en inglés y la versión traducida, se entiende que prevalece la versión en inglés. Visita esta página para obtener más información.
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.
Si el número está en el bloque común, se eliminará todo el bloque.
Si el número está en un punto de datos métrico, entonces se eliminará el punto de datos métrico en el que reside.
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.
Si el número está en el bloque común, se eliminará todo el bloque.
Si el número está en un punto de datos métrico, entonces se eliminará el punto de datos métrico en el que reside.
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 1.12345678901234567E18. Un doble puede contener un valor tan grande pero no tiene suficiente precisión para representarlo con exactitud (habría que redondearlo a 1.12345678901234573E18).
Si el número está en el bloque común, se eliminará todo el bloque.
Si el número está en un punto de datos métrico, entonces se eliminará el punto de datos métrico en el que reside.
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 (:), puntos (.) y guiones bajos (_).
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
Serie temporal máxima única de recuento y resumen (cardinalidad) por cuenta en un intervalo de 5 minutos
Una serie temporal es una combinación única y única de un nombre de métrica y cualquier atributo. Las series temporales recibidas por encima de este límite se eliminan. 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 API de métrica se aplican a nivel de cuenta individual. Los límites predeterminados para DPM y cardinalidad van desde 3 millones para organizaciones en nuestra edición gratuita, hasta 10,2 millones para algunas organizaciones de pago. Para comprender los límites de su organización, consulte la UIde límites. El DPM y la cardinalidad se pueden aumentar a 15 millones a petición de la organización que paga. La carga máxima por minuto se puede ajustar por encima de 100k según el caso. Para solicitar cambios en los límites de su tasa métrica, comuníquese 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.
Los puntos de datos por minuto se refieren a la velocidad por minuto a la que se envían los valores métricos individuales al API métrico.
Cuando se excede el límite máximo de DPM para una cuenta, la API métrica de New Relic devuelve una respuesta 429 durante el resto del minuto. La respuesta incluirá un encabezado Retry-After que indica cuánto tiempo esperar en segundos antes de volver a enviar o enviar nuevos datos.
Para resolver este problema, reduzca la cantidad de puntos de datos que envía o solicite un cambio en el límite de velocidad. Los cambios de suscripción posteriores no afectan los límites de tarifas modificados. Si un cambio de cuenta afecta su límite de tarifa, debe notificarnos para ajustar su límite de tarifa.
Para solicitar cambios en el límite de tarifas, comuníquese con su representante de cuenta de New Relic o visite nuestro portal de soporte.
Una serie temporal es una combinación única y única de un nombre de métrica y cualquier atributo asignado a esa métrica. Por ejemplo, si una CPU utilization métrica con un solo atributo hostname se envía desde diez hosts diferentes, esto equivale a diez valores distintos para el atributo hostname y diez series temporales de métricas únicas.
Si se excede el límite de serie temporal (cardinalidad) métrica única por cuenta y por día durante un período de 24 horas, el extremo continuará recibiendo y almacenando datos métricos sin procesar. Sin embargo, New Relic dejará de crear resúmenes agregados adicionales (1 minuto, 5 minutos, etc.) durante el resto del período de 24 horas. (Estos resúmenes se utilizan de forma predeterminada para consultar períodos de tiempo superiores a 60 minutos).
Puede continuar consultando sus datos cuando ocurra un incidente de este tipo especificando una ventana de tiempo de 60 minutos o menos o especificando la palabra clave RAW (para obtener más información al respecto, consulte Alta cardinalidad métrica). Esto puede resultar útil para identificar las posibles causas del incidente.
Una serie temporal es una combinación única y única de un nombre de métrica y cualquier atributo asignado a esa métrica. Por ejemplo, si una CPU utilization métrica con un solo atributo hostname se envía desde diez hosts diferentes, esto equivale a diez valores distintos para el atributo hostname y diez series temporales de métricas únicas.
Si se excede el límite de serie temporal (cardinalidad) métrica única por día y nombre por métrica durante un período de 24 horas, el extremo continuará recibiendo y almacenando datos métricos sin procesar. Sin embargo, New Relic dejará de crear resúmenes agregados adicionales (1 minuto, 5 minutos, etc.) durante el resto del período de 24 horas. (Estos resúmenes se utilizan de forma predeterminada para consultar períodos de tiempo superiores a 60 minutos).
Puede continuar consultando sus datos cuando ocurra un incidente de este tipo especificando una ventana de tiempo de 60 minutos o menos o especificando la palabra clave RAW (para obtener más información al respecto, consulte Alta cardinalidad métrica). Esto puede resultar útil para identificar las posibles causas del incidente.
Si realiza más de 100.000 solicitudes POST a los extremos métricos de API en un minuto, el extremo devolverá una respuesta 429 durante el resto del minuto. La respuesta incluirá un encabezado Retry-After que indica cuánto tiempo esperar en segundos antes de volver a enviar o enviar nuevos datos.
En general, si alcanzas este límite, considera crear una carga mayor. Para hacer esto, combine más puntos de datos en cada solicitud para reducir la cantidad de POST necesarios.
Si esta no es una opción, puede solicitar un aumento del límite de tarifa comunicándose con su representante de cuenta de New Relic o visitando nuestro portal de soporte.
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
newrelic.source
Esto se restablece al valor metricAPI.
metricName
Esto se restablece al valor name pasado a cada punto de datos. Esto permite que name sea una clave de atributo.
endTimestamp
timestamp y interval.ms se convertirá en endTimestamp para el punto de datos.
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
entity.guid
Identificador único asignado a una entidad por New Relic.
entity.name
Nombre legible por humanos de una entidad, que a menudo se usa para identificar una entidad en la UI.
entity.type
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 service.errors.all y hay un atributo service.errors.all.
Example: Metric value used as an attribute (invalid)
[
{
"metrics":[
{
"name":"service.errors.all",
"type":"count",
"value":15,
"timestamp":1531414060739,
"interval.ms":10000,
"attributes":{
"service.response.statuscode":"400",
"service.errors.all":"test",
"service.name":"foo"
}
}
]
}
]
Palabras reservadas
Evite el uso de palabras reservadas, como accountId, appId y eventType. También debe evitar el uso de términos de sintaxis NRQL a menos que los escriba (``).
Claves dentro de la métrica JSON
Todas las claves utilizadas dentro del JSON métrico no pueden ser claves de atributo. Esto incluye interval.ms, timestamp, value, common, min, max, count, sum y metrics.
Exception: Puede utilizar name como clave de atributo.
Valores métricos restringidos
Cualquier dato de métrica enviado a la API de métrica con un value igual a NaN (no un número), positive infinity o negative infinity se eliminará.