This Visual Studio Code(tm) extension adds analysis and visualization features for log files and should ease debugging especially of complex systems where multiple log files need to be considered at the same time.
Note: It works well with to handle large log files (few hundred MBs).
Note: The time-sync feature works well with for DLT (diagnostic log and trace) files.
-
Configurable event tree-view (todo picture):
- Helps quickly to understand the structure or to highlight events (errors/warnings,...).
- Quickly jump to the event by selecting the item in the tree-view.
-
Configurable decorations (todo picture).
-
Time sync feature (todo movie...):
- Detects time for each line.
- An offset for the full file can be set via context menu item adjust time....
- If a time was received already the adjust-time... will propose to adjust/sync that line to the selected one.
- Posts events of the selected time to other documents/plugins. (See ... ).
- Allows to "synchronize" this time with other visible documents from all plugins that support "onDidChangeSelectedTime" events.
- Automatic time synchronization of multiple documents by "time-sync events" (see settings event.timeSyncId and event.timeSyncPrio) (todo add example).
-
Allows configuration of multiple file types (see settings smart-log.fileConfigs).
To open large log files please consider installing "vsc-lfs" extension.
This extension contributes the following settings:
smart-log.timeRegex
: Regular expression (regex) to identify the time of a log line.smart-log.timeFormat
: Optional time format specifier (details see config example).smart-log.decorations
: Definition of the decoration types supported for events.smart-log.fileConfigs
: Definition of the configuration per file type.
(todo add example configs)
- processing large files is kind of slow. Need to process time info and decorations in the background.
Any and all test, code or feedback contributions are welcome. Open an issue or create a pull request to make this extension work better for all.
are welcome! (Contact me for commercial use or different license).
- Use outline instead of own tree view
- add filtering based on events (remove all but the events)
- automatic timezone detection
- change "smart-log" file type automatically to sub-types
- change file type back to e.g. Log or Plain text if no config is found.
- add event icon support in tree view
- add event support to modify parent title
- add decoration for time-sync
See Changelog
This project leverages the following third party content.
d3-time-format (2.2.3)
- License: BSD-Clause-3 https://github.com/d3/d3-time-format/blob/master/LICENSE
- Source: https://github.com/d3/d3-time-format