Skip to content
| Marketplace
Sign in
Visual Studio Code>Debuggers>vscLogFilterNew to Visual Studio Code? Get it now.
vscLogFilter

vscLogFilter

Preview

gitofleonardo

|
26 installs
| (0) | Free
Filter offline Android logcat dumps in VS Code with Android Studio-compatible query syntax.
Installation
Launch VS Code Quick Open (Ctrl+P), paste the following command, and press enter.
Copied to clipboard
More Info

Log Filter

English | 简体中文

Android Studio Logcat-style log filtering for VS Code. Run Log Filter: Open (Ctrl+Shift+L) to filter with AS-compatible query syntax in a Beside Webview tab.

Features

  • Dual-tab workflow: source log editor + filter webview panel side by side
  • AS Logcat query syntax (except regex ~ modifiers)
  • Extensions: pid:, after:, before: for offline logs
  • Virtual scrolling for large result sets
  • Double-click / Enter to jump to source line
  • Saved queries: reuse common filter text from the Saved button next to the query box
  • Cherry View: pick filtered log lines into an embedded side pane (Ctrl/Cmd+Click or Shift+Click to multi-select, then right-click to pick); toggle with the Cherry button on the right
  • Auto-reveal filter tab when switching between open files
  • Large files: reads the editor buffer when VS Code exposes it; otherwise streams from disk via Worker; optional size confirmation (see Settings)
  • Live adb capture: Log Filter: Open Live Log Capture (status bar Log Capture or Ctrl+Shift+Alt+L) without opening a log file; full adb logcat to a temp file, full-log preview while recording, apply query after Stop

Usage

  1. Click the filter icon in the editor title bar, or press Ctrl+Shift+L
  2. Type a filter query in the filter panel
  3. Click Saved to store the current query or search previous ones; double-click an item to apply it
  4. Double-click a row to jump to the corresponding line in the source editor
  5. Cherry View: right-click a result row (or multi-select with Ctrl/Cmd+Click / Shift+Click) and choose Pick to Cherry View; use the Cherry toggle on the right edge to expand or collapse the picked list

Live adb capture

  1. Run Log Filter: Open Live Log Capture (or click status bar Log Capture)
  2. Pick an adb device; optionally toggle ⌫ Clear buffer (highlighted when on; runs adb logcat -c before start; capture still starts if clear fails)
  3. Use the record button to start (adb on PATH or set logFilter.adbPath); use the document toolbar icon to reopen the temp log if you closed its editor tab
  4. While recording, the query box does not filter results; the panel shows the full log. You can edit the query for use after stop
  5. Press the record button again to Stop and apply the current query. Closing the capture panel stops adb and deletes the temp file

Example

Filter a large offline logcat dump with field keys, explicit OR, and a time lower bound:

tag:AlarmManager pid:2917 tencent | device after:10:50:00

Log Filter example: source editor and filtered results side by side

Space-separated terms are combined with AND (same key → implicit OR). Explicit | / & are boolean OR / AND with normal precedence, so keys can participate in OR (e.g. tag:SurfaceControl | transition). Matching lines show keyword highlights.

Query Syntax

Syntax Meaning
tag:foo Tag contains foo
tag=:foo Tag equals foo exactly
-tag:foo Exclude tag containing foo
message:text Message contains text
line:text Full entry (incl. continuations) contains text
level:W WARN and above
pid:5689 Process ID match
age:5m Within 5 minutes of last log timestamp
is:crash / is:stacktrace / is:firebase Preset filters
after:11:02:00 / before:11:05:00 Time bounds
foo bar Both terms must appear on the full entry (AND)
tag:a tag:b Implicit OR for same key
tag:a -tag:b pid:1 AND when negation present
tag:foo \| bar Explicit OR (keys and text)
(tag:a \| tag:b) & level:E Explicit grouping

Not supported: package: (use pid:), tag~: regex (shows warning).

Settings

Setting Default Description
logFilter.confirmBeforeParseSizeMB 0 Optional confirm before parsing large files (MB). 0 = off.
logFilter.parseDebounceMs 200 Debounce after log edits before re-parse.
logFilter.queryDebounceMs 300 Debounce after query edits before re-filter.
logFilter.adbPath "" Path to adb; when empty, search PATH (adb.exe on Windows).

Parsing uses a Worker thread and streams file content when the editor buffer is unavailable (common for very large logs). Stale Worker results are discarded when the file or query changes.

Development

npm install
npm run build
npm test

Press F5 in VS Code to launch Extension Development Host.

Required: after feature or behavior changes, update tests under test/ and run the full suite with npm test before finishing. See docs/DEVELOPMENT.md (中文).

Reference

Android Studio Logcat filter sources (Apache 2.0) are vendored under reference/as-logcat/ for behavioral alignment.

Implementation details (parser, evaluator, highlighting): docs/SYNTAX.md (中文).

License

Apache License 2.0. See LICENSE and NOTICE.

  • Contact us
  • Jobs
  • Privacy
  • Manage cookies
  • Terms of use
  • Trademarks
  • Your Privacy Choices
  • Consumer Health Privacy
© 2026 Microsoft