Super easy guide to test schemas with Micro OR any Collector

Last updated: July 14, 2026

  1. If you will send events to a Collector, skip until step 6 and also skip step 12.6
  2. NOTE: MICRO and Tracker Versions can vary, keep them updated!
  3. Micro is now Self-Serve! you can run it locally (steps below) or you can simply create a Micro in one of our Snowplow Sandbox accounts. Steps are here https://docs.snowplow.io/docs/testing/snowplow-micro/console/ 
    1. Once you finalize testing, delete the Micro from the Console Workspace to avoid unnecessary infra costs.
  4. If you will use Snowplow Micro and sending just page views or OOTB events, use:
  5. docker run -p 9090:9090 snowplow/snowplow-micro:4.2.0
  6.  
    1. Get the Iglu endpoint from a Console organization
    2. Get an Iglu API Key 
    3. https://console.snowplowanalytics.com/iglu-keys  If you need to use an external Iglu Repo:
    4. export MICRO_IGLU_REGISTRY_URL=https://com-example.iglu.snplow.net/api
export MICRO_IGLU_API_KEY=abcdef123456

docker run -p 9090:9090 \
  -e MICRO_IGLU_REGISTRY_URL \
  -e MICRO_IGLU_API_KEY \
  snowplow/snowplow-micro:4.2.0
    5. REMEMBER TO DELETE API KEYS AFTER YOU ARE DONE!
    6. Alternatively, you can add a custom schema to the Micro
    7. OR you can also use a custom Iglu Resolver config file.
  7. Then, create a single HTML file, name it index.html, with the next code. 
  8. If you need to send data to another Collector URL, just change it in tracker initialization code.
  9. Page View example:
  10. 

  
    
    
    Snowplow Tracker Example
    
    
    
  
  
    
    Hello, Snowplow!
  11. SelfDescribingEvent example. Of course, change the schema being referenced! and use a custom Iglu from step 2
  12. 

  
    
    
    Snowplow Tracker - Custom Event
    
    
  
  
    
    Track Custom Tournament Event
  13. Use NPM to create the simplest http server possible:
    1. Install Brew and run the below commands in iTerm or any terminal:
    2. brew install npm
npm install -g http-server
cd /Folder/whith/index.html
http-server
    3. Thats it. You have a working server. You can hit the above index.html by simply going to http://localhost:8080/ 
    4. After hitting that, the events will fire automatically. You can check Developer Tools to troubleshoot any issues (Check Network and Console).
    5. Changes to your html file will be instantly reflected. No need to restart the http-server.
    6. Go to your Micro UI http://localhost:9090/micro/ui/ and see the Events :) (Or use the Console details to open your Micro if you used a self-serve one).
    7. Happy hunting.