View Salesforce debug logs in real time directly inside VS Code. Automatically fetch new Apex logs, manage trace flags, filter users and inspect logs visually without opening the Salesforce Developer Console.
Features
📊 Interactive Log Viewer
Real-time log monitoring with auto-refresh capability
Sortable and customizable column layout
Visual indicators for unread and downloading logs
Search functionality by User/Operation for quick log filtering
Opening and downloading logs from your Salesforce Org
Option to clear all debug logs from your org
Filter logs displayed by current user or view logs from all users
📝 Log Details & USER_DEBUG Filtering
Open any Salesforce log in a detailed view with advanced navigation
Instantly filter to show only USER_DEBUG statements for focused debugging
Search within log details for specific events, operations, or debug output
Collapse and expand method blocks for easier navigation of large logs
Collapse or expand all methods with one button; searches and Debug only still show matching events inside folded methods
Read variable declarations and assignments with names, type badges, typed values, and previous recorded values from the same invocation
Inspect objects, lists, and long values without changing the log's row layout, and view or copy the original event
Explicitly truncated values are marked as partial; recorded numbers retain their original precision
⚡ Performance Features
Efficient log caching to avoid redundant downloads
GZIP compression support for large log files
Background log processing for smooth UI experience
Smart state preservation during auto-refresh when scrolling
🏳️ Trace Flag Management
View and clear all expired trace flags from your org with a single click
Set trace flags for specific users directly from the log viewer
Automatically manage trace flag expiration intervals for continuous log capture
Create custom debug levels and choose the level used by the extension's trace flags
🛠️ Configuration Options
Enable or disable automatic log refresh
Set the auto-refresh interval (milliseconds)
Show only current user's logs or all users' logs
Set expiration interval for Salesforce trace flags (minutes)
Show the output channel when the extension starts (for debugging purposes)
Extension Preview:
Requirements
Visual Studio Code 1.100.0 or higher
Salesforce CLI
Active Salesforce org connection
Installation
Install Visual Studio Code 1.100.0 or higher
Install the Salesforce CLI
Install this extension from the VS Code marketplace
Authenticate with your Salesforce org inside VSCode
Usage
Getting Started
Connect to your Salesforce org through VS Code
Open the Salesforce Logs panel from the Activity Bar
Your debug logs will automatically appear in the viewer
Click the button "Log Details" in the top right corner
If the org is not ready while VS Code is starting, use Salesforce AG Log Viewer: Retry Salesforce Connection from the Command Palette or the retry button in the Salesforce Logs panel. The extension reloads the saved Salesforce authentication and reconnects without requiring a VS Code window reload.
Visual Indicators
🟢 Green dot: Unread log
🟡 Yellow dot: Downloading log
⚪ Gray dot: Read log
Configuration Settings
The extension provides several settings to customize your log viewing experience. You can configure these in your VS Code settings (search for "Salesforce AG Log Viewer").
salesforceAgLogViewer.autoRefresh: Enable or disable automatic log refresh in the viewer panel.
salesforceAgLogViewer.refreshInterval: Set the interval (in milliseconds) for auto-refreshing logs when enabled. Minimum: 1000ms. Default: 5000ms.
salesforceAgLogViewer.currentUserOnly: If enabled, only logs belonging to the currently authenticated Salesforce user are shown. Disable to view logs from all users.
salesforceAgLogViewer.traceFlagExpirationInterval: Expiration interval (in minutes) for Salesforce trace flags. Minimum: 5, Maximum: 1439, Default: 15.
salesforceAgLogViewer.showOutputOnStart: Show the Salesforce AG Log Viewer output channel when the extension starts. Default: true.
Future Improvements
Add Salesforce Log colorizer
Release Notes
Check the CHANGELOG.md FILE for details
License
This project is licensed under the Creative Commons Attribution-NonCommercial 4.0 International License (CC BY-NC 4.0). This means:
You can share and adapt the code
You must give appropriate credit and indicate if changes were made
You cannot use this software for commercial purposes
