• /
  • 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

Exigences et limites en matière de données pour les données d'événement personnalisé

Ce document contient les exigences générales et les règles d'insertion et d'utilisation d'événements personnalisés et de leurs attributs associés. Des exigences supplémentaires peuvent s’appliquer en fonction de la méthode utilisée.

Vous pouvez signaler un événement personnalisé à New Relic de plusieurs manières, notamment :

Exigences générales

Lorsque vous signalez un événement personnalisé et un attribut, suivez ces exigences générales concernant les types de données pris en charge, la syntaxe de dénomination et la taille :

Exigence

Description

Payload

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

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

L'API événement a des limites de débit HTTP supplémentaires.

Types de données d'attribut

Les valeurs d'attribut peuvent être soit une chaîne, soit un entier numérique ou un flottant. Pour plus d'informations sur le formatage des données de date et d'heure, voir Date/heure personnalisées.

limites d'attribut

Longueur maximale du nom de l'attribut : 255 caractères.

Longueur maximale des valeurs de l'attribut personnalisé :

  • Pour un événement envoyé via l'API événement: 4096 caractères

  • Pour un événement envoyé via des agents : 255 caractères

    Attribut total maximum par événement : 254. Exception: Si vous utilisez une API d’agent APM, le maximum est de 64.

    Attribut total maximum par type d'événement : 48 000.

    Important

    Les graphiques ne peuvent afficher que les 255 premiers caractères des valeurs d'attribut. Pour obtenir des valeurs d'attribut complètes, utilisez le type de graphique JSON ou l'API de requête.

Syntaxe de dénomination pour l'événement et l'attribut

Les noms d'événements peuvent être une combinaison de caractères alphanumériques, de deux points (:) et de traits de soulignement (_). Les noms d'attributs peuvent inclure ceux-ci ainsi que des points (.) et des barres obliques (/).

Nous vous recommandons de commencer les noms par une lettre : s'ils commencent par autre chose, vous devrez mettre des guillemets inversés autour du nom lors de la requête. Pour en savoir plus sur le moment où les guillemets inversés sont requis dans une requête, consultez la référence NRQL.

N'utilisez pas de mots réservés à l'usage de NRQL.

Longueur maximale du nom de l'événement : 255 caractères.

Valeurs nulles

La base de données ne stocke aucune donnée avec une valeur nulle.

Mots réservés

Évitez d’utiliser les mots réservés suivants comme noms d’événement et d’attribut. Dans le cas contraire, des résultats inattendus peuvent survenir.

Keyword

Description

accountId

Il s'agit d'un nom d'attribut réservé. S'il est inclus, il sera supprimé lors de l'ingestion.

appId

La valeur doit être un entier. S'il ne s'agit pas d'un entier, le nom et la valeur de l'attribut seront supprimés lors de l'ingestion.

eventType

Le type d'événement tel que stocké dans New Relic. Les agents et scripts New Relic signalent normalement cela comme eventType. Peut être une combinaison de caractères alphanumériques, de deux points (:) et de traits de soulignement (_). Assurez-vous de vérifier les valeurs eventType interdites et les limiteseventType .

Valeurs eventType interdites

Pour votre valeur eventType, évitez d'utiliser :

  • Metric, MetricRaw et les chaînes préfixées par Metric[0-9] (telles que Metric2 ou Metric1Minute).

  • Entity, EntityUpdate et les chaînes préfixées par Entity[0-9] (telles que Entity2 ou Entity1HOUR).

  • EntityRelationship, RelationshipUpdate et les chaînes préfixées par Relationship[0-9] (telles que Relationship2 ou Relationship1HOUR)

  • Public_ et les chaînes préfixées par Public_.

    Ces types d'événements sont réservés à l'usage de New Relic. l'événement transmis avec ces valeurs eventType sera supprimé.

timestamp

Doit être un horodatage d'époque Unix. Vous pouvez définir l'horodatage soit en secondes, soit en millisecondes. Il doit être +/-1 jour (24 heures) de l'heure actuelle sur le serveur.

conditions de transfert de logs

Les clés suivantes sont réservées par la fonctionnalité de transfert de log de l'agent d'infrastructure : entity.guid, log, hostname, plugin.type, fb.input.S'ils sont utilisés, ils sont supprimés lors de l'ingestion et un avertissement est ajouté au log.

Termes de syntaxe NRQL

Si vous devez utiliser des termes de syntaxe NRQL comme noms d'attribut, y compris des attributs en pointillés, ils doivent être placés entre guillemets inversés ; par exemple, `LIMIT` ou `consumer.offset`. Sinon, évitez d’utiliser ces mots réservés :

ago, and, as, auto,

begin, begintime,

compare,

day, days,

end, endtime, explain,

facet, from,

hour, hours,

in, is,

like, limit,

minute, minutes, month, months,

not, null,

offset, or,

raw,

second, seconds, select, since,

timeseries,

until,

week, weeks, where, with

limites du type d'événement

La limite actuelle pour le nombre total de valeurs eventType est de 250 par compte (et non par organisation) sur une période donnée de 24 heures. Si un compte dépasse cette limite, New Relic peut filtrer ou supprimer des données. Les types d’événements incluent :

  • Événement par défaut des agents New Relic et intégration
  • événement personnalisé des agents ou
  • événement personnalisé depuis l'API é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.