[{"data":1,"prerenderedAt":521},["ShallowReactive",2],{"\u002Fv5\u002Fadministrer\u002Fexploitation\u002Fdiagnostic":3,"section:\u002Fv5\u002Fadministrer\u002Fexploitation\u002Fdiagnostic":520},{"id":4,"title":5,"body":6,"description":502,"extension":503,"meta":504,"navigation":505,"path":516,"seo":517,"stem":518,"__hash__":519},"docs\u002F1.v5\u002F5.administrer\u002F03.exploitation\u002F12.diagnostic.md","Diagnostiquer un site auto-hébergé",{"type":7,"value":8,"toc":492},"minimark",[9,13,26,37,42,54,73,77,83,121,127,207,226,230,235,257,272,276,283,347,367,374,378,381,426,437,441,451,455,473,477,488],[10,11,5],"h1",{"id":12},"diagnostiquer-un-site-auto-hébergé",[14,15,16],"blockquote",{},[17,18,19,20,25],"p",{},"S'applique à : auto-hébergé, Dokos v5. Sur Dokos Cloud, voir ",[21,22,24],"a",{"href":23},"\u002Fv5\u002Fadministrer\u002Fcloud\u002Fdepannage","Résoudre un problème de site Cloud",".",[17,27,28,29,33,34,25],{},"Commencez par le rapport de santé dans Dokos, puis passez aux commandes ",[30,31,32],"code",{},"bench"," sur le serveur. Les commandes s'exécutent dans le dossier du bench. Avec Docker, préfixez-les par ",[30,35,36],{},"docker compose exec backend",[38,39,41],"h2",{"id":40},"_1-lire-le-rapport-de-santé","1. Lire le rapport de santé",[17,43,44,45,49,50,53],{},"Ouvrez ",[46,47,48],"strong",{},"Aide > System Health"," (rôle Responsable système). Le rapport ",[46,51,52],{},"Analyse de la santé du système"," montre :",[55,56,57,61,64,67,70],"ul",{},[58,59,60],"li",{},"l'état du planificateur et le nombre de workers en ligne ;",[58,62,63],{},"les files d'attente et les tâches planifiées en échec sur 7 jours ;",[58,65,66],{},"les emails en échec ou en attente ;",[58,68,69],{},"les erreurs de la veille ;",[58,71,72],{},"la taille de la base, des fichiers et des sauvegardes.",[38,74,76],{"id":75},"_2-planificateur-inactif","2. Planificateur inactif",[17,78,79,82],{},[46,80,81],{},"Symptôme"," : les emails restent en attente, les tâches récurrentes ne tournent pas, l'import de données affiche « Le planificateur est inactif. Le système ne peut pas importer les données. »",[84,85,90],"pre",{"className":86,"code":87,"language":88,"meta":89,"style":89},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","bench --site dokompany.fr scheduler status\nbench doctor\n","bash","",[30,91,92,113],{"__ignoreMap":89},[93,94,97,100,104,107,110],"span",{"class":95,"line":96},"line",1,[93,98,32],{"class":99},"sBMFI",[93,101,103],{"class":102},"sfazB"," --site",[93,105,106],{"class":102}," dokompany.fr",[93,108,109],{"class":102}," scheduler",[93,111,112],{"class":102}," status\n",[93,114,116,118],{"class":95,"line":115},2,[93,117,32],{"class":99},[93,119,120],{"class":102}," doctor\n",[17,122,123,126],{},[30,124,125],{},"bench doctor"," indique pour chaque site si le planificateur est désactivé, en pause, inactif ou si le mode maintenance est actif.",[128,129,130,143],"table",{},[131,132,133],"thead",{},[134,135,136,140],"tr",{},[137,138,139],"th",{},"Cause",[137,141,142],{},"Correction",[144,145,146,161,175,185],"tbody",{},[134,147,148,156],{},[149,150,151,152,155],"td",{},"Planificateur désactivé (case ",[46,153,154],{},"Activer les Tâches Planifiées"," décochée)",[149,157,158],{},[30,159,160],{},"bench --site dokompany.fr scheduler enable",[134,162,163,170],{},[149,164,165,166,169],{},"Planificateur en pause (",[30,167,168],{},"pause_scheduler"," dans la configuration)",[149,171,172],{},[30,173,174],{},"bench --site dokompany.fr scheduler resume",[134,176,177,180],{},[149,178,179],{},"Mode maintenance resté actif après une mise à jour",[149,181,182],{},[30,183,184],{},"bench --site dokompany.fr set-maintenance-mode off",[134,186,187,198],{},[149,188,189,190,193,194,197],{},"Processus ",[30,191,192],{},"schedule"," arrêté (installation manuelle ; avec Docker : ",[30,195,196],{},"docker compose restart",")",[149,199,200,203,204],{},[30,201,202],{},"sudo supervisorctl status",", puis ",[30,205,206],{},"sudo supervisorctl restart all",[208,209,212],"callout",{"color":210,"icon":211},"amber","i-heroicons-exclamation-triangle",[17,213,214,215,218,219,218,222,225],{},"Sur une copie de la production, coupez les envois (",[30,216,217],{},"mute_emails",", ",[30,220,221],{},"mute_notifications",[30,223,224],{},"mute_payment_gateways",") avant d'activer le planificateur.",[38,227,229],{"id":228},"_3-workers-et-tâches-en-arrière-plan","3. Workers et tâches en arrière-plan",[17,231,232,234],{},[46,233,81],{}," : les rapports préparés, les imports ou les PDF en masse ne se terminent pas.",[84,236,238],{"className":86,"code":237,"language":88,"meta":89,"style":89},"bench doctor\nbench --site dokompany.fr show-pending-jobs\n",[30,239,240,246],{"__ignoreMap":89},[93,241,242,244],{"class":95,"line":96},[93,243,32],{"class":99},[93,245,120],{"class":102},[93,247,248,250,252,254],{"class":95,"line":115},[93,249,32],{"class":99},[93,251,103],{"class":102},[93,253,106],{"class":102},[93,255,256],{"class":102}," show-pending-jobs\n",[17,258,259,261,262,264,265,267,268,271],{},[30,260,125],{}," affiche le nombre de workers en ligne et les tâches en attente par file. Si aucun worker n'est en ligne, redémarrez les processus : ",[30,263,206],{}," en installation manuelle, ",[30,266,196],{}," avec Docker. Si une file déborde de tâches obsolètes, ",[30,269,270],{},"bench --site dokompany.fr purge-jobs --queue default"," les supprime.",[38,273,275],{"id":274},"_4-lire-les-journaux","4. Lire les journaux",[17,277,278,279,282],{},"En production, les journaux sont dans le dossier ",[30,280,281],{},"logs\u002F"," du bench :",[128,284,285,295],{},[131,286,287],{},[134,288,289,292],{},[137,290,291],{},"Fichier",[137,293,294],{},"Contenu",[144,296,297,307,317,327,337],{},[134,298,299,304],{},[149,300,301],{},[30,302,303],{},"web.error.log",[149,305,306],{},"Erreurs du serveur web",[134,308,309,314],{},[149,310,311],{},[30,312,313],{},"worker.error.log",[149,315,316],{},"Erreurs des tâches en arrière-plan",[134,318,319,324],{},[149,320,321],{},[30,322,323],{},"schedule.error.log",[149,325,326],{},"Erreurs du planificateur",[134,328,329,334],{},[149,330,331],{},[30,332,333],{},"node-socketio.error.log",[149,335,336],{},"Erreurs du temps réel (notifications instantanées)",[134,338,339,344],{},[149,340,341],{},[30,342,343],{},"backup.log",[149,345,346],{},"Résultat des sauvegardes planifiées",[84,348,350],{"className":86,"code":349,"language":88,"meta":89,"style":89},"tail -n 100 logs\u002Fworker.error.log\n",[30,351,352],{"__ignoreMap":89},[93,353,354,357,360,364],{"class":95,"line":96},[93,355,356],{"class":99},"tail",[93,358,359],{"class":102}," -n",[93,361,363],{"class":362},"sbssI"," 100",[93,365,366],{"class":102}," logs\u002Fworker.error.log\n",[17,368,369,370,373],{},"Dans Dokos, le ",[46,371,372],{},"Journal des Erreurs"," liste les erreurs de chaque site avec leur trace complète.",[38,375,377],{"id":376},"_5-espace-disque","5. Espace disque",[17,379,380],{},"Un disque plein bloque les sauvegardes, la base de données et les mises à jour.",[84,382,384],{"className":86,"code":383,"language":88,"meta":89,"style":89},"df -h\ndu -sh sites\u002F*\u002Fprivate\u002Fbackups sites\u002F*\u002Fprivate\u002Ffiles sites\u002F*\u002Fpublic\u002Ffiles\n",[30,385,386,394],{"__ignoreMap":89},[93,387,388,391],{"class":95,"line":96},[93,389,390],{"class":99},"df",[93,392,393],{"class":102}," -h\n",[93,395,396,399,402,405,409,412,414,416,419,421,423],{"class":95,"line":115},[93,397,398],{"class":99},"du",[93,400,401],{"class":102}," -sh",[93,403,404],{"class":102}," sites\u002F",[93,406,408],{"class":407},"sTEyZ","*",[93,410,411],{"class":102},"\u002Fprivate\u002Fbackups",[93,413,404],{"class":102},[93,415,408],{"class":407},[93,417,418],{"class":102},"\u002Fprivate\u002Ffiles",[93,420,404],{"class":102},[93,422,408],{"class":407},[93,424,425],{"class":102},"\u002Fpublic\u002Ffiles\n",[17,427,428,429,432,433,436],{},"Réduisez le ",[46,430,431],{},"Nombre de Sauvegardes"," conservées dans ",[46,434,435],{},"Paramètres Système"," si les sauvegardes occupent trop de place. Copiez les sauvegardes hors du serveur avant de les supprimer.",[38,438,440],{"id":439},"exemple","Exemple",[17,442,443,444,446,447,450],{},"Les emails de Dokompany ne partent plus depuis lundi. L'administrateur lance ",[30,445,125],{}," et lit « Maintenance mode on for dokompany.fr ». La dernière mise à jour s'est arrêtée sur une erreur. Il corrige l'erreur, relance ",[30,448,449],{},"bench update",", puis vérifie que le mode maintenance est désactivé.",[38,452,454],{"id":453},"vérifier","Vérifier",[55,456,457,466],{},[58,458,459,462,463,25],{},[30,460,461],{},"bench --site dokompany.fr scheduler status"," affiche ",[30,464,465],{},"Scheduler is enabled for site dokompany.fr",[58,467,468,469,472],{},"Dans ",[46,470,471],{},"System Health",", les workers sont en ligne et les emails en attente diminuent.",[38,474,476],{"id":475},"ce-qui-nest-pas-une-panne","Ce qui n'est pas une panne",[17,478,479,480,483,484,25],{},"Dans l'onglet ",[46,481,482],{},"Liens"," d'un formulaire, un compteur affiche « 99+ » au-delà de 99 documents liés. Dokos ne compte pas plus loin pour garder les formulaires rapides. Pour connaître le nombre exact, utilisez un rapport ou un tableau de bord ",[21,485,487],{"href":486},"\u002Fv5\u002Fapplications","Insights",[489,490,491],"style",{},"html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}",{"title":89,"searchDepth":96,"depth":115,"links":493},[494,495,496,497,498,499,500,501],{"id":40,"depth":115,"text":41},{"id":75,"depth":115,"text":76},{"id":228,"depth":115,"text":229},{"id":274,"depth":115,"text":275},{"id":376,"depth":115,"text":377},{"id":439,"depth":115,"text":440},{"id":453,"depth":115,"text":454},{"id":475,"depth":115,"text":476},"Vérifiez le planificateur, les workers, les journaux et l'espace disque d'un site Dokos auto-hébergé qui ne se comporte pas comme prévu.","md",{"reviewed":505,"last_verified":506,"sources":507},true,"2026-10-29",[508,509,510,511,512,513,514,515],"apps\u002Ffrappe\u002Ffrappe\u002Fcommands\u002Fscheduler.py (v5-dev)","apps\u002Ffrappe\u002Ffrappe\u002Futils\u002Fdoctor.py (v5-dev)","apps\u002Ffrappe\u002Ffrappe\u002Futils\u002Fscheduler.py (v5-dev)","apps\u002Ffrappe\u002Ffrappe\u002Fdesk\u002Fdoctype\u002Fsystem_health_report (v5-dev)","apps\u002Ffrappe\u002Ffrappe\u002Fhooks.py (v5-dev, standard_help_items)","bench 2.9.0 (bench\u002Fconfig\u002Ftemplates\u002Fsupervisor.conf)","helpdesk:30875","helpdesk:30236","\u002Fv5\u002Fadministrer\u002Fexploitation\u002Fdiagnostic",{"title":5,"description":502},"1.v5\u002F5.administrer\u002F03.exploitation\u002F12.diagnostic","CBSxfd_cYIFgWFbWEmYxJw32kovfkEdlTSJaulRbI_Q",{},1793871944828]