Como usar eventos para erros tratados

Importante

O Visual Studio App Center foi desativado em 31 de março de 2025, com exceção dos recursos de Análise e Diagnóstico, que continuarão com suporte até 30 de junho de 2026. Saiba mais.

Importante

Os erros manipulados ainda não estão disponíveis como parte do serviço de Quedas de Aplicativo no App Center. Uma solução alternativa é usar Eventos Personalizados. Não é assim que os "Erros Manipulados" devem ser suportados, e essa também não é a principal finalidade dos Eventos. No entanto, esta página contém conselhos sobre como usar melhor os Eventos para reportar erros manipulados.

Nesta seção, você aprenderá a usar eventos para obter informações sobre seus erros tratados. Eventos para erros tratados podem ser úteis se você estiver interessado em contar o número de vezes que um erro ocorreu. Você obterá seis medidas diferentes por evento: contagem, alteração de contagem, usuários, mudança de usuários, contagem por usuário e contagem por sessão.

Nome do evento

É recomendável dar ao evento um nome que forneça algumas informações contextuais. Os erros manipulados podem ser genéricos, portanto, é necessário fornecer algumas informações extras que identificarão um erro de maneira mais distinta. Um exemplo de informações contextuais é o nome do arquivo/método em que o erro é tratado.

Exemplo:

Vamos imaginar uma situação em que você deseja entender com que frequência os usuários não conseguem se conectar ao Wi-Fi. "UnknownHostException:ConnectWiFi", em que "UnknownHostException" é o nome genérico da exceção e "ConnectWiFi" é o nome do método.

Propriedades do evento

Se você quiser entender mais sobre a distribuição desses erros tratados para diferentes características (por exemplo, tipo de dispositivo, versão do sistema operacional, número da compilação ou fabricante), você pode usar propriedades e valores de propriedade.

Exemplo:

Chave de propriedade: versão do sistema operacional

Valor da propriedade 1: 10.2.1

Valor da propriedade 2: 10.3

Valor da propriedade 3: 9.3.5

Dependendo do seu caso de uso específico, você pode querer incluí-los como parte do nome do evento. No entanto, o número de nomes de eventos é limitado a 200. É importante saber o que você deseja responder para obter o máximo valor ao usar eventos de erros manipulados. Se você quiser filtrar por versão, não precisará incluí-lo como parte da propriedade, pois pode usar a lista suspensa fornecida no canto superior direito da página de eventos.

Se você quiser incluir a mensagem de exceção, poderá incluí-la como outra propriedade.

Exemplo:

Chave de propriedade: Mensagem de exceção

Valor da propriedade: Exceção no thread "main" java.lang.RuntimeException

O número de caracteres nos valores da propriedade é limitado a 64 caracteres, portanto, você provavelmente precisará truncar ou filtrar a cadeia de caracteres. Por fim, você não deve incluir o rastreamento de pilha como parte do nome do evento ou dos valores de propriedade pelo mesmo motivo.