comparison doc/upgrading.txt @ 5323:762222535a0b

Allow http request logs to be logged using the python logging module so the user can log these entries to a rotating log file.
author John Rouillard <rouilj@ieee.org>
date Fri, 25 May 2018 21:23:44 -0400
parents ae32f082e623
children ba1ce44254df
comparison
equal deleted inserted replaced
5322:875605281b02 5323:762222535a0b
693 693
694 <input type="hidden" name="@template" value="index|search"/> 694 <input type="hidden" name="@template" value="index|search"/>
695 695
696 With this addition, the index template is displayed if there is no 696 With this addition, the index template is displayed if there is no
697 error, and the user stays on the search template if there is an error. 697 error, and the user stays on the search template if there is an error.
698
699 New -L (loghttpvialogger) option to roundup-server
700 --------------------------------------------------
701
702 Http request logs from roundup-server are sent to stderr or
703 can be recorded in a log file (if -l or the logfile options
704 is used). However there is no way to rotate the logfile
705 without shutting down and restarting the roundup-server.
706
707 If the -L flag is used, the python logging module is used
708 for logging the http requests. The name for the log
709 (qualname) is 'roundup.http'. You can direct these messages
710 to a rotating log file by putting the following::
711
712 [loggers]
713 keys=roundup.http
714
715 [logger_roundup.http]
716 level=INFO
717 handlers=rotate_weblog
718 qualname=roundup.http
719 propagate=0
720
721 [handlers]
722 keys=rotate_weblog
723
724 [handler_rotate_weblog]
725 class=logging.handlers.RotatingFileHandler
726 args=('httpd.log','a', 512000, 2)
727 formatter=plain
728
729 [formatters]
730 keys=plain
731
732 [formatter_plain]
733 format=%(message)s
734
735 into a file (e.g. logging.ini). Then reference this file in
736 the 'config' value of the [logging] section in the trackers
737 config.ini file.
738
739 Note the log configuration above is an example and can be
740 merged into a more full featured logging config file for
741 your tracker if you wish. It will create a new file in the
742 current working directory called 'httpd.log' and will rotate
743 the log file at 500K and keep two old copies of the file.
698 744
699 Migrating from 1.5.0 to 1.5.1 745 Migrating from 1.5.0 to 1.5.1
700 ============================= 746 =============================
701 747
702 User data visibility 748 User data visibility

Roundup Issue Tracker: http://roundup-tracker.org/