A Visual Studio Code extension for viewing and managing Salesforce debug logs with advanced features like auto-refresh, filtering, and improved readability.
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
⚡ 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
🛠️ 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.60.0 or higher
Salesforce CLI
Active Salesforce org connection
Installation
Install Visual Studio Code 1.60.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 AG Log Viewer panel from the Activity Bar
Your debug logs will automatically appear in the viewer
Click the button "Log Details" in the top right corner
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, 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
