Skip to main content

How to Use SF Veritas

Once you've installed the extension and instrumented your application, you can start using the SF Veritas debugging features.

Core Features​

SF Veritas provides three main views for debugging and verifying your applications:

Console​

The Console view displays all logs, exceptions, and print statements from your instrumented applications in real-time.

Key capabilities:

  • View logs from multiple services in one place
  • Advanced search with regex, boolean operators, and exact matching
  • Filter and Focus modes to narrow down relevant logs
  • Color-coded log levels (DEBUG, INFO, WARN, ERROR)

Learn more about the Console →

Flamechart​

The Flamechart view provides an interactive visualization of function execution traces, helping you understand the flow and performance of your code.

Key capabilities:

  • Visual call hierarchy showing function execution order
  • Click any function to jump directly to its source code
  • Zoom and pan to explore specific time periods
  • Multi-process support for microservices

Learn more about the Flamechart →

Verification​

The Verification Tracker helps ensure comprehensive testing coverage of your application's UI components, APIs, and user journeys.

Key capabilities:

  • Inbox view - Gmail-style queue of components needing verification
  • Action Queue - AI-powered suggestions for what to test next
  • Verification Explorer - Enterprise-scale browser for large codebases
  • AI test generation - Create unit and integration tests with Claude Code

Learn more about Verification →

Getting Started​

Opening the Views​

Use the Command Palette (Ctrl+Shift+P / Cmd+Shift+P):

  • SF Veritas: Show Console Logs - Open the Console view
  • SF Veritas: Show Flamechart - Open the Flamechart view

Or click the SF Veritas icon in the Activity Bar to access the sidebar panel.

Quick Workflow​

  1. Start your instrumented application
  2. Open the Console to see logs in real-time
  3. Trigger some actions in your application
  4. Use search/filter to find specific logs
  5. Open the Flamechart to see execution traces
  6. Click functions to navigate to source code

Common Use Cases​

Debugging an Error​

  1. Open the Console view
  2. Filter by log level: ERROR
  3. Search for the error message
  4. Click the stack trace to jump to the code
  5. Use the Flamechart to see what functions led to the error

Performance Investigation​

  1. Open the Flamechart view
  2. Look for functions with long execution times
  3. Identify bottlenecks in the call hierarchy
  4. Click functions to review the source code

Tracing a Request​

  1. Trigger a request in your application
  2. Use Console search to find related logs
  3. Switch to Flamechart to see the full execution flow
  4. Follow the function calls from entry to completion

Tips and Tricks​

Keyboard Shortcuts​

ActionShortcut
Open Command PaletteCtrl+Shift+P / Cmd+Shift+P
Search in ConsoleFocus search bar, type query
Clear ConsoleClick the clear button in toolbar

Managing Data​

  • Clear old data: Use the toolbar button or command
  • Adjust retention: Configure sfVeritas.databaseRetentionDays in settings
  • Limit storage: Configure sfVeritas.databaseSizeLimitMB for size limits

Multi-Service Debugging​

When running multiple services:

  1. Each service should have a unique serviceIdentifier
  2. Use the service dropdown in Console to switch between services
  3. Or select "All Services" to see everything combined

Next Steps​