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.
Définissez les paramètres du collecteur d’erreurs dans la section error_collector . Sauf indication contraire, vous pouvez remplacer ces paramètres par une propriété système préfixée par newrelic.config.error_collector . Le collecteur d'erreurs capture des informations sur les exceptions non détectées et les envoie à New Relic pour affichage.
Conseil
Pour savoir comment configurer les erreurs pour l'agent Java, notamment comment configurer les erreurs via l'UI, consultez configuration d'erreur de l'agent Java.
Type
Booléen
Défaut
true
Activer la collecte des erreurs.
Type
Section contenant une liste de chaînes class_name entièrement qualifiées
Défaut
(aucun)
Les noms de classe d'exception spécifiés seront ignorés et n'affecteront pas le taux d'erreur ou le score Apdex, ni ne seront signalés à APM. Cannot be specified by system property.
Ce paramètre est dynamique, donc l'agent en cours d'exécution remarquera les modifications apportées à newrelic.yml sans redémarrage JVM .
Par exemple:
error_collector:
ignore_classes:
-"com.example.MyException"
-"com.example.DifferentException"
Une variable d'environnement peut être utilisée pour répertorier les noms de classes d'exception que vous souhaitez ignorer :
Section contenant un class_name entièrement qualifié et une liste de messages par classe d'erreur
Défaut
(aucun)
Spécifiez les noms de classe d’exception que l’agent doit ignorer. Les messages ignorés n'affecteront pas le taux d'erreur ou le score Apdex, et ne seront pas signalés à APM. Contient yaml paires constituées de :
Un nom de classe d'exception entièrement qualifié qui ne doit pas être signalé à APM
AND
Une liste d'exceptions messageà comparer (au moins une est obligatoire)
Si le nom de la classe d'exception correspond à une erreur mais pas le message, alors cette erreur will not doit être ignorée. Les chaînes de message utilisent contains pour la correspondance. Un message ne peut pas être fourni seul et doit toujours être associé à un nom de classe complet. Cannot be specified by system property.
Ce paramètre est dynamique, donc l'agent en cours d'exécution remarquera les modifications apportées à newrelic.yml sans redémarrage JVM .
Par exemple:
error_collector:
ignore_messages:
com.example.MyException:
-"Some error message to ignore"
-"Some other error message to ignore"
com.example.DifferentException:
-"Some different error message to ignore"
Une variable d'environnement peut être utilisée pour répertorier les noms de classes d'exception et les messages que vous souhaitez ignorer :
NEW_RELIC_ERROR_COLLECTOR_IGNORE_MESSAGES="{\"com.example.MyException\": [\"Some error message to ignore\", \"Some other error message to ignore\"], \"com.example.DifferentException\": [\"Some different error message to ignore\"]}"
Type
Liste de chaînes et de plages séparées par des virgules
Défaut
404
Une liste séparée par des virgules composée de plages individuelles et en pointillés de codes d'état HTTP qui ne doivent pas être traités comme des erreurs.
Si cette propriété est placée en commentaire dans le fichier configuration newrelic.yml, alors le code d'état 404 sera automatiquement ignoré. Lors de l'utilisation de la configuration côté serveur, le code d'état 404 doit être spécifié pour qu'il soit ignoré.
Ce paramètre est dynamique, donc l'agent en cours d'exécution remarquera les modifications apportées à newrelic.yml sans redémarrage JVM .
Par exemple:
error_collector:
ignore_status_codes:404,507-511
Type
Section contenant une liste de chaînes class_name entièrement qualifiées
Défaut
(aucun)
Empêche les classes d'exception spécifiées d'affecter le taux d'erreur ou le score Apdex tout en signalant les erreurs à APM. Cannot be specified by system property.
Ce paramètre est dynamique, donc l'agent en cours d'exécution remarquera les modifications apportées à newrelic.yml sans redémarrage JVM .
Par exemple:
error_collector:
expected_classes:
-"com.example.MyException"
-"com.example.DifferentException"
Une variable d'environnement peut être utilisée pour répertorier les noms de classe d'exception attendus :
Section contenant un class_name entièrement qualifié et une liste de messages par classe d'erreur
Défaut
(aucun)
Contient des paires yaml constituées d'un nom de classe d'exception entièrement qualifié qui doit être marqué comme prévu et ainsi empêché d'affecter le taux d'erreur ou le score Apdex et une liste d'exceptions messageà comparer, dont au moins une est requise. Si le nom de la classe d'exception correspond à une erreur mais pas le message, alors cette erreur will not sera marquée comme attendue et affectera donc le taux d'erreur et le score Apdex.
Les chaînes de message utilisent contains pour la correspondance. Un message ne peut pas être fourni seul et doit toujours être associé à un nom de classe complet. Cannot be specified by system property.
Ce paramètre est dynamique, donc l'agent en cours d'exécution remarquera les modifications apportées à newrelic.yml sans redémarrage JVM .
Par exemple:
error_collector:
expected_messages:
com.example.MyException:
-"Some expected error message"
-"Some other expected error message"
com.example.DifferentException:
-"Some different expected error message"
Une variable d’environnement peut être utilisée pour répertorier les noms de classe et les messages d’exception attendus :
NEW_RELIC_ERROR_COLLECTOR_EXPECTED_MESSAGES="{\"com.example.MyException\": [\"Some error message to ignore\", \"Some other error message to ignore\"], \"com.example.DifferentException\": [\"Some different error message to ignore\"]}"
Type
Liste de chaînes et de plages séparées par des virgules
Défaut
(aucun)
Une liste séparée par des virgules composée de plages individuelles et en pointillés de codes d'état HTTP à marquer comme prévu et ainsi à empêcher d'affecter le taux d'erreur ou le score Apdex.
Ce paramètre est dynamique, donc l'agent en cours d'exécution remarquera les modifications apportées à newrelic.yml sans redémarrage JVM .
Par exemple:
error_collector:
expected_status_codes:415,500-506
Les codes d'état attendus peuvent également être avec la variable d'environnement NEW_RELIC_ERROR_COLLECTOR_EXPECTED_STATUS_CODES .
Type
Booléen
Défaut
true
Ce paramètre peut être utilisé pour activer ou désactiver tous les attributs pour les erreurs de trace. Si attributes.enabled est false au niveau racine, alors aucun attribut ne sera envoyé pour tracer les erreurs, quelle que soit la manière dont cette propriété est définie sous error_collector.
Type
Liste de chaînes
Défaut
(aucun)
Si les attributs sont activés pour les erreurs de trace, toutes les clés d'attribut trouvées dans cette liste seront envoyées à New Relic dans les erreurs de trace. Pour plus d'informations, consultez les règles d'attribut de l'agent.
Type
Liste de chaînes
Défaut
(aucun)
les clés d'attribut trouvées dans cette liste ne seront pas envoyées à New Relic en cas d'erreurs de trace. Pour plus d'informations, consultez les règles d'attribut de l'agent.
Type
Booléen
Défaut
true
Lorsque plusieurs erreurs sont constatées dans une transaction, seule la dernière erreur sera signalée par défaut. La définition de cette propriété sur false signalera uniquement la première erreur détectée. Pour plus d'informations, consultez l'API noticeError. Par exemple:
error_collector:
ignoreErrorPriority:false
Type
Liste de chaînes séparées par des virgules
Défaut
(aucun)
Tous les noms de classe d’exception spécifiés ne seront pas traités comme des erreurs. Obsolète à partir de l'agent Java 3.40.0 et remplacé par ignore_classes.
Par exemple:
error_collector:
ignore_errors: some.other.MyException
Erreurs configuration de la boîte de réception
La définition de l’une des balises suivantes vous aidera à identifier les versions de votre logiciel qui génèrent les erreurs.
NEW_RELIC_METADATA_SERVICE_VERSION créera tags.service.version sur les données d'événement contenant la version de votre code qui est déployée, dans de nombreux cas une version sémantique telle que 1.2.3, mais pas toujours.
NEW_RELIC_METADATA_RELEASE_TAG créera tags.releaseTag sur les données d'événement contenant la tag de sortie (comme v0.1.209 ou sortie-209).
NEW_RELIC_METADATA_COMMIT créera tags.commit sur les données d'événement contenant le commit sha. Vous pouvez utiliser le SHA entier ou simplement les sept premiers caractères (par exemple, 734713b).
Une prochaine version de la boîte de réception des erreurs suivra automatiquement les versions de votre logiciel qui génèrent des erreurs. Les données de version s'afficheront dans CodeStream.