vendayx loglens
vendayx loglens is a local, offline log file viewer and analyzer for Visual Studio Code. It opens .log files in a read-only custom editor, parses them in a worker thread, and makes large logs easier to search and inspect.
Privacy: 100% local. Log Lens has no network calls, telemetry, remote service, or external runtime dependency. Log contents remain on this machine. Masking affects display, exports, and copy actions; it does not alter the source file.
Features
- Detects JSON-lines, Nginx/Apache access and error records, Docker records, stack traces, and timestamp/level/message logs; falls back to plain text.
- Normalizes bracketed and common aliased severity labels; Docker
stdout/stderr is treated as stream metadata, not a severity by itself.
- Level color cues, per-level toggles, text and regular-expression search, and quick saved filters for the last 10 minutes.
- Full-scan visual statistics: level distribution, most frequent normalized messages, and service error/warning impact when service names are present.
- Groups repeated errors by normalizing timestamps, UUIDs, IP addresses, and numbers.
- Clickable minute-level timeline histogram split by log level.
- Foldable stack traces with source locations that open in the workspace.
- Click a log row to expand its complete raw record and stack trace inline; long traces can be scrolled within the expanded row.
- Live tail with pause/resume, truncation detection, and log-rotation handling.
- Optional masking of emails, IP addresses, JWTs, bearer tokens, and common API-key/secret patterns.
- Filtered JSON and CSV exports, and a Markdown bug report with neighboring log context.
- Worker-thread parsing, chunked line reads, virtualized rows, and bounded in-memory line retention.
Usage
Open a .log file normally and choose Log Lens when prompted, or run Log Lens: Open Current File from the Command Palette. Select Reopen Editor With… to return to the text editor.
Use the toolbar to toggle levels, search, pause tailing, mask sensitive data, view repeated-error groups, export filtered rows, or copy a bug report. The timeline buckets are one minute wide; selecting a bucket filters to that minute.
The viewer retains only the newest maxLinesInMemory parsed rows. Search, time filters, and exports operate on those retained rows; scanning, status counts, grouping (up to 5,000 distinct groups), and timeline aggregation run across the full file. This keeps memory bounded even for files larger than 500 MB.
Screenshots


The GIF paths above are placeholders for release screenshots.
Settings
| Setting |
Default |
Description |
logLens.maxLinesInMemory |
20000 |
Maximum retained rows for viewing, filtering, and export (100–200,000). |
logLens.defaultLevelFilter |
All levels |
Levels enabled when opening a file. |
logLens.maskSensitiveData |
false |
Starts the viewer with sensitive data masking enabled. |
logLens.customPatterns |
[] |
Regex definitions with named capture groups level and/or timestamp. |
Example custom patterns:
"logLens.customPatterns": [
{
"level": "(?<level>NOTICE|ALERT)",
"timestamp": "(?<timestamp>\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}:\\d{2})"
}
]
Regular expressions are evaluated locally against each line. Invalid expressions are reported by the parser worker instead of being silently ignored.
Commands
| Command |
Description |
Log Lens: Open Current File |
Opens the active log in the Log Lens editor (or prompts for a file). |
Log Lens: Search |
Focuses the viewer search field. |
Log Lens: Export Filtered Results as JSON |
Saves the filtered retained rows as JSON. |
Log Lens: Export Filtered Results as CSV |
Saves the filtered retained rows as CSV. |
Log Lens: Copy Bug Report |
Copies the selected or first visible error and two context rows on either side as Markdown. |
The search keybinding is Ctrl+Shift+F (Cmd+Shift+F on macOS) while the custom editor is active.
Development
Requirements: Node.js 18+, npm, and VS Code 1.85+.
npm install
npm test
npm run build
Open the folder in VS Code and press F5 to launch an Extension Development Host. Run npm run watch for incremental bundles.
Packaging
npm install
npm test
npm run build
npx vsce package
Before publishing, replace the example publisher and repository values in package.json, and replace the placeholder icon and GIFs with release assets.
Architecture
src/extension.ts registers the readonly custom editor, commands, status bar, filesystem watcher, and webview message bridge.
src/parser-worker.ts streams the file line-by-line, selects a modular parser, aggregates counts/timeline/error groups, and sends bounded batches.
src/parsers/ contains format parsers implementing LogParser.
src/grouping/ and src/utils/ hold normalized error grouping and sensitive-data masking.
src/webview/ is a plain TypeScript/HTML/CSS interface using VS Code theme variables and a fixed-row virtualized list.