Installation & Setup

Installation & Setup

Complete guide to installing and configuring the Overwatch Chrome Extension for your monitoring platforms.

Installation Methods

Chrome Web Store

Chrome Web Store Installation (Recommended)

The easiest way to install the extension is through the Chrome Web Store:

1. Open Chrome Web Store

   • Navigate to the Chrome Web Store
   • Search for “Overwatch Platform Extension”

2. Add to Chrome

   • Click the “Add to Chrome” button
   • Review the required permissions

3. Confirm Installation

   • Click “Add extension” in the confirmation dialog
   • Wait for installation to complete

4. Verify Installation

   • The Overwatch icon should appear in your Chrome toolbar
   • Icon will be grayed out until configured

Advantages:

• Automatic updates
• Verified and secure
• One-click installation
• No manual file management

Manual Installation

Manual Installation (For Development)

For development or custom builds, install the extension manually:

1. Download Extension Package

   • Obtain the extension package from your administrator
   • Or build from source: npm run build:dev (development) or npm run build:prod (production)

2. Enable Developer Mode

   • Open Chrome → Settings → Extensions
   • Or navigate to chrome://extensions/
   • Toggle “Developer mode” in the top right

3. Load Unpacked Extension

   • Click “Load unpacked” button
   • Navigate to the extension directory
   • Select extension/build/dev (development) or extension/build/prod (production)

4. Verify Installation

   • Extension should appear in the list
   • Toggle it on if disabled
   • Overwatch icon appears in toolbar

When to Use:

• Testing development builds
• Using custom organization builds
• Contributing to extension development
• Local platform testing (localhost integrations)

Initial Configuration

Step 1: Extension Activation

After installation, configure your Overwatch connection:

1. Open Extension Popup

   • Click the Overwatch icon in Chrome toolbar
   • Or use keyboard shortcut: Ctrl+Shift+O (Cmd+Shift+O on Mac)

2. Enter Organization URL

   • Enter your Overwatch instance URL
   • Format: https://your-org.overwatch.com
   • Click “Connect”

3. Authenticate

   • Enter your Overwatch credentials
   • Or use Single Sign-On if configured
   • Click “Sign In”

4. Verify Connection

   • Extension icon should turn green
   • Connection status: “Connected”
   • Your organization name should display

Organization Settings:

{
  "organization_url": "https://your-org.overwatch.com",
  "api_endpoint": "/api/v1",
  "websocket_endpoint": "/ws",
  "auto_connect": true
}

Step 2: Platform Permissions

Grant permissions for each monitoring platform you use:

1. Navigate to Platform

   • Open your monitoring platform (e.g., Datadog)
   • Extension will detect the platform automatically

2. Grant Permissions

   • Click “Allow” when prompted
   • Review requested permissions
   • Confirm platform access

3. Configure Detection

   • Enable automatic alert detection
   • Configure which data to extract
   • Set notification preferences

4. Test Detection

   • Navigate to an alert or dashboard
   • Extension should detect context
   • Verify extracted data is accurate

Supported Platforms:

• ✅ Datadog (app.datadoghq.com)
• ✅ New Relic (one.newrelic.com)
• ✅ Grafana Cloud (grafana.com)
• ✅ PagerDuty (app.pagerduty.com)
• ✅ SigNoz Cloud (signoz.io)
• ✅ Elasticsearch Cloud
• ✅ Kibana (cloud.elastic.co)
• ✅ Sentry (sentry.io)
• ✅ Honeycomb (ui.honeycomb.io)

Step 3: Verification

Verify extension is working correctly:

1. Check Connection Status

   • Extension icon should be green
   • Tooltip should show “Connected”

2. Test Platform Detection

   • Navigate to a known monitoring platform
   • Open an alert or dashboard
   • Extension should detect context

3. Test Incident Creation

   • Click extension icon on alert page
   • Verify context is extracted
   • Test “Create Incident” button

4. Verify Backend Communication

   • Open browser DevTools (F12)
   • Go to Console tab
   • Look for “Overwatch Extension” logs
   • Should see successful API calls

Platform-Specific Setup

Datadog Setup

Enable Datadog Integration:

1. Navigate to Datadog (app.datadoghq.com)
2. Open any alert or dashboard
3. Click Overwatch extension icon
4. Select “Enable Datadog Integration”
5. Configure extraction settings:
   • ✅ Auto-detect alerts
   • ✅ Extract metrics
   • ✅ Extract logs
   • ❌ Capture screenshots (optional)
6. Click “Save Settings”

What Gets Extracted:

