[{"data":1,"prerenderedAt":262},["ShallowReactive",2],{"\u002Fnext\u002Fdodock\u002Ffonctionnalites\u002Foutils\u002Fgestion-des-erreurs":3,"section:\u002Fnext\u002Fdodock\u002Ffonctionnalites\u002Foutils\u002Fgestion-des-erreurs":261},{"id":4,"title":5,"body":6,"description":246,"extension":247,"meta":248,"navigation":249,"path":257,"seo":258,"stem":259,"__hash__":260},"docs\u002F2.next\u002F3.dodock\u002F04.fonctionnalites\u002F5.outils\u002Fgestion-des-erreurs.md","Gestion des erreurs dans Dokos",{"type":7,"value":8,"toc":237},"minimark",[9,13,26,31,42,46,80,96,100,103,106,166,169,189,193,197,200,229],[10,11,5],"h1",{"id":12},"gestion-des-erreurs-dans-dokos",[14,15,16,17,21,22,25],"p",{},"Dokos enregistre chaque erreur serveur dans le ",[18,19,20],"strong",{},"Journal des erreurs",". Chaque entrée reçoit une ",[18,23,24],{},"Empreinte",". Les erreurs qui ont la même empreinte viennent du même endroit du code : vous pouvez les compter et les traiter ensemble.",[27,28,30],"h2",{"id":29},"prérequis","Prérequis",[32,33,34],"ul",{},[35,36,37,38,41],"li",{},"Le rôle ",[18,39,40],{},"Gestionnaire système",".",[27,43,45],{"id":44},"consulter-le-journal","Consulter le journal",[47,48,49,54,69],"ol",{},[35,50,51,52,41],{},"Ouvrez la recherche (Ctrl+K) et saisissez ",[18,53,20],{},[35,55,56,57,60,61,64,65,68],{},"La liste montre le ",[18,58,59],{},"Titre"," de l'erreur, le ",[18,62,63],{},"DocType de référence"," et le ",[18,66,67],{},"Nom de référence"," quand l'erreur concerne un document.",[35,70,71,72,75,76,79],{},"Ouvrez une entrée pour lire le texte de l'",[18,73,74],{},"Erreur"," (la trace Python) et les ",[18,77,78],{},"Métadonnées"," : type de traitement (requête web ou tâche de fond), chemin, utilisateur.",[14,81,82,83,86,87,90,91,41],{},"Une entrée ouverte passe à ",[18,84,85],{},"Vu",". Les entrées sont supprimées après 14 jours par défaut. Réglez cette durée dans les ",[18,88,89],{},"Paramètres des journaux",". Les entrées sont stockées dans la base de journaux SQLite du site, et non dans la base principale : voir ",[92,93,95],"a",{"href":94},"\u002Fnext\u002Fdodock\u002Fdeveloppeurs\u002Fstockage-journaux-sqlite","Stockage des journaux dans une base SQLite",[27,97,99],{"id":98},"regrouper-les-erreurs-par-empreinte","Regrouper les erreurs par empreinte",[14,101,102],{},"Dokos calcule l'empreinte à partir du type de l'exception et, pour chaque niveau de la pile d'appels, du fichier, du numéro de ligne et de la fonction. Le chemin du bench est retiré. La même erreur a donc la même empreinte sur tous les sites d'un serveur.",[14,104,105],{},"Sur une entrée qui a une empreinte, un encadré affiche :",[107,108,109,122],"table",{},[110,111,112],"thead",{},[113,114,115,119],"tr",{},[116,117,118],"th",{},"Indicateur",[116,120,121],{},"Contenu",[123,124,125,136,146,156],"tbody",{},[113,126,127,133],{},[128,129,130],"td",{},[18,131,132],{},"Occurrences",[128,134,135],{},"Le nombre total d'erreurs avec cette empreinte. Cliquez dessus pour les lister.",[113,137,138,143],{},[128,139,140],{},[18,141,142],{},"Première occurrence",[128,144,145],{},"La date de la première erreur.",[113,147,148,153],{},[128,149,150],{},[18,151,152],{},"Dernière occurrence",[128,154,155],{},"La date de la plus récente.",[113,157,158,163],{},[128,159,160],{},[18,161,162],{},"Occurrences (30 derniers jours)",[128,164,165],{},"Un graphique du nombre d'erreurs par jour.",[14,167,168],{},"Les boutons du formulaire :",[32,170,171,177,183],{},[35,172,173,176],{},[18,174,175],{},"Afficher les erreurs similaires"," : la liste filtrée sur la même empreinte.",[35,178,179,182],{},[18,180,181],{},"Voir les erreurs associées"," : la liste filtrée sur le même document de référence.",[35,184,185,188],{},[18,186,187],{},"Ouvrir le document de référence"," : le document concerné.",[190,191,192],"mermaid",{},"\nflowchart TD\n    A[Erreur sur le serveur] --> B[Calcul de l'empreinte]\n    B --> C[Nouvelle entrée du journal]\n    C --> D[Encadré : occurrences, première et dernière date]\n    D --> E[Afficher les erreurs similaires]\n",[27,194,196],{"id":195},"exemple","Exemple",[14,198,199],{},"Exemple fictif : un utilisateur signale une erreur à la validation d'une facture.",[47,201,202,211,214,217,223],{},[35,203,204,205,207,208,210],{},"Ouvrez le ",[18,206,20],{}," et filtrez sur le ",[18,209,63],{}," « Facture de vente ».",[35,212,213],{},"Ouvrez l'entrée la plus récente.",[35,215,216],{},"L'encadré indique 15 occurrences, la première il y a 7 jours.",[35,218,219,220,222],{},"Cliquez sur ",[18,221,175],{},". Toutes les factures concernées s'affichent.",[35,224,225,226,228],{},"Lisez la trace de l'",[18,227,74],{}," pour trouver le script ou l'application en cause. Transmettez l'empreinte et la trace au support si besoin.",[230,231,234],"callout",{"color":232,"icon":233},"teal","i-heroicons-light-bulb",[14,235,236],{},"Une erreur sans empreinte a été enregistrée hors d'une exception Python, par exemple par un script qui écrit directement dans le journal.",{"title":238,"searchDepth":239,"depth":240,"links":241},"",1,2,[242,243,244,245],{"id":29,"depth":240,"text":30},{"id":44,"depth":240,"text":45},{"id":98,"depth":240,"text":99},{"id":195,"depth":240,"text":196},"Consulter le journal des erreurs et regrouper les erreurs semblables par empreinte pour les analyser et les corriger.","md",{"reviewed":249,"last_verified":250,"sources":251},true,"2026-11-04",[252,253,254,255,256],"frappe\u002Fcore\u002Fdoctype\u002Ferror_log\u002Ferror_log.json","frappe\u002Fcore\u002Fdoctype\u002Ferror_log\u002Ferror_log.py","frappe\u002Fcore\u002Fdoctype\u002Ferror_log\u002Ferror_log.js","frappe\u002Futils\u002Ferror.py","frappe\u002Fhooks.py","\u002Fnext\u002Fdodock\u002Ffonctionnalites\u002Foutils\u002Fgestion-des-erreurs",{"title":5,"description":246},"2.next\u002F3.dodock\u002F04.fonctionnalites\u002F5.outils\u002Fgestion-des-erreurs","Qoo0KGESURM1HurcOg1ihAM3VKTzSOuEkKmRD93I-_A",{},1793871767322]