Características de diagnóstico

  • Artículo

Importante

Visual Studio App Center está programado para la retirada el 31 de marzo de 2025. Aunque puede seguir usando Visual Studio App Center hasta que se retire por completo, hay varias alternativas recomendadas a las que puede considerar la posibilidad de migrar.

Obtenga más información sobre las escalas de tiempo de soporte técnico y las alternativas.

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 bloqueos 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.

Nota

App Center filtra información potencialmente confidencial. Ejemplos de información confidencial que se filtrarán son direcciones URL, cadenas JSON e identificadores de solicitud.

App Center muestra el análisis de bloqueos y errores

Agrupar

Los grupos de diagnósticos de App Center se bloquean y producen errores por similitudes, como el motivo del problema y dónde se produjo 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 la clase o el método, el nombre de archivo, el número de línea, el bloqueo o el tipo de error y el mensaje que le permiten 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 bloqueos por esa dirección URL (por ejemplo, todos los errores al llamar a azure.com se agruparán y no se pudieron llamar a google.com se agruparán). Sin embargo, dado que quitamos las direcciones URL anteponedas a HTTP o HTTPS del registro de bloqueos, esta agrupación solo funcionará al evitar 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.

Grupos de App Center se bloquean y producen errores en función de las similitudes

Identificación del usuario

Diagnósticos de App Center 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, Apache Cordova, iOS, macOS, React Native, tvOS, Unity, UWP, WPF/WinForms y MAUI/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. 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óstico 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 bloqueos, 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 controlados 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 datos adjuntos, seleccione un bloqueo o un grupo de errores, un informe de dispositivo específico y, a continuación, haga clic en la pestaña datos adjuntos.

App Center le permite agregar datos adjuntos a los informes de bloqueos y errores.

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 MAUI/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.

App Center le permite realizar un seguimiento de los eventos que conducen al bloqueo.

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, eche un vistazo a nuestra documentación de Android, MAUI/Xamarin, Unity, UWP y WPF/WinForms .

Nota

Esta característica solo se admite para Errores de Android, iOS, Xamarin, React Native, Unity, UWP, WinForms y WPF.

Exportar datos de diagnóstico

App Center puede exportar datos sin procesar (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 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 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 la aplicación se bloqueó. El subproceso que se bloqueó está resaltado en rojo para comprender mejor el estado de la aplicación.

App Center muestra los subprocesos actuales en el momento del bloqueo

Nota

En Windows, el informe muestra solo el seguimiento de la pila del subproceso que se bloqueó. No se admite el estado de otros subprocesos en el momento del bloqueo en Windows.

Configurar alertas

Manténgase al tanto de los bloqueos mediante la configuración de la definición de la 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 de Email
  4. Seleccione Inmediato, Diario o Nunca. La configuración predeterminada se establece en Nunca.

Captura de pantalla de la configuración bloqueos de la frecuencia de notificación de correo electrónico

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 seguimiento de errores para obtener información sobre cómo empezar.

Carga de informes en App Center

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