• Alert name, severity, status
• Affected hosts and services
• Metric values and thresholds
• Log messages and timestamps
• Dashboard context and URLs

New Relic Setup

Enable New Relic Integration:

1. Navigate to New Relic (one.newrelic.com)
2. Open any error or APM page
3. Click Overwatch extension icon
4. Select “Enable New Relic Integration”
5. Configure extraction settings:
   • ✅ Auto-detect errors
   • ✅ Extract traces
   • ✅ Extract stack traces
   • ✅ Capture screenshots
6. Click “Save Settings”

What Gets Extracted:

• Error class and message
• Stack traces and affected code
• Transaction details
• Performance metrics
• User impact data

Grafana Setup

Enable Grafana Integration:

1. Navigate to Grafana (your-instance.grafana.com)
2. Open any dashboard
3. Click Overwatch extension icon
4. Select “Enable Grafana Integration”
5. Configure extraction settings:
   • ✅ Auto-detect alerts
   • ✅ Extract panel data
   • ✅ Extract time series
   • ✅ Capture screenshots
6. Click “Save Settings”

What Gets Extracted:

• Dashboard and panel titles
• Alert rules and status
• Metric queries (PromQL, LogQL)
• Time range and variables
• Annotation and events

PagerDuty Setup

Enable PagerDuty Integration:

1. Navigate to PagerDuty (app.pagerduty.com)
2. Open any incident
3. Click Overwatch extension icon
4. Select “Enable PagerDuty Integration”
5. Configure extraction settings:
   • ✅ Auto-sync incidents
   • ✅ Extract escalation policy
   • ✅ Extract timeline
6. Click “Save Settings”

What Gets Extracted:

• Incident ID and title
• Service and escalation policy
• Assigned team members
• Timeline and activity log
• Related alerts

Browser Compatibility

Supported Browsers

Recommended

Google Chrome (Version 88+)

• Full feature support
• Best performance
• Automatic updates
• All platforms supported

Microsoft Edge (Version 88+, Chromium-based)

• Full feature support
• Excellent compatibility
• Same features as Chrome

Compatible

Brave Browser (Version 1.20+)

• Full feature support
• Privacy-focused
• Chrome extension compatible

Opera (Version 74+)

• Full feature support
• Chrome extension compatible

Not Supported

Firefox

• Not currently supported
• Different extension architecture
• Requires separate build

Safari

• Not currently supported
• Different extension APIs
• Requires native implementation

Mobile Browsers

• Not supported
• Extension architecture limitations

Known Limitations

• Firefox and Safari are not currently supported
• Some features require specific Chrome APIs not available in other browsers
• Mobile browsers are not supported due to extension architecture
• Requires Chrome 88+ or equivalent Chromium-based browser

Post-Installation Checklist

After installation, verify these items:

• Extension icon visible in Chrome toolbar
• Connection status shows “Connected”
• Organization name displays correctly
• At least one platform integration enabled
• Test incident creation works
• Browser console shows no errors
• Extension version matches expected (v2.0+)
• Keyboard shortcuts work (test Ctrl+Shift+O)

Troubleshooting Installation

Extension Not Appearing

Symptoms: Extension icon not visible in toolbar

Solutions:

1. Check if extension is enabled in chrome://extensions/
2. Pin extension to toolbar (click puzzle icon → pin)
3. Restart Chrome browser
4. Reinstall extension

Permission Errors

Symptoms: “Permission denied” or “Access blocked” errors

Solutions:

1. Review requested permissions
2. Ensure Chrome version is 88+
3. Check organization firewall settings
4. Try manual installation method

Connection Failures

Symptoms: “Cannot connect to Overwatch” errors

Solutions:

1. Verify organization URL is correct
2. Check network connectivity
3. Verify Overwatch instance is accessible
4. Check browser console for specific errors
5. Contact administrator for network configuration

Platform Detection Issues

Symptoms: Extension doesn’t detect monitoring platform

Solutions:

1. Verify platform is in supported list
2. Check if platform-specific permission granted
3. Refresh page and wait for content to load
4. Enable platform in extension settings
5. Check browser console for errors

Next Steps

Now that the extension is installed:

• Configure Settings → - Customize behavior and preferences
• Platform Guides → - Platform-specific usage guides
• On-Demand Reporting → - Learn about problem reporting
• Workflows → - Common usage workflows

Need Help?

If you encounter installation issues, contact support@overwatch-observability.com.

---

Related Documentation:

• Configuration - Extension settings and preferences
• Troubleshooting - Common issues and solutions
• User Guide - Platform usage guide