Omnibug, a tool for web metrics debugging

Omnibug is a plugin for the Firefox Firebug addon to ease developing and debugging web metrics implementations. Each outgoing request (sent by the browser) is checked for a pattern; if a match occurs, the URL is displayed in a Firebug panel, and decoded to show the details of the request. In addition, requests can be logged to the filesystem.

The following metrics providers are supported by default:

Omnibug for Chrome

Omnibug is also available for Chrome. Head over to the Chrome page and for more details.

Get It

Make sure to install Firebug as well!

Omnibug will soon be available at addons.mozilla.org

Use It

  1. Bring up Firebug by pressing F12, or clicking the Firebug icon.
  2. In the Firebug panel, click the Omnibug tab.
  3. Load (or reload) a page with analytics tags to decode and display them.

Log file

The log file consists of four fields delimited by tabs: date, md5 sum of metrics URL, metrics URL and originating URL.

Sun Jan 18 2009 14:15:35 GMT+0100 (CET) b01eaf09e85ce7debb76e0d8aff16175 http://www.google-analytics.com/__utm.gif?utmwv=4.3&utmn=1379150988&utmhn=www.guidespot.com&utmcs=UTF-8&utmsr=1440x900&utmsc=24-bit&utmul=en-us&utmje=1&utmfl=10.0%20r12&utmdt=Guidespot.com&utmhid=444972883&utmr=-&utmp=/&utmac=UA-2418780-2&utmcc=__utma%3D169863095.2617619934608929300.1232283578.1232283578.1232284535.2%3B%2B__utmz%3D169863095.1232283578.1.1.utmcsr%3D(direct)%7Cutmccn%3D(direct)%7Cutmcmd%3D(none)%3B http://www.guidespot.com/


Screenshot (click to enlarge)

Omnibug screenshot


Show preferences table
Pref name Default value Description
extensions.omnibug.defaultPattern /b/ss/|2o7|moniforce\.gif|dcs\.gif|__utm\.gif This is the default regular expression to check URLs against.
extensions.omnibug.userPattern [not set] If defined, requests will also be checked against this expression. It should be used to add additional patterns.
extensions.omnibug.enableFileLogging false If true, requests will also be logged to a file (see logFileName). Can also be set in the UI via the Options menu
extensions.omnibug.logFileName [not set] If enableFileLogging is true, requests will be logged to this file. Can also be set in the UI via the Tools -> Choose log file menu entry
extensions.omnibug.usefulKeys pageName,ch,h1,purchaseID,events,products,pev2 Comma-separated list of key names that are grouped under the 'Useful' section (see screenshot)
extensions.omnibug.highlightKeys events,products Comma-separated list of key names that are highlighted with a background color (see color_hilite). This list can contain keys from any section.
extensions.omnibug.watchKeys [not set] Comma-separated list of key names that are active in the 'Watches' side panel. This list can contain keys from any section.
extensions.omnibug.alwaysExpand false If true, show entries on the Omnibug tab as expanded; otherwise shown as collapsed
extensions.omnibug.showQuotes true If true, surround values with quote marks; otherwise don't surround.
extensions.omnibug.color_load #dbedffExample Background color for load events
extensions.omnibug.color_click #f1ffdbExample Background color for click events
extensions.omnibug.color_prev #ffd5deExample Background color for events generated on the previous page
extensions.omnibug.color_quotes #f00Example Color for quotes surrounding values (see showQuotes)
extensions.omnibug.color_hilite #ff0Example Background color for highlight (see highlightKeys)
extensions.omnibug.color_hover #cccExample Background color for row hover

A preferences screen is available ("Prefs", on the top of the panel, to the right of the Firebug icon). Preferences can be changed there, via the "about:config" interface in Firefox, or by adding entries to user.js/prefs.js. Changes to preferences take effect immediately.


Omnibug is open-source software! You can check out the source code on GitHub. Pull requests welcomed!

Travis-CI Build Status


To report a bug, please use the issue tracker on GitHub.

To request a feature, or for general comments and questions, feel free to email me.


Omnibug is completely free to use. If you find it useful, you can make a donation (via PayPal) by clicking on the button below. There is no obligation, of course.


Omnibug for Firefox is distributed under version 2.0 of the Mozilla Public License.

Firefox, Firebug, Omniture/SiteCatalyst, WebTrends, Google Analytics, Urchin, Moniforce and Guidespot.com are the property of their respective owners.