Looking for the latest version? Download LumberJack4Logs v1.13.0 (7.1 MB)
Home
Name Modified Size Downloads / Week Status
Totals: 16 Items   112.9 kB 5
LumberJack4Logs v1.13.0 2014-09-09 4 weekly downloads
LumberJack4Logs v1.12.1 2014-02-24 1 weekly downloads
LumberJack4Logs v1.12.0 2013-10-10 1 weekly downloads
LumberJack4Logs v1.11.0 2013-07-07 1 weekly downloads
LumberJack4Logs v1.10.0 2013-04-04 1 weekly downloads
LumberJack4Logs v1.9.0 2013-02-02 1 weekly downloads
LumberJack4Logs v1.8.0 2012-12-11 1 weekly downloads
LumberJack4Logs v1.7.0 2012-03-03 1 weekly downloads
LumberJack4Logs v1.6.1 2012-02-07 1 weekly downloads
LumberJack4Logs v1.5.0 2012-01-01 1 weekly downloads
LumberJack4Logs v1.4.5 2011-02-02 1 weekly downloads
plugin_howto.html 2014-09-09 31.5 kB 11 weekly downloads
readme.txt 2014-09-09 23.4 kB 11 weekly downloads
news.txt 2014-09-09 8.8 kB 11 weekly downloads
releasenotes.txt 2014-09-09 13.9 kB 11 weekly downloads
license.txt 2010-09-10 35.1 kB 11 weekly downloads
================================ LumberJack4Logs v1.13.x - Readme ================================ Description: LumberJack4Logs is a viewer for log and trace files with the ability to extend the recognized data formats by adding text parser plugins. Copyright (C): 2009-2014 Bernd Scharlemann State: 09.09.2014 Requirements: Java runtime v1.6 or higher. Installation: Unpack the LumberJack4Logs zip file anywhere. Make sure LumberJack4Logs has write permission for its own installation directory, e.g. avoid Window's standard programs directory. To install additional text log parsers plugins simply put them into the plugin subdirectory of LumberJack4Logs either bulk class files or packed in a jar or zip archive. Simple log4j-like parser plugins can be defined in the XML configuration file. Start: Execute start script in your LumberJack4Logs directory. If necessary make the start script executable. Uninstall: Simply delete the LumberJack4Logs directory. Notice: This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses. --------------- Time resolution --------------- The internal time resolution is always 1 picosecond, i.e. 12 decimal digits. The displayed time resolution will automatically conform with the loaded data and can be reseted to 1 millisecond with the option "Reset displayed time resolution". ---------------------------------------------------------------------- Environment variables (VM arguments -Dnet.scharlie.lumberjack4logs...) ---------------------------------------------------------------------- net.scharlie.lumberjack4logs.port Set a port number so that LumberJack4Logs acts as a socket server and may receive live log events from log4j socket appenders. The default value is "none", thus without socket server functionality. net.scharlie.lumberjack4logs.levelclass Set the name of a class which must be a subclass of org.apache.log4j.Level and defines additional log levels. The default value is net.scharlie.lumberjack4logs.level.Log4JLevel which is a direct subclass of org.apache.log4j.Level. NOTE: Overrules settings in the levels menu. net.scharlie.lumberjack4logs.filter Set the name of a filter file whose filter sets and combo box items will be loaded at program start. NOTE: Overrules "Auto reload auto saved filter sets and combo box items" switch from the filter menu. ------------------------------------------ Configuration file "./lumberjack4logs.xml" ------------------------------------------ The configuration file "./lumberjack4logs.xml" will be created if absent upon the first program start and stores following properties: <version> - The version of the program <charset> - The name of the character set, predefined: ISO-8859-1 <encoding> - Character sets which appear as choices in the encoding menu <loadPath> - The last visited load directory <savePath> - The last visited save directory <tableHeight> - The visible height of the table view <tableLayout> - Individual table layout (column widths and ordering). If you want to restore the default layout remove everything between <tableLayout> and </tableLayout> <wordwrap> - Flag whether word-wrap is on <customCopyLayout> - log4j layout pattern of the customizable copy function, predefined default: "%d{HH:mm:ss.SSS} %m%n" NOTE: Only <charset>, <encodings> and <customCopyLayout> properties should be manipulated manually. -------------------------------------------------- Configuration file "./lumberjack4logs_parsers.xml" -------------------------------------------------- The configuration file "./lumberjack4logs_parsers.xml" will be created if absent upon the first program start and stores following properties: <version> - The version of the program <log4jTextParser> - Log4j based text parser plugins, predefined: "Log4J-Parser-01" reads log files with the following layout pattern: %d{yyyy-MM-dd HH:mm:ss,SSS} ||| %t ||| %-5p ||| %c ||| %C.%M(%F:%L) ||| %x ||| %m%n "Log4J-Parser-02" reads log files with the following layout pattern: %d{yyyy-MM-dd HH:mm:ss,SSS} ||| %t ||| %-5p ||| %c ||| %x ||| %m%n NOTE: A "SSS" specifier acts as a place holder for 3 to 12 decimal digits. NOTE: Only <log4jTextParser> should be manipulated manually. You are free to change or remove predefined parsers. -------- Log file -------- LumberJack4Logs writes its own log messages into a text log file named "./lumberjack4logs.log". Please rename this file before analyzing it with LumberJack4Logs. --------------------------------------------- Loading and Saving (file menu and/or buttons) --------------------------------------------- If you load some log files successively all log events will be sorted by timestamp. Therefore log files which overlap in time will be chronologically merged. A progress bar shows the progress of loading a log file. The load file chooser remembers the last selection(s). "filtered" checkbox: If checked all loading and saving actions will only read or write those log events that match the actual event filter. "Load ..." with unchecked "filtered" checkbox: Reads one or more log files and loads all log events. There is a good chance that the data format (encoding of the input file) will be recognized automatically. The file extension may give a hint: ".bin" -> binary format (contains serialized log events) ".xml" -> XML format else -> All supported data formats also have a good chance to be identified without an adequate file extension. Packed files can be processed too. They must have one of the following file extensions: ".gz", ".zip" or ".jar". *** ATTENTION *** With packed files all contained files will be read in. "Load ..." with checked "filtered" checkbox: Like "Load" with unchecked "filtered" checkbox but only reads those log events that match the actual event filter. "More" with unchecked "filtered" checkbox: Reads log events added meanwhile starting from the last read position, also across file boundaries. "More" with checked "filtered" checkbox: Like "More" with unchecked "filtered" checkbox" but only reads those log events that match the actual event filter. "Follow" with unchecked "filtered" checkbox: Continously "More" with unchecked "filtered" checkbox. "Follow" with checked "filtered" checkbox: Like "Follow" with unchecked "filtered" checkbox" but only reads those log events that match the actual event filter. "Load & Follow ..." A combination of "Load" and a subsequent "Follow". For more information see "Load" and "Follow". "Stop" Stops any load action ("Load", "More" und "Follow"). "Select files to follow ..." Opens a popup menu with checkboxes for selecting those already loaded files which should take part in "More" and "Follow". To be selected is the default. "Save" with unchecked "filtered" checkbox: Writes all loaded log events into an output log file. You can choose the data format (encoding of the output file) from a list. The supported data formats are binary with serialized log events (bin), html, xml and plain text. "Save" with checked "filtered" checkbox: Like "Save" with unchecked "filtered" checkbox but only writes those log events that match the actual event filter. "Unload files ..." Opens a popup menu with checkboxes for selecting those already loaded files whose loaded log entries should be removed from the log entry list. "More" and "Follow" are still available for those files. It is like "Clear" but only for selected files. "Unload & Forget files ..." Like "Unload files ..." but "More" and "Follow" are no longer available for those files. They also disappear from the "Select files to follow ..." popup menu. "Clear" Removes all loaded log events. Does not alter the logger tree. "Clear incl. Tree" Removes all loaded log event and resets the logger tree. "Clear incl. Tree & Forget" Like "Clear incl. Tree" but "More" and "Follow" are no longer available. The "Select files to follow ..." popup menu is empty afterwards. "Load recent files ..." Opens a popup menu with checkboxes for selecting recently loaded files to be loaded. "Load & Follow recent files ..." A combination of "Load recent files ..." and a subsequent "Follow". "Exit" Terminates the programm. Progress bar Shows the progress of loading a log file. -------------------- Levels (levels menu) -------------------- Switches between different level schemas: "log4j" uses log level class net.scharlie.lumberjack4logs.level.Log4JLevel with the following level mappings: FATAL <== ASSERT ERROR <== SEVERE WARN <== WARNING INFO <== AUDIT, CONFIG, DETAIL DEBUG <== FINE, FINER TRACE <== FINEST, VERBOSE and others "java.util.logging" uses log level class net.scharlie.lumberjack4logs.level.Jdk14Level with the following level mappings: FATAL SEVERE <== ERROR WARNING <== WARN INFO <== AUDIT CONFIG <== DETAIL FINE <== DEBUG FINER FINEST <== TRACE and others "extended java.util.logging" uses log level class net.scharlie.lumberjack4logs.level.ExtendedJdk14Level with the following level mappings: FATAL SEVERE <== ERROR WARNING <== WARN AUDIT INFO CONFIG DETAIL FINE <== DEBUG FINER FINEST <== TRACE and others "android" uses log level class net.scharlie.lumberjack4logs.level.AndroidLevel with the following level mappings: ASSERT <== FATAL ERROR WARN INFO DEBUG VERBOSE <== TRACE and others You must restart LumberJack4Logs for the changes to take effect. ------------------------ Encoding (encoding menu) ------------------------ Sets the default text encoding for loading and saving of text and XML log files, e.g. "ISO-8859-1", "US-ASCII", "UTF-8" and "Windows-1252". The menu contents can be adjusted in the lumberjack4logs.xml configuration file. The current encoding is always shown in the upper right corner of the main window. -------------------- Filter (filter menu) -------------------- Filter sets and combo box items are saved automatically at program exit. They can be reloaded with the new menu item "Reload auto saved filter sets and combo box items". Filter sets can be or-combined to act as a unit. Every text based filter field has a new item in its context menu which quotes a text with \Q \E so that the string matches in the regular expression mode as if it were a literal pattern. "Add new filter set" Add a new empty filter set. "Remove current filter set" Remove the current filter set. "Load filter" "Auto reload auto saved filter sets and combo box items" Enables automatic reload of auto saved filter sets and combo box items from the XML file "./lumberjack4logs_FS_last.xml" at program start. NOTE: Can be overruled by setting the environment variable "net.scharlie.lumberjack4logs.filter" "Reload auto saved filter sets and combo box items" Reload auto saved filter sets and combo box items from the XML file "./lumberjack4logs_FS_last.xml". "Load filter sets and combo box items ..." Load filter sets and combo box items from a XML file. "Load filter sets ..." Load only filter sets from a XML file. "Load combo box items ..." Load only combo box items from a XML file. "Save filter" "Save current filter set ..." Save the current filter set to a XML file. "Save all filter sets and all combo box items ..." Save all non empty filter sets and all non empty combo box items to a XML file. "Save all filter sets ..." Save all non empty filter sets to a XML file. "Save all combo box items ..." Save all non empty combo box items to a XML file. "Clean up filter" "Reset current filter set" Resets all filters (Level/Thread/Logger/Context/Message/FromTime/ToTime/ Location/Stack) in the current filter set to their default values. "Reset all filter sets" Resets all filters (Level/Thread/Logger/Context/Message/FromTime/ToTime/ Location/Stack) in all filter sets to their default values. "Clean up filter sets (remove empty filter sets)" Remove all empty filter sets. "Remove current filter set" Remove the current filter set. "Remove all filter sets" Remove all filter sets. "Reset all combo boxes" Remove all items of all filter combo boxes (Thread/Logger/Context/ Message/FromTime/ToTime/Location) except for the currently visible and the empty items. Also the default values of the "FromTime" and "ToTime" combo boxes will be preserved. "Or-group" "Add current filter set to or-group" Or-combine the current filter set with other filter sets already in the or-group to act as a unit. "Remove current filter set from or-group" Undo or-combining the current filter set with other filter sets in the or-group. ---------------------- Options (options menu) ---------------------- "Reset displayed time resolution" Resets the displayed time resolution to 1 millisecond. --------------------------------- Opening a new log event list view --------------------------------- Click on the button with the workstation symbol (top left) to open a new sub-window for log event list viewing and filtering. ----------------------------------- Searching inside the log event list ----------------------------------- "search:" Here you can insert a search string. With the buttons showing a binocular you search forward or backward inside the log event list for the next log event containing your search string. *** ATTENTION *** For this search the log event list must have the focus. --------------------------------------- Affixing an entry in the log event list --------------------------------------- With a set fixed flag a log entry is always visible regardless of any filtering. ---------------------------------------------- Right click context menu in the log event list ---------------------------------------------- The relevant log event is the one which the mouse is over, not necessarily the selected event. Using the context menu enables you to copy the details of the log event directly into their corresponding filter fields. A customizable copy function copies all or some pre-configured parts of a log event to the clipboard. It can also be triggered with CTRL-C. Its layout is adjustable in the lumberjack4logs.xml configuration file. --------- Filtering --------- Any filtering is only effective on entries in the log event list which do not have the fixed flag set. Entries with the fixed flag set are always visible and never will be filtered out. Reset Resets all filters (Level/Thread/Logger/Context/Message/FromTime/ToTime/ Location) in the current filter set to their default values. Set Selection box to switch between different filter sets. Press the "+" entry to add a new empty filter set. Level Set the log level threshold. Shows only log events with a log level equal or higher than the log level threshold. With checked "sgl" checkbox the single level mode is on. With checked "inv" checkbox this filter is inverted. Thread Set the complete thread name as a search string. Shows only log events whose thread name exactly matches the search string. With checked "aA" checkbox the comparison is case sensitive. With checked "reg" checkbox the search string is treated as a regular expression. Shows only log events whose thread name matches the regular expression. In case of a syntax error in the regular expression an error message will be printed on the console. See also api-doc for class java.util.regex.Pattern. With checked "inv" checkbox this filter is inverted. Logger / Context / Message (3 fields) / Location Set a string fragment. Shows only log events whose logger name/context/message/location text contains this string fragment. With checked "aA" checkbox the comparison is case sensitive. With checked "reg" checkbox the input is handled as a regular expression. Shows only log events whose logger name/context/message/ location text contains a part matching the regular expression. The logger name/context/message/location text will be treated as a single line. In case of a syntax error in the regular expression an error message will be printed on the console. See also api-doc for class java.util.regex.Pattern. With checked "inv" checkbox this filter is inverted. Message (3 fields) (additional information) All message fields are AND-combined by default. With checked "or" checkbox this message filter is OR-combined with it's predecessor in a circular manner. OR-combined fields are marked with a gray checkbox background. FromTime Shows only log events whose timestamp is equal to or younger than this limit. Set a timestamp in the format "yyyy-MM-dd HH:mm:ss.SSS", e.g. 2007-05-28 08:40:08.045. Timestamps may be shortened except for the date, e.g. 2007-05-28 08:40. The missing parts will be completed automatically with reasonable values. With checked "exc" checkbox the given timestamp itself is excluded. With checked "inv" checkbox this filter is inverted. You can use up to 12 decimal digits. From the context menu you can set a "now" timestamp either in local time or in UTC. ToTime Like "FromTime" but shows only log events whose timestamp is equal to or older than this limit. With checked "exc" checkbox the given timestamp itself is excluded. With checked "inv" checkbox this filter is inverted. You can use up to 12 decimal digits. From the context menu you can set a "now" timestamp either in local time or in UTC. FromTime / ToTime (additional information) Both time fields are AND-combined by default. If both filters are inverted they are OR-combined. OR-combined fields are marked with a gray checkbox background. Stack With checked "msg" checkbox a stack trace is treated as a part of the message. With checked "yes" checkbox this filter is active. Shows only log events which contain a stack trace. With checked "inv" checkbox this filter is inverted. Logger tree Shows all loggers in a hierarchical tree structure. Unfold branches of the structure by clicking on the small switch symbols. A logger filter will be defined by activating or deactivating elements in the tree. Now only those log events will be shown whose logger is activated in this filter. Activate All Activates all loggers in the logger tree. Deactivate All Deactivates all loggers in the logger tree. Remove Events filtered out Removes all log events which do not match the actual filter settings. Thus some memory can be released. After this the info fields "Messages" and "Matches" will show the same values. Remove Events in Filter Removes all log events which match the actual filter settings. Thus some memory can be released. After this the info field "Matches" will show the value 0. Fix Events in Filter Set the fixed flag for all log events which match the actual filter settings. Release fixed Events Clear the fixed flag for all log events. Fix on This checkbox toggles activation of the fixed flag mechanism. auto-scroll This switch enables auto scrolling to the bottom of the log event list. Turning on auto scroll clears any previous selection. Any new selection or scrolling by hand will automatically turn off auto scroll. ----------- Info fields ----------- Window title Shows the names of the loaded log files. Status panel (footer) Memory usage Shows the current memory usage. Messages Shows the total number of loaded log events. Right hand side The space on the right hand side of the status panel is reserved for additional informations about memory usage. If you see the message "Memory is running short!" (> 70% memory usage) and you don't want to loose the oldest events please push the "Stop" button immediately. Otherwise (> 80% memory usage) the oldest events will be removed and you will be informed of it with the message "Memory was exhausted, removed the ... oldest events!". Fixed events will not be removed. Filter panel Matches Shows the number of events matching the actual filter. ------------- Detail window ------------- Shows the currently selected log event from the log event list with all related information. Here you can also select some text fragments to transfer them to corresponding filter fields with cut and paste (ctrl-c / ctrl-v). Found search items will be highlighted. Word-wrap This checkbox turns on/off the integrated word-wrap. Right click context menu Using the context menu on a selected text enables you to copy the selected text directly into certain filter fields where a partial selection makes sense. Using the context menu without any text selected enables you to copy the details of the log event directly into their corresponding filter fields. If no text is selected a customizable copy function copies all or some pre-configured parts of a log event to the clipboard. It can also be triggered with CTRL-C. Its layout is adjustable in the lumberjack4logs.xml configuration file.
Source: readme.txt, updated 2014-09-09