Architecture et diagnostic

Localiser une défaillance par le composant qui possède l'opération. Une réponse réussie du modèle, un calcul réussi et un artefact sauvegardé vérifié sont des observations différentes; recueillir les preuves pour l'étape qui a échoué.

Architecture et propriété

flowchart LR
  UI[Desktop or browser interface] --> MAIN[Application main process]
  MAIN --> STORE[Settings, database and managed files]
  MAIN --> AGENT[Agent framework and model provider]
  MAIN --> NB[Notebook runtime]
  MAIN --> SERVICES[Connectors and Compute Hosts]
  AGENT --> EVENTS[Messages and tool events]
  NB --> EVENTS
  SERVICES --> EVENTS
  EVENTS --> UI
  MAIN --> ART[Artifact versions and provenance]
  ART --> UI

Composante	Possède	Preuves à vérifier
Rendu et prévisualisation	Affichage de l'état, des contrôles, du contenu du fichier rendu	Page, projet/session sélectionné, nom de fichier, erreur de prévisualisation
Processus Main	Opérations persistantes, services d'application et limites d'accès	Erreur de fonctionnement et diagnostics associés
Cadre/fournisseur d'agents	Connexion du modèle, protocole d'exécution des tâches et flux de réponse	Cadre/fournisseur/modèle, test de connexion, outil défaillant ou tour
Notebook	Interprète, exécution de code, sorties et variables en direct	ID/version d'exécution, cellule défaillante, stdout/stderr et enregistrement d'exécution
Connecteur	Demande de service externe	Connector/nom de l'outil, entrées désinfectées, état/erreur du service
Hôte de calcul à distance	Accès SSH et emplois directs/programmés	Hôte/mode, résultat de la sonde, ID de travail et journaux distants
Dépôt Artifact	Versions gérées, bilans de contrôle et preuves saisies	ID de fichier/version, état du contenu, onglets Code/Environnement/Examen

Le chemin du bureau franchit la limite de précharge API. L'accès au navigateur utilise le service local protégé de l'application; Voir Service sans tête et accès au navigateur. Le navigateur n'est pas une deuxième base de données de recherche indépendante.

Distinguer le contenu des éléments de preuve

État ou message	Interprétation	Prochaine vérification
Contenu de l'article disponible	Les octets sélectionnés sont lisibles et passent la vérification d'intégrité applicable	Vérifier si le résultat scientifique est correct
Contenu non disponible : manquant	Le contenu attendu ne peut être trouvé	Préserver l'identité de la version et vérifier la disponibilité du stockage
Contenu non disponible : inadéquation du total de contrôle	Le contenu ne correspond pas à sa valeur d'intégrité enregistrée	Conserver le diagnostic; ne remplacez pas silencieusement les octets et appelez-le la même version
Capture partielle de l'environnement	Le dossier environnemental est incomplet	Lisez les avertissements de capture et conservez les détails de l'interprète ou du paquet indépendamment
Registre d'exécution bombé	Seuls des éléments de preuve d ' exécution immuable ont été retenus.	Inspecter les avertissements d'écart et le Notebook en direct, le cas échéant
Aucun avis pour cette version	Aucun résultat de l'examinateur n'est joint	Ne pas déclarer cette version telle qu'examinée

Ces états peuvent coexister. Inspecter séparément l'intégrité du contenu, les preuves d'exécution et le statut d'examen.

Recherche d'erreur

Surface de défaillance	Recherche canonique
Réponses du modèle/API, Connector ou du mandataire HTTP	Codes d'état HTTP
L'application ne peut pas ouvrir sa base de données	Codes de démarrage de la base de données
Notebook importations, chemins de fichiers et permissions	Messages d'erreur
SSH transport, chemins éloignés et statut d'emploi	Erreurs à distance
Soumission de l'émission et aide communautaire	Signaler un bug ou demander à la communauté

Gardez la source de l'erreur avec son identifiant. Un OS errno, une exception Python, un code d'erreur distant et le statut HTTP d'un fournisseur ne sont pas interchangeables. Copier le message d'accompagnement et la cause imbriquée lorsque disponible; un identificateur peut couvrir plusieurs chemins de défaillance.

Préserver un dossier de diagnostic utile

Enregistrez la version de l'application, le système d'exploitation, le projet/session touché, l'exploitation, le résultat attendu, l'erreur exacte et ce qui s'est passé immédiatement avant. Inclure le total des contrôles d'exécution et d'entrée lorsqu'un calcul est en cause; inclure la version d'artefact ou l'identifiant de travail à distance lorsqu'il y en a un.

Utilisez une vue Details, Détails du diagnostic ou log disponible pour conserver la cause de l'erreur, plutôt que seulement son titre court. Reproduire avec un apport public ou minimal lorsque c'est possible. Inspectez tout ce que vous partagez pour les jetons de compte, les en-têtes, les chemins privés et le contenu de recherche.

Le logger principal-processus écrit des lignes structurées JSON. Ses fichiers par défaut tournent à 5 MiB et conservent trois fichiers au total; un comportement spécial fatal-écriture peut dépasser l'ordinaire lié par un seul enregistrement. Les journaux ont donc une fenêtre de conservation et ne constituent pas une piste de vérification permanente. Un champ de diagnostic peut également être tronqué. Préserver un dossier pertinent peu après l'échec et distinguer l'absence de la preuve qu'un événement n'a jamais eu lieu.

Source: Enregistreur et conservation, rougeur du diagnostic, détail de défaillance Notebook limité et état du contenu des artefacts.

Tout d'abord, faire la distinction entre une opération échouée et un rafraîchissement/nettoyage échoué après un changement engagé, et distinguer l'exécution des tâches de base de l'exécution des résultats. Inspecter l'état sauvé avant de réessayer une mutation. Le Tableau de recouvrement orienté utilisateur couvre la restauration de la file d'attente bloquée, a conservé les références PDF, les modifications de la collection stale et les messages d'installation Windows. Tâches en arrière-plan explique l'état de l'exécution; Les erreurs de surveillance à distance demeurent distinctes des résultats finals.