Características de diagnóstico

En esta sección, obtendrá información sobre el conjunto de características disponible para el servicio de diagnósticos de App Center.

Análisis de fallos y errores

En Diagnósticos de App Center, puede ver los datos de análisis generados automáticamente por App Center para comprender cuándo se produce un bloqueo o error en la aplicación.

De forma predeterminada, App Center muestra los bloqueos y errores de una aplicación al día en una vista en paralelo.

Con las pestañas de la parte superior izquierda, explore en profundidad bloqueos y errores. Al hacerlo, el gráfico izquierdo indica el número de bloqueos o errores al día y el gráfico derecho muestra el número de usuarios afectados. Filtre los gráficos por versión de la aplicación, período de tiempo y estado para obtener una vista más centrada.

Agrupación

App Center Diagnostics agrupa los bloqueos y errores por similitudes, como el motivo del problema y dónde ocurrió el problema en la aplicación. Para cada grupo de bloqueos y errores, App Center muestra la línea de código que produjo un error, el nombre de clase o método, el nombre de archivo, el número de línea, el bloqueo o el tipo de error y el mensaje para que pueda comprender mejor estos grupos de un vistazo. Seleccione un grupo para ver más información y acceder a una lista de informes y registros detallados de problemas. Esto te permite profundizar aún más y usar nuestro conjunto de características para comprender mejor el comportamiento de la aplicación durante un bloqueo o un error.

Si un bloqueo se debe a una llamada con error a una dirección URL (por ejemplo, "Error al llamar a azure.com o google.com"), App Center puede agrupar bloqueos por esa dirección URL. Por ejemplo, todas las llamadas con error a azure.com se agrupan y todas las llamadas con error a google.com se agrupan. Sin embargo, dado que App Center elimina del registro de fallos las URL con el prefijo HTTP o HTTPS, esta agrupación solo funciona si evitas esta sintaxis. Por ejemplo, "Error al llamar a http://azure.com"" no se agrupa con otras llamadas a azure.com, pero "Error al llamar a azure.com" sí se agrupa con informes de error similares.

Identificación del usuario

App Center Diagnostics te permite asociar un ID de usuario a tus fallos y errores. Para ello, use el SDK de App Center en la plataforma de destino Android, iOS, macOS, React Native, tvOS, Unity, UWP, WPF/WinForms y MAUI/Xamarin. Encontrará el ID de usuario asociado a un fallo o error al hacer clic en un problema dentro de un grupo.

Después de adjuntar un identificador de usuario, puede usar la función de búsqueda de App Center para buscar fallos con el identificador especificado. Obtenga información sobre cómo hacerlo siguiendo la documentación de búsqueda de App Center.

Datos adjuntos

En la interfaz de usuario de App Center Diagnostics, puedes ver y descargar archivos adjuntos binarios y de texto de tus informes de fallos y errores.

Para obtener información sobre cómo agregar datos adjuntos a los informes de bloqueo, lea la documentación sobre bloqueos del SDK para las aplicaciones Android, iOS, macOS, React Native, UWP, WPF/WinForms y MAUI/Xamarin .

Los archivos adjuntos para errores administrados solo son compatibles con las plataformas Android, Unity, UWP, WPF, WinForms y Xamarin. Obtenga información sobre cómo agregar datos adjuntos a los informes de errores en la documentación del SDK para las aplicaciones Android, Unity, UWP, WPF/WinForms y MAUI/Xamarin .

Para ver y descargar los archivos adjuntos, selecciona un grupo de fallos o errores, un informe de dispositivo específico y, a continuación, haz clic en la pestaña "Archivos adjuntos""."

Eventos previos a un fallo

Monitoree los eventos que conducen a un fallo para capturar información útil sobre el estado de su aplicación.

Esta característica requiere el módulo Análisis de App Center. Para definir un evento personalizado, consulte la documentación del SDK para Android, iOS, macOS, React Native, Windows y MAUI/Xamarin.

Para ver los eventos previos a un fallo, selecciona un grupo de fallos, un informe de dispositivo específico y, a continuación, haz clic en la pestaña "Eventos""."

Pares clave-valor

Puede personalizar los informes de errores enviados a App Center para incluir contexto adicional para el error pasando un diccionario de valores de cadena (como pares clave-valor) al TrackError método . Estas propiedades son opcionales. Para establecer pares clave-valor, eche un vistazo a nuestra documentación de Android, MAUI/Xamarin, Unity, UWP y WPF/WinForms .

Exportar datos de diagnóstico

App Center puede exportar datos de diagnóstico sin procesar (bloqueos y errores) a Azure. Exportar datos de diagnóstico a Blob Storage para personalizar los datos.

Para exportar fallos, datos adjuntos y errores, debe llamar a la Export Configurations API:

POST /v0.1/apps/{owner_name}/{app_name}/export_configurations

En el exportEntities campo de la propiedad API, debe indicar qué tipo de datos desea exportar: bloqueos, errores y datos adjuntos. Al hacerlo, se exportarán los fallos completos con símbolos y las trazas de pila correspondientes.

Obtenga más información sobre las ventajas de y cómo exportar los datos en la documentación de exportación.

Subprocesos

En un informe de fallo, puedes ver los subprocesos que estaban activos en el momento en que la aplicación se bloqueó. El subproceso que se bloqueó aparece resaltado en rojo para que puedas comprender mejor el estado de la aplicación.

Configurar alertas

Manténgase al tanto de los fallos configurando su aplicación de App Center para enviar una notificación por correo electrónico. Puedes configurar esta opción por aplicación para enviar un correo electrónico inmediatamente cuando se crea un nuevo grupo de bloqueos o enviar un correo electrónico de resumen diario con los bloqueos principales de la aplicación. Para configurar estas alertas:

1. Inicie sesión en App Center y seleccione la aplicación.
2. En el menú de la izquierda, vaya a Configuración.
3. Haga clic en Notificaciones por correo electrónico.
4. Seleccione Inmediatamente, Diario o Nunca. La configuración predeterminada se establece en Nunca.

Puede obtener más información sobre la notificación en nuestra documentación del panel de App Center.

Crear un rastreador de errores

Puede integrar herramientas de seguimiento de errores de terceros con App Center para mantenerse informado y administrar mejor los bloqueos. Lea la documentación del rastreador de errores para obtener información sobre cómo empezar.

Carga de informes en App Center

Se ha trasladado la documentación sobre cómo cargar fallos a través de la API.