ctrl+shift+p filters: :st2 :st3 :win :osx :linux
Browse

Log​View

by FlashSystems ST3

Logfile viewer and highlighter for Sublime Text 3

Labels highlighting, logs

Details

  • 1.1.0
  • github.​com
  • github.​com
  • 10 months ago
  • 38 minutes ago
  • 3 years ago

Installs

  • Total 11K
  • Win 6K
  • OS X 3K
  • Linux 2K
Feb 21 Feb 20 Feb 19 Feb 18 Feb 17 Feb 16 Feb 15 Feb 14 Feb 13 Feb 12 Feb 11 Feb 10 Feb 9 Feb 8 Feb 7 Feb 6 Feb 5 Feb 4 Feb 3 Feb 2 Feb 1 Jan 31 Jan 30 Jan 29 Jan 28 Jan 27 Jan 26 Jan 25 Jan 24 Jan 23 Jan 22 Jan 21 Jan 20 Jan 19 Jan 18 Jan 17 Jan 16 Jan 15 Jan 14 Jan 13 Jan 12 Jan 11 Jan 10 Jan 9 Jan 8 Jan 7
Windows 2 7 10 3 5 16 5 5 11 8 5 2 11 17 6 8 8 1 2 4 6 16 11 3 4 4 13 14 15 11 7 1 3 4 9 12 6 3 4 2 7 8 11 13 6 1
OS X 0 6 2 0 4 3 2 2 3 5 2 0 2 4 9 0 4 1 0 2 4 6 5 2 2 3 6 3 4 9 4 3 3 4 4 8 5 0 3 0 8 5 5 4 4 2
Linux 0 2 3 0 0 3 4 1 2 2 1 1 5 1 1 6 1 0 3 1 2 4 0 7 1 0 3 3 3 0 3 0 2 0 2 3 10 2 0 0 1 3 3 5 3 0

Readme

Source
raw.​githubusercontent.​com

LogView

Logfile highlighter for Sublime Text 3.

ScreenShot

Requirements

This plug-in requires at least Sublime Text 3 Build 3065. Please download the correct sublime text version before using this plug-in.

Functionality

This Sublime Text 3 plug-in automates some common tasks when opening logfiles: - Automatically makes the file read-only to prevent accidental changes. - Search for common patterns and highlight them (see chapter “Automatic highlighting”) - Set bookmarks on the highlighted lines to speed up inspection of the matches.

Supported file extensions

All files using the extension .log are automatically opened as logfiles. Any other file can be treated as a logfile by changing the syntax to “Logfile”.

Installation

This package should be installed using Package Control. Follow these steps to install LogView: - Make sure you're using the correct Sublime Text 3 version (see Requirements). - Install Package Control if you don't already have it. - Use Package Control to search for LogView and install the package.

Editing the logfile

You have to switch to the “Plain Text” syntax in order to edit the opened logfile. As soon as you're done editing the file, you can switch back to the “Logfile” syntax. The file will automatically be parsed again and set to read-only.

Automatic highlighting

The LogView plug-in distinguishes three types of log entries: - errors - warnings - marks

Matching lines are marked with an icon within the gutter, too. If you only want the lines to have icons and no other hilighting should be performed set the highlight_style parameter within the config file to none.

It is possible to set a regular expression for detecting every type of log entry within the configuration file. If a file is loaded (or the file type is changed to “Logfile”) it is automatically processed and all lines, that contain matches to the configured regular expressions are automatically highlighted and bookmarked. This way it is possible to analyse logfiles much faster and find the relevant portions with the “goto bookmark” (F2) functionality. The line highlighting feature shows the critical areas in the logfile via the Minimap. Portions of the logfile with a high density of red or yellow marks may hint at a problem.

If more than one regular expression matches for a given line of the logfile all matches are counted. For highlighting the line the error_filter takes precedence over the warning_filter and the warning_filter takes precedence over the mark_filter.

The “error_filter”, “warning_filter” and “mark_filer” regular expressions contain sensible defaults. None the less you should tweak them to match the logfiles you're frequently dealing with.

Configuration parameters

Parameter Default Description
error_filter error\ fail\
error_scope markup.deleted Scope used for marking lines containing a match of the error_filter regular expression.
error_status_caption Errors Prefix for the number of lines containing a match of the error_filter regular expression. This can be used for I18N.
warning_filter warning\ not found\
warning_scope markup.changed Scope used for marking lines containing a match of the warning_filter regular expression.
warning_status_caption Warnings Prefix for the number of lines containing a match of the warning_filter regular expression. This can be used for I18N.
mark_filter [\w](start\ quit\
mark_scope markup.inserted Scope used for marking lines containing a match of the mark_filter regular expression.
mark_status_caption Marks Prefix for the number of lines containing a match of the mark_filter regular expression. This can be used for I18N.
auto_match_words true If this config option is set to true the reguluar expression set via error_filter, warning_filter and mark_filter is automatically extended to only match whole words. If you want to use the regular expressions as they are specified, set this value to false.
highlight_style underline Configures the style for marking the lines selected by the filters. Available styles are: fill, outline, underline and none. See default config for details.

All configuration parameters can be set via the Preferences menu. Just open Preferences > Package Settings > Log View > Settings.