analytics

Analytics

Simple metric collector

This service exposes a simple event bulk ingestion endpoint. We use this to track events and trends. The metrics gets stored in postgres, services like Redash is used to query the data. We support the following libraries for event ingestion:

• analytics-python
• analytics-node
• analytics-go

Other Segment libraries that only uses the /v1/batch may work with this project. We don't perform any authentication checks, this service should only run on the local network.

Configuration

We use environment variables to configure the service.

• SENTRY_DSN - Send errors to Sentry
• LISTEN_ADDRESS="127.0.0.1:8000" - Address and port to listen on
• POSTGRES_URL="postgres://analytics:analytics@localhost/analytics?sslmode=disable" - Postgres connection details

You need to set the LISTEN_ADDRESS and POSTGRES_URL variables to start the service.

CLI

Start the apiserver

./analytics

Create the database table

./analytics -migrate

Tables

• identifies - A table with all of your identify method calls
• pages - A table with all of your page method calls
• screens - A table with all of your screen method calls
• tracks - A table with all of your track method calls
• groups - A table with all og your group method calls

Getting started

You need to install go and configure the GOPATH before you can build and run this project. We use godep to manage dependencies, run the line bellow to install it.

go get github.com/tools/godep

Pull dependencies and run the program.

godep get
go build
./analytics