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.
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)
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
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.
Les points de données par minute font référence au taux par minute auquel les valeurs métriques individuelles sont envoyées à l'API métrique.
Lorsque la limite DPM maximale est dépassée pour un compte, l'API métrique New Relic renvoie une réponse 429 pour le reste de la minute. La réponse inclura un en-tête Retry-After indiquant combien de temps attendre en secondes avant de soumettre à nouveau ou d'envoyer de nouvelles données.
Pour résoudre ce problème, réduisez le nombre de points de données que vous envoyez ou demandez une modification de la limite de débit. Les modifications d’abonnement ultérieures n’ont pas d’impact sur les limites de taux modifiées. Si un changement de compte a un impact sur votre limite de tarif, vous devez nous en informer pour ajuster votre limite de tarif.
Pour limiter les modifications des taux de requêtes, contactez votre représentant de compte New Relic ou visitez notre portail d'assistance.
Une série chronologique est une combinaison unique d'un nom métrique et de tout attribut attribué à cette métrique. Par exemple, si une métrique CPU utilization avec un seul attribut hostname est envoyée depuis dix hôtes différents, cela équivaut à dix valeurs distinctes pour l'attribut hostname et à dix séries temporelles métriques uniques.
Si la limite de série chronologique de métrique unique par compte et par jour (cardinalité) est dépassée au cours d'une période de 24 heures, le point de terminaison continuera à recevoir et à stocker des données de métrique brutes. Cependant, New Relic cessera de créer des cumuls agrégés supplémentaires (1 minute, 5 minutes, etc.) pour le reste de la période de 24 heures. (Ces cumuls sont utilisés par défaut pour interroger des fenêtres de temps supérieures à 60 minutes.)
Vous pouvez continuer à interroger vos données lorsqu'un tel incident se produit en spécifiant une fenêtre temporelle de 60 minutes ou moins ou en spécifiant le mot-clé RAW (pour en savoir plus, voir fortes cardinalités métriques). Cela peut être utile pour identifier les causes potentielles de l’incident.
Une série chronologique est une combinaison unique d'un nom métrique et de tout attribut attribué à cette métrique. Par exemple, si une métrique CPU utilization avec un seul attribut hostname est envoyée depuis dix hôtes différents, cela équivaut à dix valeurs distinctes pour l'attribut hostname et à dix séries temporelles métriques uniques.
Si la limite de série chronologique (cardinalité) de métrique unique par nom de métrique et par jour est dépassée au cours d'une période de 24 heures, le point de terminaison continuera de recevoir et de stocker des données de métrique brutes. Cependant, New Relic cessera de créer des cumuls agrégés supplémentaires (1 minute, 5 minutes, etc.) pour le reste de la période de 24 heures. (Ces cumuls sont utilisés par défaut pour interroger des fenêtres de temps supérieures à 60 minutes.)
Vous pouvez continuer à interroger vos données lorsqu'un tel incident se produit en spécifiant une fenêtre temporelle de 60 minutes ou moins ou en spécifiant le mot-clé RAW (pour en savoir plus, voir fortes cardinalités métriques). Cela peut être utile pour identifier les causes potentielles de l’incident.
Si vous effectuez plus de 100 000 requests POST aux points de terminaison d'API métriques en une minute, le point de terminaison renverra une réponse 429 pour le reste de la minute. La réponse inclura un en-tête Retry-After indiquant combien de temps attendre en secondes avant de soumettre à nouveau ou d'envoyer de nouvelles données.
En général, si vous atteignez cette limite, envisagez de créer une charge plus importante. Pour ce faire, combinez davantage de points de données dans chaque requête afin de réduire le nombre de POST nécessaires.
Si ce n'est pas une option, vous pouvez demander une augmentation de la limite de débit en contactant votre représentant de compte New Relic ou en visitant notre portail d'assistance.
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.