Version:

Events Tracking Assistant Quickstart

Get started with Events Tracking Assistant in less than 5 minutes.

  •   3 minute read  

This guide walks you through installation and your first use of the Events Tracking Assistant.

Prerequisites

Step 1: Install the extension

This section walks you through the process of installing the extension in your preferred browser.

Chrome

  1. Go to the extension’s page in the Chrome Web Store.
  2. Click Add to Chrome.
  3. Confirm the installation when prompted.

Firefox

  1. Go to the extension’s page in the Firefox Add-ons.
  2. Click Add to Firefox.
  3. Confirm the installation when prompted.

Step 2: Open a page with RudderStack

Navigate to any web page that has RudderStack JavaScript SDK installed.

Step 3: Open the extension

You can access the extension in two ways:

success
Prefer this option as the extension stays open as you navigate between pages and tabs.
  1. Open your browser’s Developer Tools (press F12 or right-click > Inspect)
  2. Click the » menu.
  3. Select RudderStack Assistant.
Developer Tools

Option 2: Browser toolbar

tip
Tip: Make sure to pin the Events Tracking Assistant extension in your browser’s toolbar first.

Click the Events Tracking Assistant extension icon in your browser’s toolbar. Note that the popup will close automatically when you switch tabs or navigate to a different page.

Browser Extension

Step 4: View your SDK status

The extension automatically detects your SDK and displays:

  • SDK version in the top right corner
  • Configuration status
  • Loaded destinations
  • Real-time events
Home Tab

If no SDK is detected, you can manually inject the SDK for testing. Enter your write key and data plane URL, then click Inject SDK.

warning
Not all sites support SDK injection due to strict Content Security Policy (CSP) headers. The extension indicates if injection is not supported.
Inject SDK

Step 5: Trigger events

warning
Open the extension before triggering events. The extension can only capture events sent after it is opened.
  1. Navigate to the Events tab of the extension
  2. Interact with your web page to trigger events.
  3. Watch events appear in real-time with their payloads and HTTP status codes.

Tabs overview

TabWhat it doesWhen to use
HomeQuick health overviewFirst place to check for issues
OverviewDetailed SDK configurationVerify setup, check destinations/plugins
EventsReal-time event monitoringDebug event tracking
AdvancedDeep debugging toolsTroubleshoot complex issues

See the Interface Reference guide for more details on these tabs.

See also

FAQ

Which browsers does this extension support?

The extension supports Chrome and Firefox.

Does this extension work with cloud-mode destinations?

Yes. The extension monitors all events sent from the SDK, regardless of destination mode. However, the Destinations section in Overview only shows device-mode destinations since those load directly in the browser.

Is my data sent to external servers?

No. All data stays local in your browser. The extension only monitors RudderStack SDK activity and does not send any data to external servers.

Can I use this extension in production?

Yes. The extension is safe to use in production for debugging purposes. It only observes SDK activity without interfering with your website’s functionality or performance.

Will this extension slow down my website?

No. The extension runs separately from your website and does not affect your website’s performance.

Questions? Contact us by Email or on Slack