Skip to content

kdallmeyer-sr/chrome-snowplow-inspector

 
 

Repository files navigation

Snowplow Inspector Chrome Extension

A debugging tool to help you examine and debug your Snowplow tracking implementation.

Features

At the moment, only Chrome/Chromium are supported, but we hope to add support for Firefox starting v60 (pending this API).

Feedback, feature requests, pull requests, and bug reports are welcome! Please file an issue.

Install

To install the extension, visit the page on the Chrome Web Store.

Schema Validation

At the moment, only Static Iglu Repositories are supported. Repository servers like the one used in Snowplow Mini) support will come at a later date.

Adding a repository

  1. Right-click the extension icon in the main browser toolbar

  2. Select Options

  3. Paste the URL to your repository in the Iglu Repositories field

  4. Repository URLs can be separated by spaces, lines, or commas

By default we include the URL for Iglu Central, which includes schemas for the built-in tracking JSONs. You can add as many repositories as you like.

Repository Setup

Make sure you have access to your repository from your browser in order for the extension to find your schemas. Typically repositories are hosted on S3, and by default the files may not be publically readable and will result in 403 errors. It is important to have your repository website or S3 bucket configured for Cross-Origin Resource Sharing. You can find out how to correctly configure an S3 bucket at How Do I Allow Cross-Domain Resource Sharing with CORS? the default rule should work, the extension only requires GET access. If you configure CORS correctly and schemas are still Unrecognised, try clearing your browser cache.

Develop

Build

Run npm install to install required dependencies, then npm run build to build the extension in the dist/ directory.

Instructions to install a local development version of the extension to test are over at the extension development documentation.

Hack

You can also use npm start to start webpack in watch mode and symlink the resources to make editing easier; source changes should then be reflected immediately in dist/. You will still need to reload the extension in Chrome.

About

Chrome extension for debugging Snowplow pixels.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • TypeScript 62.8%
  • JavaScript 23.1%
  • CSS 7.3%
  • HTML 6.8%