Troubleshooting Guide

Symptoms:

• Installation fails with error message
• Extension doesn’t appear in extensions list
• Chrome shows “Installation failed” message

Solutions:

1. Check Chrome Version

   • Ensure Chrome is version 88 or higher
   • Update Chrome to the latest version

2. Clear Browser Cache

   • Go to chrome://settings/clearBrowserData
   • Clear cookies and cached images
   • Restart Chrome and try again

3. Check Network Connection

   • Ensure stable internet connection
   • Try from different network if possible
   • Disable VPN temporarily

4. Chrome Web Store Issues

   • Check if Chrome Web Store is accessible
   • Try accessing from different browser
   • Wait and retry later (temporary server issues)

Symptoms:

• “Invalid manifest” error
• Extension doesn’t load after manual installation
• Chrome shows error messages

Solutions:

1. Verify File Structure

   • Ensure all required files are present
   • Check manifest.json exists and is valid
   • Verify folder contains extension files

2. Enable Developer Mode

   • Go to chrome://extensions/
   • Toggle “Developer mode” in top right
   • Try loading extension again

3. Check File Permissions

   • Ensure Chrome can access the folder
   • Move folder to different location if needed
   • Check folder isn’t in restricted location

Symptoms:

• Connection fails with error message
• Extension shows “Connection failed”
• Credentials are rejected

Solutions:

1. Verify RabbitMQ Server

   • Check if RabbitMQ is running
   • Verify server is accessible from your machine
   • Test connection in browser directly

2. Check Credentials

   • Verify username and password are correct
   • Check if user account is active
   • Ensure user has required permissions

3. Network Issues

   • Check firewall settings
   • Verify port 15672 is open
   • Test network connectivity to server

4. URL Format

   • Use correct protocol (http/https)
   • Include port number if non-standard
   • Ensure URL is accessible from browser

Symptoms:

• “Invalid credentials” error
• “Access denied” message
• User permissions insufficient

Solutions:

1. User Permissions

   • Check user has management plugin access
   • Verify user can access RabbitMQ API
   • Ensure user isn’t locked or expired

2. RabbitMQ Configuration

   • Check management plugin is enabled
   • Verify user has correct tags
   • Check RabbitMQ access control lists

3. Security Settings

   • Check if authentication is required
   • Verify SSL/TLS settings
   • Check IP restrictions if configured

Symptoms:

• Charts don’t appear
• Data doesn’t load
• Dashboard shows empty or error

Solutions:

1. Check Feature Toggles

   • Ensure dashboard features are enabled
   • Verify correct features are selected
   • Check if features are available for your RabbitMQ version

2. API Access

   • Verify RabbitMQ API is accessible
   • Check user has required permissions
   • Test API endpoints directly

3. Data Issues

   • Check if queues exist
   • Verify there’s data to display
   • Check RabbitMQ server logs for errors

Symptoms:

• Can’t download messages
• Upload fails
• Connection management doesn’t work

Solutions:

1. Feature Permissions

   • Check if management features are enabled
   • Verify user has management permissions
   • Ensure features are available for your use case

2. Queue Access

   • Verify user can access specific queues
   • Check queue permissions
   • Ensure queues exist and are accessible

3. API Limitations

   • Check RabbitMQ version compatibility
   • Verify API endpoints are available
   • Check for rate limiting or restrictions

Symptoms:

• Slow response times
• High memory usage
• Extension freezes or crashes

Solutions:

1. Reduce Update Frequency

   • Change from real-time to standard updates
   • Increase update intervals
   • Use manual refresh mode

2. Optimize Cache Settings

   • Reduce cache size
   • Clear cached data
   • Restart extension

3. Check Resource Usage

   • Monitor Chrome memory usage
   • Close unnecessary tabs
   • Restart Chrome if needed

4. Network Optimization

   • Check network latency
   • Use local RabbitMQ if possible
   • Optimize network settings

Symptoms:

• Chrome becomes slow
• High memory consumption
• Extension crashes

Solutions:

1. Clear Extension Data

   • Go to extension settings
   • Clear stored data
   • Reset to default settings

2. Reduce Data Retention

   • Decrease cache size
   • Limit historical data
   • Use manual refresh mode

3. Monitor Usage

   • Check Chrome task manager
   • Identify memory leaks
   • Restart extension regularly

4. Optimize Settings

   • Disable unused features
   • Reduce update frequency
   • Use minimal configuration

Symptoms:

• Credentials not saved
• Security warnings
• Access denied

Solutions:

1. Check Chrome Permissions

   • Verify extension permissions
   • Check storage access
   • Review security settings

2. HTTPS Requirements

   • Use HTTPS for production
   • Check SSL certificates
   • Verify secure connections

3. User Access Control

   • Review RabbitMQ user permissions
   • Limit user access as needed
   • Use dedicated monitoring user

4. Network Security

   • Check firewall settings
   • Use VPN if required
   • Verify network policies