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 :
- API d'agent
- API d'événement (des exigences supplémentaires sont requises lors de l'utilisation de l'API d'événement.)
- API d'agent et (Il existe des exigences supplémentaires avec l'événement personnalisé
PageAction
.) - monitoring des applications mobiles SDK
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é :
|
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 ( 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.
Important
Ceci n'est pas une liste complète. En général, évitez d'utiliser des mots réservés à MySQL pour éviter toute collision avec les futures fonctionnalités de New Relic.
Keyword | Description |
---|---|
| Il s'agit d'un nom d'attribut réservé. S'il est inclus, il sera supprimé lors de l'ingestion. |
| 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. |
| Le type d'événement tel que stocké dans New Relic. Les agents et scripts New Relic signalent normalement cela comme |
Valeurs | Pour votre valeur
|
| 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 : |
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,
|
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