Características de diagnóstico

En esta sección, aprenderá sobre el conjunto de características disponible para el App Center de diagnóstico de la aplicación.

Análisis de bloqueos y errores

En App Center Diagnósticos, 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 los 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.

<a name="grouping">Agrupación

App Center de diagnósticos se bloquea y produce errores por similitudes, como el motivo del problema y dónde se produjo el problema en la aplicación. Para cada bloqueo y grupo de errores, App Center muestra la línea de código con errores, 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 de problemas detallados. Esto le 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, todos los errores al llamar a azure.com se agruparán y no se pudo llamar a google.com se agruparán). Sin embargo, dado que quitamos las direcciones URL anteponedas con HTTP o HTTPS del registro de bloqueos, esta agrupación solo funcionará al evitar esta sintaxis, por ejemplo: "Error al llamar a " no se agrupará con otras llamadas de Azure, pero "Error al llamar a azure.com" se agrupará con informes de http://azure.com errores similares.

Identificación del usuario

App Center Diagnostics permite adjuntar un identificador de usuario a los bloqueos y errores. Para ello, use el SDK de App Center en la plataforma de destino Android, Apache Cordova, iOS, macOS, React Native, tvOS, Unity, UWP, WPF/WinFormsy Xamarin. Encontrará el identificador de usuario asociado a un bloqueo o error al hacer clic en un problema dentro de un grupo.

Después de adjuntar un identificador de usuario, puede usar la característica de búsqueda de App Center para buscar bloqueos con el identificador especificado. Aprenda a hacerlo siguiendo la documentación de App Center de búsqueda de .

Datos adjuntos

En la App Center de usuario de Diagnósticos, puede ver y descargar datos adjuntos binarios y de texto de los informes de bloqueos y errores.

Para aprender a agregar datos adjuntos a los informes de bloqueo, lea la documentación de bloqueos del SDK para las aplicaciones de Android, Apache Cordova, iOS, macOS, React Native, UWP, WPF/WinForms y Xamarin.

Los datos adjuntos para los errores manipulados 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 de Android, Unity, UWP, WPF/WinForms y Xamarin.

Para ver y descargar los datos adjuntos, seleccione un grupo de bloqueos o errores, un informe de dispositivo específico y, a continuación, haga clic en la pestaña de datos adjuntos.

Eventos antes de un bloqueo

Realice un seguimiento de los eventos que conducen a un bloqueo para capturar información útil sobre el estado de la aplicación.

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

Para ver los 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 adaptar 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, echa un vistazo a nuestra documentación de Android, Xamarin, Unity, UWPy WPF/WinForms.

Exportación de datos de diagnóstico

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

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

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

En el campo de la propiedad api, debe indicar qué tipo de datos desea exportEntities exportar: bloqueos, errores, datos adjuntos. Al hacerlo, se exportarán los bloqueos simbólicos completos y los seguimientos 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 bloqueo, puede ver los subprocesos actuales que estaban activos cuando se bloqueaba la aplicación. El subproceso que se bloquea se resalta en rojo para que comprenda mejor el estado de la aplicación.

Configurar alertas

Manténgase al tanto de los bloqueos mediante la configuración de la configuración App Center definición de la aplicación para enviar una notificación por correo electrónico. Puede 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 principales bloqueos de la aplicación. Para configurar estas alertas:

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

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

Creación de un seguimiento de errores

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

Establecer retención de datos

Puede establecer la retención de datos de diagnóstico en 28 o 90 días a través de nuestras API, como se muestra en la documentación de la APIde App Center o en la página de configuración de la aplicación. Si cambia la configuración de retención de 90 a 28 días, se quitarán los datos de diagnóstico existentes anteriores a 28 días y los datos nuevos solo se almacenarán durante 28 días.

Si cambia la configuración de 28 a 90 días, los datos de diagnóstico anteriores no se reposiciónrán. Si desea almacenar los datos durante más de 90 días, exporte los datos sin procesar a Azure Blob Storage. Lea la sección exportación de datos de diagnóstico para empezar.

Upload informes a App Center

Se ha movido la documentación para cargar bloqueos a través de la API.