• /
  • EnglishEspañolFrançais日本語한국어Português
  • Se connecterDémarrer

Cette traduction automatique est fournie pour votre commodité.

En cas d'incohérence entre la version anglaise et la version traduite, la version anglaise prévaudra. Veuillez visiter cette page pour plus d'informations.

Créer un problème

Limites de l'API métrique et attribut restreint

Ce document décrit les exigences en matière de données pour l' API métrique, notamment :

  • Limites maximales
  • Attribut restreint
  • Valeurs métriques restreintes

Limites maximales

Les limites par défaut suivantes s'appliquent à toutes les données métriques :

Condition

Limite

Tranche d'âge pour les valeurs d'horodatage

Les métriques rapportées avec un horodatage datant de plus de 48 heures ou de plus de 24 heures à compter du moment où elles sont rapportées sont supprimées.

Nombre maximal de points de données par minute (DPM)

3 à 15 millions de DPM (en savoir plus)

Nombre maximal de séries temporelles uniques (cardinalité) par compte et par jour

1 à 15 millions (en savoir plus)

Une série chronologique est une combinaison unique d'un nom métrique et de n'importe quel attribut.

Nombre maximal de séries temporelles uniques (cardinalité) par nom de métrique et par jour

100 000

Charge maximale par minute

100k (en savoir plus)

Attribut max par métrique

100

Longueur maximale du nom de l'attribut métrique

255 caractères

Nombre maximal de caractères pour une clé d'attribut

255 caractères

Longueur maximale de la valeur d'attribut métrique

4096 caractères

Protocoles HTTP autorisés

HTTPS uniquement

Valeurs longues numériques se situant en dehors des valeurs longues Java minimales ou maximales

Les valeurs numériques longues qui ne correspondent pas à la valeur longue Java minimale ou maximale seront rejetées.

  • Si le numéro se trouve dans le bloc commun, le bloc entier sera supprimé.
  • Si le nombre se trouve dans un point de données métrique, le point de données métrique dans lequel il réside sera supprimé.

Valeurs doubles numériques se situant en dehors des valeurs doubles Java minimales ou maximales

Les valeurs doubles numériques qui se situent en dehors d'une valeur double Java minimale ou maximale seront rejetées.

  • Si le numéro se trouve dans le bloc commun, le bloc entier sera supprimé.
  • Si le nombre se trouve dans un point de données métrique, le point de données métrique dans lequel il réside sera supprimé.

Valeurs doubles numériques qui nécessitent un arrondi pour être converties en un nombre à virgule flottante double précision.

Les valeurs numériques doubles qui nécessitent un arrondi pour être converties en un nombre à virgule flottante double précision seront rejetées.

Un exemple de ceci est 1.12345678901234567E18. Un double peut contenir une valeur aussi grande mais il n'a pas assez de précision pour la représenter avec précision (il faudrait l'arrondir à 1.12345678901234573E18).

  • Si le numéro se trouve dans le bloc commun, le bloc entier sera supprimé.
  • Si le nombre se trouve dans un point de données métrique, le point de données métrique dans lequel il réside sera supprimé.

Taille de la charge utile

Taille ou longueur maximale totale : 1MB (10^6 bytes) maximum per POST. Nous vous recommandons fortement d'utiliser la compression.

Format de charge utile

La charge utile doit être codée comme UTF-8.

syntaxe de dénomination des attributs

Les noms d'attributs peuvent être une combinaison de caractères alphanumériques, de deux points (:), de points (.) et de traits de soulignement (_).

Les limites par défaut suivantes s'appliquent uniquement aux données collectées via l'intégration Prometheus Remote Write :

Condition

Limite

Nombre maximal de séries chronologiques uniques de décompte et de résumé (cardinalité) par compte par intervalle de 5 minutes

1 à 15 millions (en savoir plus)

Une série chronologique est une combinaison unique d'un nom métrique et de n'importe quel attribut. Les séries chronologiques reçues au-dessus de cette limite sont supprimées. Cette limite est appliquée avant et en plus des limites métriques standard.

Conditions de compte supplémentaires

Les limites de l'API métrique s'appliquent au niveau du compte individuel. Les limites par défaut pour le DPM et la cardinalité vont de 3 M pour l'organisation sur notre édition gratuite, jusqu'à 10,2 M pour certaines organisations payantes. Pour comprendre les limites de votre organisation, consultez l' UILimites. Le DPM et la cardinalité peuvent être augmentés jusqu'à 15 M sur demande pour l'organisme payant. Le tarif maximum par minute peut être ajusté au-dessus de 100 000 au cas par cas. Pour demander des modifications à vos limites de taux métriques, contactez votre représentant de compte New Relic ou visitez notre portail d'assistance.

Limite de taux d'incident

Cette section décrit comment l'API métrique se comporte lorsque vous dépassez les limites de débit et comment réagir si les limites sont dépassées.

Attribut restreint

Ces attributs sont restreints par la plateforme New Relic. Toutes les valeurs soumises avec ces clés dans la section d'attribut d'un point de données métrique entraîneront la suppression du point de données ou l'omission ou l'écrasement de la valeur :

Attribut

Description

newrelic.source

Cela réinitialise à la valeur metricAPI.

metricName

Cela réinitialise la valeur name transmise à chaque point de données. Cela permet name d’être une clé d’attribut.

endTimestamp

timestamp et interval.ms sera converti en endTimestamp pour le point de données.

Ces attributs sont utilisés en interne pour identifier l'entité. Toutes les valeurs soumises avec ces clés dans la section d'attribut d'un point de données métrique peuvent provoquer un comportement indéfini tel qu'une entité manquante dans l'UI ou une télémétrie ne s'associant pas à l'entité attendue. Pour plus d'informations, veuillez vous référer à la synthèse d'entité:

Attribut

Description

entity.guid

Identifiant unique attribué à une entité par New Relic.

entity.name

Nom lisible par l'homme d'une entité, souvent utilisé pour identifier une entité dans l'UI.

entity.type

Utilisé pour différencier les différents types d'entités, comme les hôtes, les applications, etc.

Les restrictions supplémentaires incluent :

Restriction

Commentaires

métrique et noms d'attributs

Vous ne pouvez pas transmettre la même valeur pour le nom de la métrique et le nom de l'attribut.

Dans l'exemple suivant, la métrique n'est pas valide car elle est nommée service.errors.all et il existe un attribut 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"
}
}
]
}
]

Mots réservés

Évitez d’utiliser des mots réservés, tels que accountId, appId et eventType. Vous devez également éviter d'utiliser les termes de syntaxe NRQL, sauf si vous les mettez entre guillemets (``).

Clés dans la métrique JSON

Toutes les clés utilisées dans la métrique JSON ne peuvent pas être des clés d’attribut. Cela inclut interval.ms, timestamp, value, common, min, max, count, sum et metrics.

Exception: Vous pouvez utiliser name comme clé d’attribut.

Valeurs métriques restreintes

Toutes les données métriques soumises à l'API métrique avec un value égal à NaN (pas un nombre), positive infinity ou negative infinity seront supprimées. Des valeurs non finies peuvent provoquer l'apparition de NrIntegrationError événement.

Droits d'auteur © 2025 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.