- Notifications
You must be signed in to change notification settings - Fork10
Web Extension for debugging Snowplow pixels.
License
snowplow/chrome-snowplow-inspector
Folders and files
Name | Name | Last commit message | Last commit date | |
---|---|---|---|---|
Repository files navigation
A debugging tool to help you examine and debug yourSnowplow tracking implementation.
List and filter all your tracking events
See tracking parameters in human-friendly format
GET and POST tracking support
Automatically decode and parseSelf-Describing Events and Custom Entities
Validate your Entities and Events against the schemas in yourIglu Repository
Import events from your bad rows bucket/stream and see why they failed enrichment
Feedback, feature requests, pull requests, and bug reports are welcome! Pleasefile an issue.
At the moment, only Chrome/Chromium are supported via an official app store, and builds for Firefox are available, but not supported.The extension also works inMicrosoft Edge, but is not yet in the extension store.To install the extension, visit the page on theChrome Web Store.You can get builds for Firefox v60+ inReleases.
The Schema Manager inside the extension should let you load in local JSON Schema files during development, and you can also add your production or Snowplow Mini Iglu Repositories to test against what you have in production.
All of
Local Registries (embedded into the extension)
Iglu Servers (like the one used inSnowplow Mini)
Data Structures APIare supported.
Head to the extension pane in the Dev Tools, and hit the
Manage Schemas
button in the top toolbarIn the bottom right, hit
Registries…
, thenAdd
Fill out the details for you new Registry and save
Note your browser will request permission for the Extension to access the registries' Domain, this may happen in the main browser window rather than the Dev Tools window if it’s not docked
You can also import your pipeline’s configuration using Import and supplying aresolver-config
By default we include the URL forIglu Central, which includes schemas for the built-in tracking JSONs. You can add as many repositories as you like.
The Ngrok Tunnel import uses anNgrok tunnel in order to process events from remote devices.Ngrok provides a HTTP endpoint that we can use as the temporary collector endpoint.
By using this tunnel this allows you to test and debug events from additional devices and platforms including:
A separate mobile device (using a native or React Native app)
Server side events (e.g., server side Go codebase)
IoT devices (smart watch, TVs)
Any other device or implementation where you can override the Collector Endpoint
To start the tunnel ensure you have downloadedngrok
locally and create a new tunnel on the device you are running Chrome and the extension on, with:
$ ngrok http example.snplow.net
Whereexample.snplow.net
is the Collector hostname that you wish to forward requests on to.This can beMicro,Mini or any other Snowplow Collector / server that responds with a 200.
Once your tunnel has started ngrok will return a HTTP/S url (under 'Forwarding') that you should then use as your Collector host.Events sent to this host will be intercepted by ngrok and forwarded to your Snowplow destination without modification.
In addition ngrok will create a Web Interface that runs onlocalhost
(port4040
) by default.The API for this interface is used to retrieve events and insert them into the tool.If you wish to override or change this address you can do so in the options settings of the Chrome extension by right-clicking on the icon and opening Options.
If you wish to use a static address to forward to you can do so on one of the paid ngrok plans (a few dollars a month) to avoid having the hostname being dynamic.
To start visualizing these events open the debugger and select 'Import' then 'Ngrok Tunnel' which will begin to poll (via theNgrok Agent API) for events.
To stop streaming these events select 'Import' then 'Stop Ngrok Tunnel'.
Runnpm install
to install required dependencies and build the extension in thedist/
directory.
Instructions to install a local development version of the extension to test are over at theextension development documentation.
About
Web Extension for debugging Snowplow pixels.
Topics
Resources
License
Uh oh!
There was an error while loading.Please reload this page.
Stars
Watchers
Forks
Uh oh!
There was an error while loading.Please reload this page.
Contributors5
Uh oh!
There was an error while loading.Please reload this page.