Skip to content

Add page for Snowplow Local #1214

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: main
Choose a base branch
from
Open

Add page for Snowplow Local #1214

wants to merge 1 commit into from

Conversation

miike
Copy link
Contributor

@miike miike commented Apr 14, 2025

Adds a new page to the docs for Snowplow Local

@miike miike requested a review from mscwilson April 14, 2025 03:54
Copy link

netlify bot commented Apr 14, 2025

Deploy Preview for snowplow-docs ready!

Name Link
🔨 Latest commit 290d392
🔍 Latest deploy log https://app.netlify.com/sites/snowplow-docs/deploys/67fc86f066084000086e67ae
😎 Deploy Preview https://deploy-preview-1214--snowplow-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify site configuration.

Copy link
Collaborator

@mscwilson mscwilson left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We need to be very clear that this isn't official, supported product, despite being called Snowplow Local.

The README has the same info about what's it for, what's it do currently, plus the actual usage instructions. I would leave all that info there, and make this page more about pointing people towards the repo (and comparison with existing Snowplow products)

@@ -0,0 +1,44 @@
---
title: "Setting up Snowplow Local"
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think the page fits better in the API Reference section, below Micro and Mini. Please can you add a couple of details too:

  • a paragraph explaining why/when you'd use this pipeline over Micro/Mini
  • something about licensing and product support


Snowplow Local is a local-first limited version of the Snowplow data pipeline that's developer focused by allowing you to run the core Snowplow components locally.

This includes the Collector and Enricher as well as any of the streaming loaders for loading into BigQuery, Snowflake, Databricks or a data lake.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
This includes the Collector and Enricher as well as any of the streaming loaders for loading into BigQuery, Snowflake, Databricks or a data lake.
This includes the Collector and Enrich as well as any of the streaming loaders for loading into BigQuery, Snowflake, Databricks or a data lake.


## What is Snowplow Local?

Snowplow Local is a local-first limited version of the Snowplow data pipeline that's developer focused by allowing you to run the core Snowplow components locally.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

what does "developer focused" mean?


This includes the Collector and Enricher as well as any of the streaming loaders for loading into BigQuery, Snowflake, Databricks or a data lake.

Snowplow Local represents a quick way to get up and running with minimal effort. It uses Docker Compose to spin up and includes a basic UI to track events so you can see them undergoing enrichment throughout your pipeline in real time.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Snowplow Local represents a quick way to get up and running with minimal effort. It uses Docker Compose to spin up and includes a basic UI to track events so you can see them undergoing enrichment throughout your pipeline in real time.
Snowplow Local uses Docker Compose to spin up and includes a basic UI to track events, so you can see them undergoing enrichment throughout your pipeline in real time.


Snowplow Local represents a quick way to get up and running with minimal effort. It uses Docker Compose to spin up and includes a basic UI to track events so you can see them undergoing enrichment throughout your pipeline in real time.

Although Snowplow Local provides the core software for collecting, enriching, and storing events it only contains a minimal user interface for the control plane. For a more comprehensive UI consider [Snowplow BDP](https://docs.snowplow.io/docs/get-started/snowplow-bdp/) instead.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

needs screenshot of control plane, info about UI

@miike
Copy link
Contributor Author

miike commented May 15, 2025

We need to be very clear that this isn't official, supported product, despite being called Snowplow Local.

The README has the same info about what's it for, what's it do currently, plus the actual usage instructions. I would leave all that info there, and make this page more about pointing people towards the repo (and comparison with existing Snowplow products)

Thanks - adding it to these docs is part of it becoming an officially supported product, so once this is in I can remove that from the README!

I'll revise this version to have more info about the comparisons between the different products.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants