LogDiver is a new Mac OS X tool to help you view, filter and diagnose problems with your log files.
LogDiver supports the following features:
The Import Dialog allows you to select which log files you would like to import. Upon file selection, LogDiver will attempt to determine what type of log file it is and helpfully suggests which Extractor should be used.
By default, each extractor comes with a default date format that you can override if your log file has localised dates.
Note that you can multi-select log files, but they must all use the same extractor.
There are three main ways that you can filter events from the main view. The first and best way to filter by timestamp is to use the Timeline Bar to quickly set a starting and ending time filter.
The second, more granular, way to filter events out is to use the Filter View to build a predicate on a field-by-field basis.
And the third way to control what columns you can see is to Control-Click on the column headings to choose which columns are visible.
If you are unable to find a pre-built extractor to suit your log file, you can always add your own using the Extractor Editor.
The Extractor Editor allows to you to define your own log file formats using regular expressions.
Using a group-based regular expression that matches your log file format, the Groups table will display as many rows as there are groups in your pattern. You can then allocate each group to the built-in LogDiver field names, and give the column an optional description.
You can also define whether the column is visible by default.
The Severity Map table allows you to enter specific strings that, when assigned to the Severity column, will be mapped to a particular severity type. For example, in some log files an error may be signified by an
E in the log file. Any strings that do not have an explicit mapping will use the Unknown severity type.
You can also provide a regular expression that will be used to assist the Import Dialog to determine whether your newly created extractor should presented as a suggested extractor. If the currently selected file matches this regular expression, your extractor will be included in the suggested extractor list.
And lastly, you can optionally provide a regular expression that is used to assist LogDiver to handle log lines that have spilled over onto multiple lines. As LogDiver reads each log line from the input file, if it matches the continuation regular expression, the line will be appended to the previous line instead of being parsed as a new log event.
LogDiver also gives you the ability to define your own log file formats.
LogDiver will be available soon in the Mac App Store, however, I am currently seeking feedback from interested parties for:
Please contact me at email@example.com if you would like to be involved, or to get a copy for beta testing.