Gestion des erreurs

Si vous rencontrez des erreurs, il y a plusieurs endroits où aller regarder afin de déterminer la cause du problème. Le premier endroit est le fichier de log principal. Il recense tout ce qu'il se passe dans le traitement d'Open-Capture, même lorsqu'il n'y a pas d'erreurs. Ci-dessous des exemples de logs en fonction de l'installation (via systemd ou via supervisor). Pour les mails, les fichiers de logs sont situés dans /var/www/html/opencapture/data/MailCollect/*BATCH_NAME*. Les logs sont ensuite séparés par jours.

systemd

/var/www/html/opencapture/data/log/OpenCapture.log

[Open-Capture  ] 19-03-2021 17:03:59 INFO Processing file : /var/www/html/opencapture/data/exported_pdf//tmpov9aco7h/Facture_OpenNetWork_3.pdf
[Open-Capture  ] 19-03-2021 17:04:17 INFO Supplier found : Edissyum using VAT Number : FR71510268261
[Open-Capture  ] 19-03-2021 17:04:17 INFO Invoice number not found. Searching invoice number using position in database
[Open-Capture  ] 19-03-2021 17:04:17 INFO Invoice number found with position : 400019
[Open-Capture  ] 19-03-2021 17:04:17 INFO Due date found : 07/01/2012
[Open-Capture  ] 19-03-2021 17:04:17 INFO Invoice date found : 31/12/2011
[Open-Capture  ] 19-03-2021 17:04:20 INFO Footer informations found : [TOTAL : 10101.99] - [HT : 8348.75] - [VATRATE : 21.0]
[Open-Capture  ] 19-03-2021 17:04:20 INFO Order number found with position : 400019
[Open-Capture  ] 19-03-2021 17:04:21 INFO Invoice inserted in database
[Open-Capture  ] 19-03-2021 17:04:21 INFO All the usefull informations are found. Export the XML and end process
[Open-Capture  ] 19-03-2021 17:04:21 INFO Process end after 00:00:24.39

supervisor

MailCollect

Si jamais une erreur apparait dans l'interface web, vous empêche toute action et que rien n'est présent dans les fichiers de logs, il faudra aller regarder du côté les logs d'erreurs du service apache2. Vous pourrez voir l'erreur en utilisant la commande suivante. Avec cette erreur, vous pouvez ouvrir une issue sur le GitHub afin que nous puissions l'investiguer.

sudo tail -f /var/log/apache2/error.log

Si jamais le problème intervient lors du traitement de la facture (cette dernière ne remonte pas dans l'interface par exemple), ce sera le service gérant Open-Capture-Splitter ou Open-Capture-Vérifier qu'il faudra vérifier. Comme pour la partie web, avec les informations sur l'erreur, vous pouvez ouvrir une issue sur le GitHub.

Open-Capture Verifier

sudo systemctl status OCVerifier-worker_CUSTOMID

Open-Capture Splitter

Si vous êtes capable de corriger le problème vous-même, il faudra bien penser à redémarrer le service en question afin que les modifications soient prises en compte. Si vous utilisez supervisor, il faudra redémarrer le service web de la même manière que présenté ci-dessous. Cependant, pour les deux autres services, une seule commande sera nécessaire.

Service web

sudo systemctl restart apache2

Open-Capture Verifier

Open-Capture Splitter

supervisor

Dans le cas où le (ou les) worker est totalement down, ou qu'un document est bloqué pour X ou Y raisons (OOM par exemple), il sera possible de redémarrer totalement le service rabbitMQ, la librairie gérant les piles de documents et permettant de les traiter un par un.

sudo rabbitmqctl stop_app
sudo rabbitmqctl start_app