Ganter Lab
Iniciar sesión Descargas

Reportes de falla

Qué guarda la estación cuando cierra de forma inesperada, qué envía y cuándo pregunta, y los dos comandos de depuración que trae una compilación de desarrollo.

Ver como Markdown

Reportes de falla es la única fila del grupo DIAGNÓSTICO de la página Ajustes. Una falla nunca se envía mientras la aplicación se está cayendo: se captura en un archivo, y el siguiente arranque o lo envía o se lo muestra a usted y pregunta. Esta sección lleva el único interruptor que decide cuál de las dos. La página exige el permiso Cambiar los ajustes.

Enviar los reportes de falla automáticamente

Campo Qué es Valores / predeterminado Efecto
Enviar los reportes de falla automáticamente "Cuando la aplicación falla, envía el reporte en el siguiente arranque sin preguntar. Apagado: se le muestra el reporte y se le pregunta antes." Encendido o apagado. Apagado de forma predeterminada. Encendido: el siguiente arranque envía en silencio el reporte capturado y lo limpia en cuanto el servidor lo acepta. Apagado: el siguiente arranque visible abre el diálogo de consentimiento.

Mientras el runtime está detenido esta página ni siquiera se dibuja (véase Ajustes). Ese mismo consentimiento se ofrece dentro del propio diálogo, como la casilla "Enviar siempre los reportes de falla automáticamente", y marcarla ahí enciende este interruptor. Bajo el interruptor, la tarjeta dice: "Para reportar una falla, sugerir una mejora o pedir un driver, use la página Cuenta." Ese formulario es Avisos y sugerencias, porque envía con la cuenta Ganter.

Qué contiene un reporte

Cuando un error no controlado tumba la aplicación, los manejadores globales escriben un solo archivo, crash\pending-crash.json bajo la raíz de datos de la estación, y conservan únicamente la falla más reciente. Lleva:

  • la versión de la aplicación y la versión de Windows;
  • dónde se atrapó el error (Dispatcher, AppDomain, TaskScheduler, o Startup para un arranque que no terminó);
  • el tipo de la excepción, su mensaje y el texto completo de la pila, con las excepciones internas incluidas;
  • las últimas 60 líneas del archivo de diario técnico más nuevo, como contexto que lleva a la falla;
  • el momento en que pasó.

Antes de escribirlo, el nombre de usuario de Windows y la ruta del perfil se reemplazan por <user> y <userprofile> dondequiera que aparezcan. Esa depuración es una red de seguridad, no una garantía: las líneas libres del diario técnico pueden llevar otros nombres, y por eso el diálogo muestra la carga entera antes de que nada salga.

Con el interruptor apagado, el primer arranque visible después de una falla abre ¿Enviar el reporte de falla? sobre el shell: "Ganter Lab se cerró de forma inesperada la última vez. Enviar este reporte nos ayuda a corregirlo. Contiene el error y un fragmento breve del diario técnico reciente. Revíselo abajo antes de enviarlo." La casilla Detalle de la falla muestra exactamente lo que se enviaría, con un botón Copiar que pone ese mismo texto en el portapapeles ("Copiado" durante un momento) para que usted pueda buscarlo o pasárselo al soporte. Si el portapapeles se niega, el botón dice "No se pudo copiar", para que una copia que no ocurrió no se tome por una que sí; el texto se queda en pantalla para seleccionarlo a mano.

Comando Qué hace Atenuado cuando (situación) No se dibuja cuando (rol)
Enviar siempre los reportes de falla automáticamente (casilla) Enciende el interruptor de arriba cuando el diálogo se cierra, mande usted este reporte o no. Mientras el runtime está detenido (información emergente "Runtime detenido"). El diálogo es del shell, así que se sigue dibujando aunque esta página no. Nunca.
No enviar Descarta este reporte y limpia el archivo; no se le vuelve a preguntar por él. Nunca. Nunca.
Enviar el reporte Lo envía. "Reporte de falla enviado" como notificación cuando sale bien; "Reporte de falla no enviado" con el motivo cuando no se pudo alcanzar el servidor, en cuyo caso el archivo se queda y usted puede enviarlo ahora o se le vuelve a preguntar en el siguiente arranque. Nunca. Nunca.

Un arranque escondido en el área de notificación (Iniciar con Windows, o un lanzamiento con --tray) no muestra ningún diálogo; el reporte espera al siguiente arranque visible. Con el interruptor encendido, el envío pasa en segundo plano sin ningún diálogo, y una estación que estaba sin conexión conserva el archivo y lo intenta de nuevo en el siguiente arranque.

El reporte se va al punto de conexión de avisos del servidor de Ganter. Se atribuye a la cuenta Ganter con la sesión iniciada en la página Cuenta cuando hay una, y se acepta sin cuenta en caso contrario. Nada más sale de la estación: no hay telemetría de uso.

Los comandos de depuración

Una compilación de desarrollo de la aplicación trae dos botones bajo el interruptor; una versión instalada no trae ninguno.

Comando Qué hace Atenuado cuando (situación) No se dibuja cuando (rol)
Simular una falla (depuración) Lanza un error no controlado en el hilo de la interfaz para que el camino de captura escriba un archivo de falla real y el siguiente arranque ejercite el flujo de consentimiento. Nunca. No en una compilación de versión.
Capturar una captura de pantalla (depuración) Corre la misma captura de pantalla que usan las herramientas de interfaz del agente, en el propio proceso, y escribe el resultado bajo el botón: "Guardado: <path>" o "La captura falló: <reason>". En un anfitrión sin ventana, el resultado dice que la captura no está disponible. Nunca. No en una compilación de versión.

Lo que esta sección no hace

Aquí no hay visor del diario técnico: el diario vive en Eventos, en su pestaña Consola, junto con la captura de diagnóstico y el paquete de soporte. Los reportes de fallas y las peticiones están en Avisos y sugerencias. El archivo de falla no se puede editar desde la aplicación, y la aplicación nunca envía nada sin el interruptor o sin el Enviar del diálogo.