Partager via


Utiliser des gestionnaires d’exceptions pour définir des exceptions critiques

Les gestionnaires d’exceptions sont des fonctions d’application qui « interceptent » les exceptions levées par les applications pour signaler des erreurs et effectuer une gestion des erreurs. Par défaut, l'analyse des performances des applications .NET définit des exceptions critiques comme exceptions gérées par des gestionnaires d'exceptions spécifiques fournis par .NET Framework. Ces gestionnaires interceptent les exceptions de niveau supérieur ASP.NET et les exceptions de service web que l’application surveillée n’a pas pu intercepter et gérer en interne. En ajoutant des gestionnaires d’exceptions, vous ajoutez la définition de l’analyse des applications de ce qu’est une exception critique. En effet, toutes les exceptions gérées par ces fonctions seront considérées comme des exceptions critiques. L’avantage de le faire est que vous conservez l’avantage de la création de rapports simplifiés des exceptions critiques uniquement, mais vous avez l’avantage supplémentaire des fonctions de création de rapports qui vous intéressent. Il est courant d’ajouter des gestionnaires d’erreurs client définis pour les applications web à la liste des gestionnaires d’exceptions critiques afin de pouvoir être alerté lorsqu’un utilisateur est envoyé à votre page de gestionnaires d’erreurs dans l’application web.

Avertissement

Les gestionnaires d’exceptions sont définis au niveau du processus. Si vous activez un gestionnaire d’exceptions pour une application en cours d’exécution dans le processus, puis désactivez-la pour une autre application exécutée dans ce processus, il y aura un conflit de configuration et la surveillance des applications sera désactivée. Pour résoudre ce problème, vous devez rendre la gestion des exceptions identique pour toutes les applications du même processus.

Gestionnaires d’exceptions par défaut

La liste par défaut des gestionnaires d’exceptions inclut :

  • Web.HttpApplication.RecordError
  • Web.UI.Page.HandleError
  • Web.Services.Protocols.WebServiceHandler.WriteException
  • AppDomain.OnUnhandledExceptionEvent
  • Windows.Forms.Application.ThreadContext.OnThreadException
  • AppDomain.OnUnhandledExceptionEvent
  • Runtime.Remoting.Messaging.ReturnMessage.. ctor
  • Windows.Forms.DataGridView.OnDataError

Ajouter un gestionnaire d’exceptions

Pour ajouter un gestionnaire d’exceptions, procédez comme suit :

  1. Pour ouvrir le modèle d’application .NET Analyseur de performances ing, dans la console Operations Manager, dans le volet de navigation, sélectionnez le bouton Création, sélectionnez Modèles du pack d’administration, puis sélectionnez Application .NET Analyseur de performances ing.

  2. Cliquez avec le bouton droit sur le groupe d’applications que vous souhaitez modifier, puis sélectionnez Propriétés.

  3. Sous l’onglet Paramètres par défaut côté serveur, sélectionnez Paramètres avancés.

  4. Dans la page Paramètres avancés , sélectionnez Exceptions critiques pour ouvrir la page de liste des gestionnaires d’exceptions. C’est là que vous pouvez ajouter des gestionnaires d’exceptions.

  5. Pour ajouter un gestionnaire d’exceptions, sélectionnez Ajouter et entrez la méthode que vous souhaitez ajouter à la liste des gestionnaires d’exceptions. Si vous souhaitez que ce gestionnaire d’exceptions affecte la surveillance, vérifiez que la case Activer l’analyse est cochée. Cliquez sur OK.

    Important

    L’ajout de gestionnaires définis dans le .NET Framework dans le cadre de mscorlib en tant qu’exceptions critiques ne produit aucun effet.

    Remarque

    Le nom de la méthode respecte la casse et doit être spécifié dans le format suivant : Namespace.ClassName.MethodName

Modifier un gestionnaire d’exceptions

Pour modifier un gestionnaire d’exceptions, procédez comme suit :

  1. Ouvrez le modèle d’application .NET Analyseur de performances ing. Dans la console Operations Manager, dans le volet de navigation, sélectionnez le bouton Création, sélectionnez Modèles de pack d’administration, puis sélectionnez Application .NET Analyseur de performances ing.

  2. Cliquez avec le bouton droit sur le groupe d’applications que vous souhaitez modifier, puis sélectionnez Propriétés.

  3. Sous l’onglet Paramètres par défaut côté serveur, sélectionnez Paramètres avancés.

  4. Dans la page Paramètres avancés , sélectionnez Exceptions critiques. Cela ouvre la page Liste des gestionnaires d’exceptions, dans laquelle vous pouvez modifier les gestionnaires d’exceptions.

  5. Pour modifier un gestionnaire d’exceptions, sélectionnez Modifier, sélectionnez le gestionnaire d’exceptions que vous souhaitez modifier, puis modifiez-le. Cliquez sur OK.

    Remarque

    Le nom de la méthode respecte la casse. La méthode doit également être spécifié dans le format suivant : Namespace.ClassName.MethodName

Supprimer un gestionnaire d’exceptions

Pour supprimer un gestionnaire d’exceptions, procédez comme suit :

  1. Ouvrez le modèle d’application .NET Analyseur de performances ing. Dans la console Operations Manager, dans le volet de navigation, sélectionnez le bouton Création, sélectionnez Modèles de pack d’administration, puis sélectionnez Application .NET Analyseur de performances ing.
  2. Cliquez avec le bouton droit sur le groupe d’applications que vous souhaitez modifier, puis sélectionnez Propriétés.
  3. Sous l’onglet Paramètres par défaut côté serveur, sélectionnez Paramètres avancés.
  4. Dans la page Paramètres avancés , sélectionnez Exceptions critiques. Cela ouvre la page Liste des gestionnaires d’exceptions, dans laquelle vous pouvez supprimer les gestionnaires d’exceptions.
  5. Pour supprimer un gestionnaire d’exceptions, sélectionnez le gestionnaire d’exceptions à supprimer, sélectionnez Supprimer, puis OK.