Come usare gli eventi per gli errori gestiti

Importante

Visual Studio App Center è stato ritirato il 31 marzo 2025, ad eccezione delle funzionalità di Analisi e diagnostica, che continueranno a essere supportate fino al 30 giugno 2026. Ulteriori informazioni.

Importante

Gli errori gestiti non sono ancora disponibili come parte del servizio Arresti anomali in App Center. Una soluzione alternativa consiste nell'usare eventi personalizzati. Non è questo il modo in cui gli "errori gestiti" devono essere supportati e non è nemmeno lo scopo principale degli eventi. Questa pagina contiene tuttavia consigli su come usare al meglio gli eventi per segnalare gli errori gestiti.

In questa sezione si apprenderà come usare gli eventi per ottenere informazioni sugli errori gestiti. Tali eventi per gli errori gestiti sono utili se si è interessati a contare il numero di volte in cui si è verificato un errore. Si otterranno sei misure diverse per evento: conteggio, variazione del conteggio, utenti, variazione degli utenti, conteggio per utente e conteggio per sessione.

Nome evento

È consigliabile assegnare all'evento un nome che fornisce alcune informazioni contestuali. Gli errori gestiti possono essere generici, quindi è necessario fornire alcune informazioni aggiuntive che identificano un errore in modo più distinto. Un esempio di informazioni contestuali è il nome di file/metodo in cui viene gestito l'errore.

Esempio:

Immaginiamo una situazione in cui vuoi capire con quale frequenza gli utenti non riescono a connettersi al Wi-Fi. "UnknownHostException:ConnectWiFi", dove "UnknownHostException" è il nome generico dell'eccezione e "ConnectWiFi" è il nome del metodo.

Proprietà degli eventi

Per altre informazioni sulla distribuzione di questi errori gestiti per caratteristiche diverse, ad esempio tipo di dispositivo, versione del sistema operativo, numero di build o produttore, è possibile usare le proprietà e i valori delle proprietà.

Esempio:

Chiave della proprietà: versione del sistema operativo

Il valore della proprietà 1: 10.2.1

Valore proprietà 2: 10.3

Valore proprietà 3: 9.3.5

A seconda del caso d'uso specifico, è consigliabile includerli come parte del nome dell'evento. Tuttavia, il numero di nomi di eventi è limitato a 200. È importante sapere a quale domanda si intende rispondere per ottenere il massimo vantaggio dall'uso degli eventi per gli errori gestiti. Se si vuole filtrare in base alla versione, non è necessario includerlo come parte della proprietà , perché è possibile usare l'elenco a discesa fornito in alto a destra della pagina dell'evento.

Usare l'elenco VERSIONI APP per selezionare la versione o le versioni da segnalare

Se si desidera includere il messaggio di eccezione, è possibile includerlo come un'altra proprietà.

Esempio:

Chiave di proprietà: messaggio di eccezione

Valore proprietà: eccezione nel thread "main" java.lang.RuntimeException

Il numero di caratteri nei valori della proprietà è limitato a 64 caratteri, quindi probabilmente sarà necessario troncare o filtrare la stringa. Infine, non è consigliabile includere la traccia dello stack come parte del nome dell'evento o dei valori delle proprietà per lo stesso motivo.

  • Last updated on