LogLens is a lightweight, high-performance log viewer extension for Visual Studio Code. Designed specifically for developers who deal with massive log files, it provides a smooth "tail -f" streaming experience and powerful instant filtering capabilities.
🚀 Key Features
⚡ Active Log Streaming (Tail Mode): Uses a robust polling mechanism to scan and stream real-time log updates instantly without memory leaks.
🔍 High-Performance Instant Filtering: Filter thousands of log lines effortlessly on the frontend with lag-free keyword search.
🖱️ Smart Interaction (Ctrl + Click):
Normal Click: Seamlessly switch between different log streams in the custom dropdown.
Ctrl/Cmd + Click: Directly open the raw log file in the main editor without shifting your current dropdown view.
💾 State Persistence: Powered by a backend state machine, your log list, logs, active file path, and filter criteria are completely safe and restored even if the Webview is hidden or reloaded.
📖 How to Use (Usage)
Open the View: After installation, look at the VS Code bottom panel area (next to Terminal and Output). Click the LogLens tab (with the microscope icon) to open the log view container. Inside, you will see the Log Output view.
Select a Log: The extension will automatically scan your workspace for logs based on your configuration. Click the custom dropdown to pick the log stream you want to monitor.
Real-time Tail: Once selected, LogLens starts tailing the file. New log entries will append to the bottom in real-time.
Instant Search: Type any keyword into the filter input box. The log lines will be filtered instantly as you type.
Quick File Open: Hold Ctrl (or Cmd on Mac) and click any log option in the dropdown list to quickly open that physical file in your main editor grid.
💻 Contributed Commands
You can trigger the following actions from the VS Code Command Palette (Ctrl+Shift+P / Cmd+Shift+P):
LogLens: Open Log Viewer (loglens.openLog) — Opens and brings focus directly to the LogLens panel container.
LogLens: Reload Log Viewer Configuration (loglens.reload) — Forces a re-scan of the workspace and updates the configurations.
LogLens: Clear Log Screen (loglens.clear) — Clears the current log screen cache and display.
⚙️ Extension Settings
Configure LogLens via your VS Code Settings (settings.json):
logLens.include: Array of glob patterns or a single pattern to search for log files (Default: ["**/*.log"]).
logLens.exclude: Array of glob patterns to exclude from log scanning (Default: ["**/node_modules/**"]).
