Changes between Version 21 and Version 22 of LogViewerPlugin


Ignore:
Timestamp:
Nov 18, 2015, 8:45:02 AM (8 years ago)
Author:
figaro
Comment:

Cosmetic changes

Legend:

Unmodified
Added
Removed
Modified
  • LogViewerPlugin

    v21 v22  
    55== Description
    66
    7 This plugin allows you to view your `trac.log` logfile without shell access to the server, 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. Moreover, you may restrict the output to the latest N lines, and even filter for lines containing a specified string or even matching a regular expression.
     7This plugin allows you to view your `trac.log` logfile without needing shell access to the server, just via the Web-UI Admin interface. You can select to only display messages from a specified log level (e.g. only warnings), as well as optionally including higher levels. So if you select "Debug" and all higher levels, this means the entire log will be displayed. Moreover, you may restrict the output to the latest N lines, and even filter for lines containing a specified string or even matching a regular expression.
    88
    9 Be careful with large log files: use the tail-function to limit the output to the last few lines, because it would otherwise take a very long time to display.
     9Be careful with large log files: use the tail-function to limit the output to the last few lines, because it would otherwise take a long time to display.
    1010
    1111== Bugs/Feature Requests
     
    2121== Download
    2222
    23 Download the zipped source from [download:logviewerplugin here] (development version). You can also download the [attachment:LogViewerPlugin-0.2-py2.5.egg Python Egg] of the latest release from this page.
     23Download the zipped source from [export:logviewerplugin here] (development version). You can also download the [attachment:LogViewerPlugin-0.2-py2.5.egg Python Egg] of the latest release from this page.
    2424
    2525== Source
    2626
    27 You can check out LogViewerPlugin from [http://trac-hacks.org/svn/logviewerplugin here] using Subversion, or [source:logviewerplugin browse the source] with Trac.
     27You can check out LogViewerPlugin from [/svn/logviewerplugin here] using Subversion, or [source:logviewerplugin browse the source] with Trac.
    2828
    2929== Installation
     
    5858}}}
    5959
    60  `autoload`:: Decides whether you want to turn this feature on (`true`) or not. By default, it is turned off. All the other `auto*` settings only apply if you set `autoload = true`.
     60 `autoload`:: Decides whether you want to turn this feature on (`true`) or not. By default, it is turned off (`false`). All the other `auto*` settings only apply if you set `autoload = true`.
    6161
    6262 `autotail`:: Limit LogViewerPlugin to those many lines from the end of the file. Normally, 1000 lines will be enough, but if you want to show everything, simply set it to an empty value as shown below for `defaulttail`. Keep in mind that a large log file will take some time to display. So keep this value to something reasonable, and do the unusual full display on demand only.
     
    8484You find the ''Log Viewer'' on the ''Admin'' page in the ''General'' section (see [#Example below]). Having this page called, 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.
    8585
    86 You now can further restrict the amount of lines displayed: The ''Tail'' input works similar to the `tail -f` command, only showing the last N lines. If you input nothing here, this restriction is skipped, but if you do, the following search will be limited to these lines. In the ''Search'' input box you can enter a term which must be found in a line to be displayed. You can also use regular expressions here, in which case you must check the corresponding button. If you additionally check the "not" button, that search will be inverted, ie only lines ''not'' containing/matching your search term will be shown.
     86You now can further restrict the amount of lines displayed: the ''Tail'' input works similar to the `tail -f` shell command, only showing the last N lines. If you input nothing here, this restriction is skipped, but if you do, the following search will be limited to these lines. In the ''Search'' input box you can enter a term which must be found in a line to be displayed. You can also use regular expressions here, in which case you must check the corresponding button. If you additionally check the "not" button, that search will be inverted, ie only lines ''not'' containing/matching your search term will be shown.
    8787
    88 Hovering your mouse over the input areas will give you a short tooltip with the meanings.
     88Hovering your mouse over the input areas shows a tooltip with the meanings.
    8989
    9090Once you made your selections, push the button and the matching lines from the `trac.log` will be displayed.