Partilhar via


Usar manipuladores de exceção para definir exceções críticas

Os manipuladores de exceção são funções de aplicativo que "capturam" exceções que os aplicativos lançam para relatar erros e executar algum tratamento de erros. Por padrão, o Monitoramento de Desempenho de Aplicativos .NET define exceções críticas como as exceções administradas por manipuladores de exceção específicos fornecidos pelo .NET framework. Esses manipuladores capturam exceções de ASP.NET de nível superior e exceções de serviço Web que o aplicativo monitorado não conseguiu capturar e manipular internamente. Ao adicionar manipuladores de exceção, você está adicionando à definição do monitoramento de aplicativos do que é uma exceção crítica. Na verdade, as exceções manipuladas por essas funções serão consideradas exceções críticas. A vantagem de fazer isso é que você mantém o benefício de relatórios simplificados apenas de exceções críticas, mas tem o benefício adicional de relatar funções que são de seu interesse. É comum adicionar qualquer manipulador de erros do cliente definido para aplicativos Web à lista de manipuladores de exceção críticos para que você possa ser alertado quando um usuário for enviado para a página do manipulador de erros no aplicativo Web.

Aviso

Os manipuladores de exceção são definidos no nível do processo. Se você habilitar um manipulador de exceção para um aplicativo que está sendo executado no processo e, em seguida, desabilitá-lo para um aplicativo diferente em execução nesse processo, haverá um conflito de configuração e o monitoramento do aplicativo será desabilitado. Para resolver isso, você deve fazer com que o tratamento de exceção seja o mesmo para todos os aplicativos no mesmo processo.

Manipuladores de exceção padrão

A lista padrão de manipuladores de exceção inclui:

  • 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

Adicionar um manipulador de exceção

Para adicionar um manipulador de exceção, siga estas etapas:

  1. Para abrir o modelo de Monitoramento do Desempenho de Aplicativos .NET, no console do Operations Manager, no painel de navegação, selecione o botão Criação , selecione Modelos de Pacote de Gerenciamento e selecione Monitoramento do Desempenho de Aplicativos .NET.

  2. Clique com o botão direito do mouse no grupo de aplicativos que você deseja modificar e selecione Propriedades.

  3. Na guia Padrões do Lado do Servidor, selecione Configurações Avançadas.

  4. Na página Configurações avançadas, selecione Exceções Críticas para abrir a página de listagem Manipuladores de exceção. É aqui que você pode adicionar manipuladores de exceção.

  5. Para adicionar um manipulador de exceção, selecione Adicionar e insira o método que você deseja adicionar à lista de manipuladores de exceção. Se você quiser que esse manipulador de exceção afete o monitoramento, verifique se a caixa de seleção Habilitar monitoramento está marcada. Selecione OK.

    Importante

    Adicionar manipuladores definidos no .NET Framework como parte de mscorlib como Exceções Críticas não produzirá nenhum efeito.

    Observação

    O nome do método diferencia maiúsculas de minúsculas e deve ser especificado no seguinte formato: Namespace.ClassName.MethodName

Editar um manipulador de exceção

Para editar um manipulador de exceção, siga estas etapas:

  1. Abra o modelo de Monitoramento do Desempenho de Aplicativos .NET. No console do Operations Manager, no painel de navegação, selecione o botão Criação , selecione Modelos de Pacote de Gerenciamento e selecione Monitoramento de Desempenho de Aplicativos .NET.

  2. Clique com o botão direito do mouse no grupo de aplicativos que você deseja modificar e selecione Propriedades.

  3. Na guia Padrões do Lado do Servidor, selecione Configurações Avançadas.

  4. Na página Configurações avançadas, selecione Exceções críticas. Isso abre a página Lista de manipuladores de exceção em que você pode editar manipuladores de exceção.

  5. Para editar um manipulador de exceção, selecione Editar, selecione o manipulador de exceção que você deseja alterar e modifique-o. Selecione OK.

    Observação

    O nome do método diferencia maiúsculas de minúsculas. Além disso, o nome do método deve ser especificado no seguinte formato: Namespace.ClassName.MethodName

Remover um manipulador de exceção

Para remover um manipulador de exceção, siga estas etapas:

  1. Abra o modelo de Monitoramento do Desempenho de Aplicativos .NET. No console do Operations Manager, no painel de navegação, selecione o botão Criação , selecione Modelos de Pacote de Gerenciamento e selecione Monitoramento de Desempenho de Aplicativos .NET.
  2. Clique com o botão direito do mouse no grupo de aplicativos que você deseja modificar e selecione Propriedades.
  3. Na guia Padrões do Lado do Servidor, selecione Configurações Avançadas.
  4. Na página Configurações avançadas, selecione Exceções críticas. Isso abre a página Lista de manipuladores de exceção em que você pode remover manipuladores de exceção.
  5. Para remover um manipulador de exceção, selecione o manipulador de exceção que você deseja remover, selecione Remover e selecione OK.