Error reporting: Difference between revisions

m
mNo edit summary
Line 15: Line 15:


= Module Syslog =  
= Module Syslog =  
The error reporting module is integrated in the Dolibarr administration tool and allows you to configure what level of errors you would like to be reported and where.
The error reporting module is integrated with other Dolibarr modules. It allows you to configure what level of errors you would like to be reported and where.


To get to the error reporting module configuration page, go to Home, Configuration, Modules and use the configuration icon of the last module on the screen: ''System logs''.
To get to the error reporting module configuration page, go to Home, Configuration, Modules and use the configuration icon of the last module on the screen: ''Syslog''.


Of course, this module ('''System logs''') must be activated for the following to work.
Of course, this module ('''Syslog''') must be activated for the following to work.


The '''facility''' option allows you to use pre-set facilities to log your errors. Facilities are a system-level feature to tell your syslog operator where this error comes from, to judge priority and all that. You can find more about this inside the PHP documentation for the ''openlog()'' function which is used inside the ''dolibarr_syslog()'' function: http://www.php.ne/openlog
The '''facility''' option allows you to use pre-set facilities to log your errors. Facilities are a system-level feature to tell your syslog operator where this error comes from, to judge priority and all that. You can find more about this inside the PHP documentation for the ''openlog()'' function which is used inside the ''dol_syslog()'' function: http://www.php.ne/openlog
Really, you should leave it to '''LOG_USER''' unless you know exactly what you're doing.
Really, you should leave it to '''LOG_USER''' unless you know exactly what you're doing.


Line 28: Line 28:
Generally, the '''file''' facility will work more easily because it doesn't depend on your server configuration (or only for the directory that needs to be writeable).
Generally, the '''file''' facility will work more easily because it doesn't depend on your server configuration (or only for the directory that needs to be writeable).


Finally, the level of reporting is how many types of errors you want to report. LOG_DEBUG(7) is the strongest option, reporting pretty much everything that calls a dolibarr_syslog() function. LOG_EMERG(0) is the opposite, letting you see only the errors that would really block your system.
Finally, the level of reporting is how many types of errors you want to report. LOG_DEBUG(7) is the strongest option, reporting pretty much everything that calls a dol_syslog() function. LOG_EMERG(0) is the opposite, letting you see only the errors that would really block your system.


On a typical Linux install, the logs will then be available somewhere in '''/var/log/apache[2]/[dolibarr]-error.log'''. You can watch it ''live'' from the terminal by using:
On a typical Linux install, the logs will then be available somewhere in '''/var/log/apache[2]/[dolibarr]-error.log'''. You can watch it ''live'' from the terminal by using:
   tail -f /var/log/apache2/dolibarr-error.log
   tail -f /var/log/apache2/dolibarr-error.log