Ganter Lab
Ouvrir une session Télécharger

Rapports de panne

Ce que la station conserve quand elle se ferme de façon inattendue, ce qu'elle envoie et quand elle demande, et les deux commandes de débogage qu'une version de développement porte.

Afficher en Markdown

Rapports de panne est la seule ligne du groupe DIAGNOSTIC de la page Paramètres. Une panne n'est jamais envoyée pendant que l'application tombe : elle est capturée dans un fichier, et le démarrage suivant l'envoie ou vous la montre et demande. Cette section porte le seul interrupteur qui décide lequel des deux. La page demande la permission Modifier les paramètres.

Envoyer les rapports de panne automatiquement

Champ Ce que c'est Valeurs / défaut Effet
Envoyer les rapports de panne automatiquement « Quand l'application se ferme sur une erreur, envoie le rapport au démarrage suivant sans rien demander. Désactivé : le rapport vous est montré et votre accord est demandé. » Activé ou désactivé. Désactivé par défaut. Activé : le démarrage suivant envoie le rapport capturé en silence et l'efface une fois que le serveur l'a accepté. Désactivé : le prochain démarrage visible ouvre la boîte de consentement.

Tant que le runtime est arrêté, cette page n'est pas dessinée du tout (voir Paramètres). La même acceptation est offerte à l'intérieur de la boîte de consentement elle-même, sous la case « Toujours envoyer les rapports d'incident automatiquement », et la cocher là active cet interrupteur. Sous l'interrupteur, la carte dit : « Pour signaler une anomalie, suggérer une amélioration ou demander un pilote, utilisez la page Compte. » Ce formulaire est Vos retours, parce qu'il envoie avec le compte Ganter.

Ce que contient un rapport

Quand une erreur non gérée fait tomber l'application, les gestionnaires globaux écrivent un seul fichier, crash\pending-crash.json dans la racine de données de la station, et ne conservent que la panne la plus récente. Il porte :

  • la version de l'application et la version de Windows;
  • l'endroit où l'erreur a été attrapée (Dispatcher, AppDomain, TaskScheduler, ou Startup pour un démarrage qui n'a pas abouti);
  • le type de l'exception, son message et le texte complet de la pile, exceptions internes comprises;
  • les 60 dernières lignes du fichier journal le plus récent, comme contexte menant à la panne;
  • le moment où elle est survenue.

Avant l'écriture, le nom d'utilisateur Windows et le chemin du profil sont remplacés par <user> et <userprofile> partout où ils apparaissent. Cet expurgement est un filet de sécurité, pas une garantie : des lignes de journal en texte libre peuvent porter d'autres noms, et c'est pourquoi la boîte montre toute la charge utile avant que quoi que ce soit ne parte.

Avec l'interrupteur désactivé, le premier démarrage visible après une panne ouvre Envoyer le rapport d'incident? par-dessus l'enveloppe : « Ganter Lab s'est fermé de façon inattendue la dernière fois. L'envoi de ce rapport nous aide à corriger le problème. Il contient l'erreur et un court extrait du journal récent. Relisez-le ci-dessous avant de l'envoyer. » La boîte Détail de l'incident montre exactement ce qui serait envoyé, avec un bouton Copier qui met le même texte dans le presse-papiers (« Copié » pour un instant) pour que vous puissiez le chercher ou le remettre au soutien technique. Si le presse-papiers refuse, le bouton indique « La copie n’a pas fonctionné », pour qu’une copie qui n’a pas eu lieu ne passe pas pour une copie réussie; le texte reste à l’écran et se sélectionne à la main.

Commande Ce qu'elle fait Grisée quand (situation) Non dessinée quand (rôle)
Toujours envoyer les rapports d'incident automatiquement (case à cocher) Active l'interrupteur ci-dessus à la fermeture de la boîte, que vous envoyiez ce rapport ou non. Tant que le runtime est arrêté (infobulle « Runtime arrêté »). La boîte appartient à l'enveloppe, alors elle est encore dessinée quand cette page ne l'est pas. Jamais.
Ne pas envoyer Écarte ce rapport et efface le fichier; il ne vous est plus redemandé. Jamais. Jamais.
Envoyer le rapport L'envoie. « Rapport d'incident envoyé » en notification en cas de succès; « Rapport d'incident non envoyé » avec la raison quand le serveur n'a pas pu être joint, auquel cas le fichier demeure et vous pouvez l'envoyer maintenant ou la question revient au démarrage suivant. Jamais. Jamais.

Un démarrage masqué dans la zone de notification (Démarrer avec Windows, ou un lancement --tray) n'affiche aucune boîte; le rapport attend le prochain démarrage visible. Avec l'interrupteur activé, l'envoi se fait en arrière-plan sans boîte, et une station qui était hors ligne conserve le fichier et réessaie au démarrage suivant.

Le rapport va au point de terminaison de retours du serveur Ganter. Il est attribué au compte Ganter dont la session est ouverte sur la page Compte quand il y en a un, et accepté sans compte autrement. Rien d'autre ne quitte la station : il n'y a pas de télémétrie d'usage.

Les commandes de débogage

Une version de développement de l'application porte deux boutons sous l'interrupteur; une version installée n'en a aucun.

Commande Ce qu'elle fait Grisée quand (situation) Non dessinée quand (rôle)
Simuler une panne (débogage) Lève une erreur non gérée sur le fil de l'interface pour que le chemin de capture écrive un vrai fichier de panne et que le démarrage suivant exerce le parcours de consentement. Jamais. Pas dans une version de production.
Capturer l'écran (débogage) Exécute la même capture d'écran qu'emploient les outils d'interface de l'agent, dans le processus, et imprime le résultat sous le bouton : « Enregistré : <path> » ou « Échec de la capture : <reason> ». Sur un hôte sans fenêtre, le résultat dit que la capture est indisponible. Jamais. Pas dans une version de production.

Ce que cette section ne fait pas

Il n'y a pas de visionneuse de journal ici : le journal vit dans Événements, sur son onglet Console, avec la capture de diagnostic et la trousse de soutien technique. Les signalements d'anomalies et les demandes sont dans Vos retours. Le fichier de panne n'est pas modifiable depuis l'application, et l'application n'envoie jamais rien sans l'interrupteur ou sans l'Envoyer de la boîte.