= View the trac.log file via the web frontend = == Description == This plugin allows you to view your `trac.log` logfile without shell access, just via the Web-UI Admin interface. You can select to only display messages from a specified log level (e.g. only warnings), optionally including higher levels. So if you select "Debug" and all higher levels, this means to display the entire log. Be careful with large log files ;) == Bugs/Feature Requests == Existing bugs and feature requests for LogViewerPlugin are [report:9?COMPONENT=LogViewerPlugin here]. If you have any issues, create a [http://trac-hacks.org/newticket?component=LogViewerPlugin&owner=izzy new ticket]. == Download == Download the zipped source from [download:logviewerplugin here]. == Source == You can check out LogViewerPlugin from [http://trac-hacks.org/svn/logviewerplugin here] using Subversion, or [source:logviewerplugin browse the source] with Trac. == Installation == The easiest way to install this plugin is: {{{ easy_install http://trac-hacks.org/svn/logviewerplugin/0.11/trunk }}} You can also checkout the code from the repository, or download and unpack the zipped source (see above) - and then run either `easy_install` or `python setup.py` from where the `setup.py` file resides. Moreover, you will need to enable the plugin for your trac environment(s): {{{ [components] logviewer.* = enabled }}} There's no more configuration required. == Usage == You find the ''Log Viewer'' on the ''Admin'' page in the ''General'' section (see [#Example below]). Having this page called, you select the log level you wish to see the entries for, using the drop-down. Optionally, you may chose to display all "higher priority" as well (where "higher" means the entries on top of the one you selected). An additional filter option is provided by the input box on the right: Here you may enter a search term - only lines including that term will be displayed then. Once you made your selections, push the button - and the matching lines from the `trac.log` will be displayed. == Example == Hell, what example? OK: Here is what it may look like, having selected "Warnings and above": [[Image(logviewer.jpg)]] == User Comments == * Your feedback here, please :-) == Recent Changes == [[ChangeLog(logviewerplugin, 3)]] == Author/Contributors == '''Author:''' [wiki:izzy] [[BR]] '''Contributors:'''