Funzionalità di diagnostica
Importante
Visual Studio App Center è pianificato per il ritiro il 31 marzo 2025. Anche se è possibile continuare a usare Visual Studio App Center fino a quando non viene completamente ritirato, esistono diverse alternative consigliate a cui è possibile prendere in considerazione la migrazione.
Altre informazioni sulle sequenze temporali di supporto e sulle alternative.
In questa sezione verranno fornite informazioni sul set di funzionalità disponibile per il servizio Diagnostica di App Center.
In Diagnostica di App Center è possibile visualizzare i dati di analisi generati automaticamente da App Center per comprendere quando si verifica un arresto anomalo o un errore nell'app.
Per impostazione predefinita, App Center visualizza gli arresti anomali e gli errori di un'app per singolo giorno in una visualizzazione side-by-side.
Usando le schede in alto a sinistra, eseguire il drill-down nella sezione relativa agli arresti anomali e agli errori. Quando si esegue questa operazione, il grafico a sinistra indica il numero di arresti anomali/errori al giorno e il grafico a destra mostra il numero di utenti interessati. Filtrare i grafici in base alla versione dell'app, all'intervallo di tempo e allo stato per una visualizzazione più evidenziata.
Nota
App Center filtra informazioni potenzialmente riservate. Esempi di informazioni riservate che verranno filtrate sono URL, stringhe JSON e ID richiesta.
I gruppi di diagnostica di App Center si arrestano in modo anomalo ed errori in base a analogie, ad esempio per il problema e per cui si è verificato il problema nell'app. Per ogni gruppo di errori e arresto anomalo, App Center visualizza la riga di codice non riuscita, il nome della classe o del metodo, il nome del file, il numero di riga, l'arresto anomalo o il tipo di errore e il messaggio per comprendere meglio questi gruppi a colpo d'occhio. Selezionare un gruppo per visualizzare altre informazioni e accedere a un elenco di report e log dettagliati sui problemi. In questo modo puoi approfondire e usare il set di funzionalità per comprendere meglio il comportamento dell'app durante un arresto anomalo o un errore.
Se un arresto anomalo è causato da una chiamata non riuscita a un URL (ad esempio, "Errore durante la chiamata a azure.com o google.com") App Center può raggruppare gli arresti anomali in base a tale URL(ad esempio, tutte le chiamate non riuscite azure.com verranno raggruppate e non sarà possibile chiamare google.com verranno raggruppate). Tuttavia, poiché gli URL preceduti da HTTP o HTTPS vengono rimossi dal log di arresto anomalo del sistema, questo raggruppamento funzionerà solo quando si evita questa sintassi, ad esempio: "Errore durante la chiamata http://azure.com"a ; non verrà raggruppato con altre chiamate di Azure, ma "Errore di chiamata azure.com" verrà raggruppato con segnalazioni di errori simili.
La diagnostica di App Center consente di allegare un ID utente agli arresti anomali ed errori. A tale scopo, usare App Center SDK nella piattaforma di destinazione Android, Apache Cordova, iOS, macOS, React Native, tvOS, Unity, UWP, WPF/WinForms e MAUI/Xamarin. L'ID utente associato a un arresto anomalo o a un errore si troverà quando si fa clic su un problema all'interno di un gruppo.
Dopo aver collegato un ID utente, è possibile usare la funzionalità di ricerca di App Center per cercare arresti anomali con l'ID specificato. Per informazioni su come eseguire questa operazione, seguire la documentazione di ricerca di App Center.
Nell'interfaccia utente di Diagnostica di App Center è possibile visualizzare e scaricare allegati binari e di testo dei report di arresto anomalo e di errore.
Per informazioni su come aggiungere allegati ai report di arresto anomalo del sistema, leggere la documentazione relativa agli arresti anomali dell'SDK per le app Android, iOS, macOS, React Native, UWP, WPF/WinForms e MAUI/Xamarin.
Gli allegati per gli errori gestiti sono supportati solo per le piattaforme Android, Unity, UWP, WPF, WinForms e Xamarin. Informazioni su come aggiungere allegati ai report degli errori nella documentazione dell'SDK per le app Android, Unity, UWP, WPF/WinForms e MAUI/Xamarin .
Per visualizzare e scaricare gli allegati, selezionare un gruppo di errori o un arresto anomalo del sistema, un report del dispositivo specifico e quindi fare clic sulla scheda Allegati.
Tenere traccia degli eventi che causano un arresto anomalo per acquisire informazioni utili sullo stato dell'app.
Per definire un evento personalizzato, vedere la documentazione dell'SDK per Android, iOS, macOS, React Native, Windows e MAUI/Xamarin.
Per visualizzare gli eventi prima di un arresto anomalo, selezionare un gruppo di arresti anomali, un report del dispositivo specifico e quindi fare clic sulla scheda eventi.
È possibile personalizzare i report degli errori inviati ad App Center per includere contesto aggiuntivo per l'errore passando un dizionario di valori stringa (come coppie chiave/valore) al TrackError
metodo . Queste proprietà sono facoltative. Per impostare coppie chiave-valore, vedere la documentazione di Android, MAUI/Xamarin, Unity, UWP e WPF/WinForms .
Nota
Questa funzionalità è supportata solo per gli errori Android, iOS, Xamarin, React Native, Unity, UWP, WinForms e WPF.
App Center può esportare i dati di diagnostica (arresti anomali ed errori) non elaborati in Azure. Esportare i dati di diagnostica in Archiviazione BLOB per la personalizzazione dei dati.
Per esportare arresti anomali, allegati ed errori, è necessario chiamare l'API Esporta configurazioni:
POST /v0.1/apps/{owner_name}/{app_name}/export_configurations
exportEntities
Nel campo della proprietà API è necessario indicare il tipo di dati da esportare: arresti anomali, errori, allegati. In questo caso, verranno esportati gli arresti anomali simbolici completi e le tracce dello stack corrispondenti.
Altre informazioni sui vantaggi di e su come esportare i dati nella documentazione di esportazione.
In un report di arresto anomalo del sistema è possibile visualizzare i thread correnti attivi quando l'app si è arrestata in modo anomalo. Il thread che si è arrestato in modo anomalo è evidenziato in rosso per comprendere meglio lo stato dell'app.
Nota
In Windows il report mostra solo l'analisi dello stack dal thread che si è arrestato in modo anomalo. La visualizzazione dello stato di altri thread al momento dell'arresto anomalo non è supportata in Windows.
Per rimanere al massimo degli arresti anomali, configurare le impostazioni di definizione dell'app App Center per inviare una notifica tramite posta elettronica. È possibile configurare questa impostazione per ogni app per inviare immediatamente un messaggio di posta elettronica quando viene creato un nuovo gruppo di arresti anomali oppure inviare un messaggio di riepilogo giornaliero con gli arresti anomali principali dell'app. Per configurare questi avvisi:
- Accedere ad App Center e selezionare l'app
- Nel menu a sinistra passare a Impostazioni
- Fare clic su Notifiche di Email
- Selezionare Immediatamente, Giornaliero o Mai. La configurazione predefinita è impostata su Never.
Altre informazioni sulla notifica sono disponibili nella documentazione del dashboard di App Center.
È possibile integrare strumenti di registro bug di terze parti con App Center per rimanere informati e gestire meglio gli arresti anomali. Per informazioni introduttive, vedere la documentazione del registro bug.
La documentazione per caricare arresti anomali tramite l'API è stata spostata.