Skip to content

Vitals Extension Troubleshoot Guide

Current Status

bash
[] Extension built successfully  
[] Package.json configuration fixed  
[] Activation event set to "\*" (activates on startup)  
[] Enhanced debugging added  
[] Mock Prometheus server running

Testing Steps

1. Open Extension Development Window

bash
cd /d/ceie/
code --extensionDevelopmentPath=. --new-window

2. Check Extension Activation

  • Look for popup message: "Vitals extension is now active!"

  • Open Developer Console: HelpToggle Developer ToolsConsole

  • Look for logs:

    bash
    🚀 Vitals extension activated
     Command "vitals.openDashboard" registered successfully

3. Test Command Palette

  • Press Ctrl+Shift+P (Windows) or Cmd+Shift+P (Mac)
  • Type: Open Vitals
  • Expected: Command should appear in the list

4. If Command Still Missing

Option A: Check Extension Host Console

  1. Open HelpToggle Developer Tools
  2. Go to Console tab
  3. Look for any error messages
  4. Check if extension activated properly

Option B: Reload Extension Host

  1. Press Ctrl+Shift+P
  2. Type: Developer: Reload Window
  3. Execute the command
  4. Check for activation message again

Option C: Check Extension List

  1. Go to Extensions panel (Ctrl+Shift+X)
  2. Search for "Vitals"
  3. Verify it shows as "Development Extension"

5. Manual Command Execution

If the command palette doesn't show the command, try:

  1. Press Ctrl+Shift+P
  2. Type: >vitals.openDashboard
  3. Press Enter

Common Issues & Solutions

Issue: Extension Not Activating

Symptoms: No popup message, no console logs Solutions:

  • Check if dist/extension.js exists
  • Verify VS Code opened with --extensionDevelopmentPath=.
  • Check for TypeScript compilation errors

Issue: Command Not Showing

Symptoms: Extension activates but command missing from palette Solutions:

  • Reload the window (Developer: Reload Window)
  • Check package.json syntax
  • Verify command ID matches between package.json and extension.ts

Issue: Command Exists But Fails

Symptoms: Command appears but throws error when executed Solutions:

  • Check webview bundle exists in webview/build/
  • Verify React components compile correctly
  • Check browser console for JavaScript errors

Debug Information to Collect

Extension Host Console

bash
🚀 Vitals extension activated
 Command "vitals.openDashboard" registered successfully
📊 Opening Vitals... (when command executed)

VS Code Output Panel

  • Go to ViewOutput
  • Select Log (Extension Host) from dropdown
  • Look for Vitals related logs

Browser Console (for webview)

  • Right-click in dashboard webview
  • Select Inspect Element
  • Check Console tab for React/JavaScript errors

Expected Results

  1. On VS Code startup: Popup "Vitals extension is now active!"
  2. In Command Palette: "Open Vitals" command visible
  3. When executed: Dashboard panel opens beside editor
  4. Dashboard content: Shows "Vitals" header
  5. Network activity: Requests to localhost:9090 for metrics

If All Else Fails

Try this minimal test:

  1. Open VS Code normally (not extension dev mode)
  2. Open Extensions panel
  3. Click "Install from VSIX..."
  4. Package the extension: vsce package
  5. Install the generated .vsix file

Next Steps

If the command still doesn't appear after following these steps, please share:

  1. Screenshot of Extension Host Console
  2. Contents of Output → Log (Extension Host)
  3. Any error messages in Developer Tools Console