Diagnostics

La navigation des Paramètres expose Events & Logs et À propos dans le groupe Diagnostics. Soundwave est également présent en mode développeur ou administrateur, mais ne fait pas partie du parcours d'assistance normal.

Événements et journal de logs

Le panneau Events & Logs réunit les deux journaux derrière une vue à onglets : Événements (le journal d'événements de l'application), Log Journal (les fichiers sous ~/.budgie/echo/logs) et une vue Tout qui couvre les deux. Un sélecteur de seuil de notification décide quels événements déclenchent aussi un toast — Debug, Info, Warning ou Error, Error par défaut. La barre d'outils fournit un filtre par niveau, une recherche, un choix de fichier de log, l'actualisation automatique et des actions Effacer par onglet.

Les Événements sont le premier endroit à consulter après l'échec d'un enregistrement, d'une opération sur un modèle, d'une requête fournisseur ou d'un workflow. Les lignes se déplient pour montrer les données structurées qu'elles portent. Effacer les Événements n'efface pas les fichiers de logs. Le détail peut contenir des noms de modèles, des paramètres d'action, des identifiants ou des erreurs : relisez-le avant de le copier.

Effacer les logs supprime définitivement ces fichiers après confirmation.

Les logs peuvent contenir des chemins, des informations de point de terminaison, le contexte du compte et les entrées d'action, ainsi que d'autres valeurs produites pendant un échec. Une sortie de diagnostic n'est pas automatiquement sûre à partager.

À propos

À propos affiche la version de l'application, l'état du compte et de l'abonnement, les quotas cloud et locaux, la relance de l'intégration et le formulaire d'assistance ; voir À propos. Les distributions directes proposent la recherche de mise à jour dans l'application ; les versions Mac App Store reçoivent leurs mises à jour par la boutique.

Signaler un bug envoie un titre et une description par la passerelle authentifiée. Si Inclure les logs de l'application est coché, Echo joint au maximum les 500 lignes les plus récentes, plafonnées à environ 100 Ko, du dernier log Echo. La requête peut aussi inclure les identifiants du compte, la version de l'application et la plateforme. Décochez l'option si vous ne pouvez pas relire et partager le log sans risque.

Dossier de dépannage

Pour produire un rapport utile, réunissez :

1. la version d'Echo, la plateforme et le canal de distribution depuis À propos et la matrice des plateformes ;
2. le déclencheur ou le bouton utilisé et le workflow minimal qui reproduit le problème ;
3. le premier avertissement ou la première erreur pertinente dans Événements ;
4. un court extrait utile des Logs, si nécessaire ;
5. le résultat attendu, le résultat observé et l'effet d'une nouvelle tentative.

N'envoyez pas l'historique entier des logs lorsqu'un court extrait suffit à identifier l'échec.

Masquage sûr

Avant d'envoyer ou de coller des diagnostics, retirez :

• les transcriptions, sélections, prompts, sorties de workflows et données client ;
• les chemins de dossier personnel, de fichier, d'enregistrement et de réseau privé ;
• les jetons d'accès, clés API, cookies, en-têtes d'autorisation et valeurs de liens profonds ;
• les adresses e-mail, identifiants de compte, de recette ou de machine, ainsi que les URL de points de terminaison lorsqu'ils ne sont pas indispensables ;
• les lignes sans rapport avant et après l'échec.

Le masquage est votre dernier contrôle : Événements et Logs sont des traces opérationnelles, pas une limite de confidentialité. Conservez l'horodatage, la sévérité, le sous-système, la version de l'application et le message d'erreur nécessaires au diagnostic.

Poursuivez avec le guide de dépannage pour les étapes de récupération propres à chaque problème.