Syntaxe
newrelic.agent.set_error_group_callback(callback_function(exception, transaction_data))Cette méthode permet de définir des groupes d'erreurs dans la boîte de réception des erreurs sur un identifiant spécifique (ou « empreinte »).
Exigences
Python agent version 8.8.0 ou supérieure.
Description
Ce point de terminaison prend une seule entrée, un rappel, qui est utilisé pour enregistrer des groupes d'erreurs. Ce rappel est défini par les clients et doit accepter l'exception qui a déclenché agent notice_error APIl' de l' . Pour désactiver ce paramètre, appelez à nouveau l’API et définissez le rappel sur None.
paramètre pour set_error_group_callback
paramètres | Description |
|---|---|
fonction appelable | Requis. La fonction de rappel que vous souhaitez définir. Utilisez |
instance d'application | Facultatif. Si aucune instance d'application n'est fournie, la fonction vérifiera l'instance d'application activée. |
paramètre pour la fonction de rappel définie par les clients
paramètres | Description |
|---|---|
Exception d'exécution | Requis. Il s'agirait de l'exception d'exécution qui a déclenché l' API |
dictionnaire | Requis. Un dictionnaire de données de transaction capturées par l'agent Python. |
Valeurs de retour
En cas de succès, l’API ajoutera une chaîne représentant le nom du groupe d’erreurs souhaité en tant qu’attribut d’agent.
En cas d’échec, l’API n’ajoutera pas error.group.name comme attribut d’agent.
Exemple d'utilisation
Définir le rappel du groupe d'erreurs
Un exemple d'utilisation de set_error_group_callback:
def customer_callback(exc, data): if isinstance(exc, ValueError): return "group1"
def some_other_function(): try: raise ValueError("Oh no!") except Exception: newrelic.agent.notice_error()
def example_function(customer_callback): try: newrelic.agent.set_error_group_callback(customer_callback) some_other_function() finally: newrelic.agent.set_error_group_callback(None)