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.
Si vous disposez d'APM, vous pouvez signaler des données d'événements personnalisées. Vous pouvez ensuite interroger et visualiser vos données dans New Relic.
Considérations relatives aux données
Les agents New Relic envoient des données d'événement à New Relic dans le cadre du cycle de collecte normal toutes les cinq secondes pour les versions d'agent prenant en charge le streaming en temps réel.
L'envoi d'un grand nombre d'événements peut augmenter la charge mémoire de l'agent. New Relic impose une limite supérieure de 833 événements personnalisés toutes les 5 secondes. De plus, les publications d'une taille supérieure à 1 Mo (10^6 octets) ne seront pas enregistrées, quelle que soit la limite de l'événement personnalisé.
Vous pouvez également envoyer des événements personnalisés en utilisant l' API d'événements (sans avoir besoin d'APM). Cependant, sachez que les événements personnalisés envoyés avec l'API d'agent ne sont pas compatibles avec le mode haute sécurité.
Pour enregistrer un événement personnalisé, suivez les procédures de votre agent de langue New Relic. Pour ajouter un attribut personnalisé à l'événement APM, vous devez d'abord les activer pour votre agent APM, puis effectuer un appel d'API pour enregistrer l'attribut. Suivez les procédures personnalisées des attributs spécifiques à l'agent.
Lors de la création de votre propre événement personnalisé et de vos attributs, suivez les exigences en matière de données pour :
Pour ajouter un événement personnalisé au moniteur d'applications par l'agent Go, utilisez RecordCustomEvent. Vous pouvez ensuite ajouter des attributs personnalisés pour votre application Go.
La collection événement personnalisé est activée par défaut dans la version 3.13.0 ou supérieure de l'agent Java . Pour envoyer un événement personnalisé, appelez recordCustomEvent. Par exemple:
Le premier argument définit le nom de votre type d'événement, et le deuxième argument est une carte avec l'attribut de votre événement personnalisé. L'attribut événement doit être une chaîne ou un nombre. Assurez-vous de limiter le nombre de noms de types d'événements uniques que vous créez et ne générez pas ces noms de manière dynamique. Pour les restrictions sur les noms de types d'événements, consultez notre documentation sur les limites et les caractères restreints et les mots réservés de NRQL .
Vous pouvez modifier le nombre maximal d'événements enregistrés par l'agent Java via un paramètre configuration dans newrelic.yml.
Spécifiez le nombre maximal d'événements à enregistrer par minute sous forme d'entier. Par exemple, si vous souhaitez envoyer moins que la valeur par défaut de 10 000 événements :
custom_insights_events:
max_samples_stored:5000
Pour désactiver complètement l'événement personnalisé, ajoutez ce qui suit à votre newrelic.yml:
Pour les versions d'agent Java antérieures à 4.1.0, utilisez la configuration YAML suivante :
custom_insights_events.enabled:true
custom_insights_events.max_samples_stored:5000
La collection événement personnalisé est activée par défaut dans la version 4.6.29.0 ou supérieure de l'agent .NET. Pour envoyer un événement personnalisé, appelez simplement RecordCustomEvent(). Par exemple:
var eventAttributes =newDictionary<String, Object>();
Le premier argument définit le nom de votre type d'événement, et le deuxième argument est un IEnumerable avec l'attribut de votre événement personnalisé. Assurez-vous de limiter le nombre de noms de types d'événements uniques que vous créez et ne générez pas ces noms de manière dynamique. Pour les restrictions sur les noms de types d'événements, consultez notre documentation sur les limites et les caractères restreints et les mots réservés de NRQL .
Vous pouvez désactiver complètement l'événement personnalisé en définissant customEvents.enabled sur false dans newrelic.config.
La collection événement personnalisé est activée par défaut dans la version 1.15.0 ou supérieure de l'agent Node.js Pour envoyer un événement personnalisé, il suffit d'appeler l'API concernée. Par exemple:
recordCustomEvent(eventType, attributes)
Utilisez recordCustomEvent() pour enregistrer une métrique basée sur un événement, généralement associée à une durée particulière. Le eventType doit être une chaîne alphanumérique inférieure à 255 caractères. L'attribut doit être un objet de paires clé et valeur. Les clés doivent comporter moins de 255 caractères et les valeurs doivent être des chaînes, des nombres ou des booléens. Pour les restrictions sur les noms de types d'événements, consultez notre documentation sur les limites et les caractères restreints et les mots réservés de NRQL .
Pour désactiver complètement l'événement personnalisé, ajoutez custom_insights_events.enabled: false à newrelic.js.
La collection d'événements personnalisés est activée par défaut dans la version 4.18 ou supérieure de l'agent PHP. Pour envoyer un événement personnalisé, appelez simplement la fonction API concernée. Par exemple:
Le premier argument définit le nom de votre type d'événement, et le deuxième argument est un éventail avec l'attribut de votre événement personnalisé. Assurez-vous de limiter le nombre de noms de types d'événements uniques que vous créez et ne générez pas ces noms de manière dynamique. Pour les restrictions sur les noms de types d'événements, consultez notre documentation sur les limites et les caractères restreints et les mots réservés de NRQL .
Par défaut, le nombre maximum d'événements personnalisés enregistrés par minute est de 30 000. Vous pouvez l'augmenter jusqu'à 100 000 via newrelic.custom_events.max_samples_stored paramètre de configuration.
Pour désactiver complètement l'événement personnalisé, ajoutez newrelic.custom_insights_events.enabled = false à votre newrelic.ini et redémarrez l'agent.
La collection événement personnalisé est activée par défaut dans la version 2.60.0.46 ou supérieure de l'agent Python . Pour envoyer un événement personnalisé, il suffit d'appeler l'API concernée. Par exemple:
Le event_type définit le nom (ou le type) de l'événement personnalisé. L'attribut de l'événement personnalisé doit être transmis sous forme de dictionnaire via l'argument mot-clé params . Assurez-vous de limiter le nombre de noms de types d'événements uniques que vous créez et ne générez pas ces noms de manière dynamique. Pour connaître les limites et les restrictions sur event_type et params, consultez notre documentation sur les limites et les caractères restreints et les mots réservés
Si appelé en dehors du contexte d'une demande Web de monitoring ou d'une tâche d'arrière-plan, l'appel sera ignoré à moins que l'argument de mot-clé application ne soit fourni et qu'un objet d'application correspondant à l'application par rapport à laquelle l'exception doit être enregistrée soit fourni. Un objet d'application approprié peut être obtenu à l'aide de la fonction newrelic.agent.application() .
Pour désactiver complètement l'événement personnalisé, définissez custom_insights_events.enabled sur False dans votre fichier configuration newrelic.ini.
La collection événement personnalisé est activée par défaut dans la version 3.9.8.273 ou supérieure de l'agent Ruby . Pour envoyer un événement personnalisé, il suffit d'appeler l'API concernée. Par exemple:
Le premier argument définit le nom de votre type d'événement, et le deuxième argument est un hacher avec l'attribut de votre événement personnalisé. Assurez-vous de limiter le nombre de noms de types d'événements uniques que vous créez et ne générez pas ces noms de manière dynamique. Pour les restrictions sur les noms de types d'événements, consultez notre documentation sur les limites et les caractères restreints et les mots réservés de NRQL .
Vous pouvez modifier le nombre maximum d'événements enregistrés par l'agent Ruby via un paramètre configuration dans newrelic.yml:
Spécifiez le nombre maximal d'événements à enregistrer par minute sous forme d'entier. Par exemple, si vous souhaitez pouvoir envoyer jusqu'à 5000 événements par minute, ajoutez :
Pour désactiver complètement l'événement personnalisé, ajoutez custom_insights_events.enabled: false à newrelic.yml.
horodatage
Vous ne pouvez pas spécifier d'horaire sur les événements qui sont collectés et enregistrés via l'agent. L'agent attribuera automatiquement un horaire à l'événement en fonction du moment où il est enregistré via l'API.
Avant de créer un attribut personnalisé, consultez la liste des termes réservés utilisés par NRQL de New Relic. Dans le cas contraire, des résultats inattendus pourraient survenir.