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, profundice en los bloqueos y los 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 errónea a una dirección URL (por ejemplo, "Error al llamar a azure.com o google.com"), App Center puede agrupar los bloqueos según la dirección URL correspondiente. Por ejemplo, todos los errores al intentar llamar a azure.com se agruparán juntos, al igual que los errores al intentar llamar a google.com. Sin embargo, dado que eliminamos las direcciones URL que comienzan con HTTP o HTTPS del registro de fallos, esta agrupación solo funcionará si se evita esta sintaxis, por ejemplo: "Error al llamar a http://azure.com" no se agrupará con otras llamadas de Azure, pero "Error al llamar a azure.com" se agrupará con informes de errores similares.

Identificación del usuario

App Center Diagnostics permite asociar un identificador de usuario a los bloqueos 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 Diagnósticos de App Center, puede ver y descargar datos adjuntos binarios y de texto de los informes de bloqueos 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 datos adjuntos para errores gestionados solo se admiten para 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 adjuntos, seleccione un bloqueo o grupo de errores, un informe de dispositivo específico y, a continuación, haga clic en la pestaña de adjuntos.

Eventos antes de un fallo

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

Para definir un evento personalizado, consulte nuestra documentación del SDK para Android, iOS, macOS, React Native, Windows y MAUI/Xamarin.

Para ver eventos antes de un bloqueo, seleccione un grupo de bloqueos, un informe de dispositivo específico y, a continuación, haga 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 bloqueos completamente simbolizados y los rastros 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 falla, puede ver los hilos actuales que estaban activos cuando se cayó la aplicación. El hilo que se bloqueó está resaltado en rojo para que usted pueda 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

La documentación para subir bloqueos a través de la API se ha trasladado.