Chocolat is a Keen.io-compatible API server for Collecting Event Data, and Analyzing. Most of data analysis services don't allow to use event data directly. Bring event data of your service.

Keen.io is awesome, and developer-friendly service. SDK is well-documented, and a lot of open sources are provided. By building keen.io-compatible API server, we can use plenty of resources. If you need robust support (stability, scalability, etc), then use Keen.io.

Demo page

This demo includes keen-js, Data Explorer. Try to use keen.js client, and explore metrics below.

• Go 1.4+
• MongoDB 2.2+ (See Status)
• Sqlite3 (development)
• Mysql, Postgres (production)

Before running chocolat, make sure that mongo is running (localhost). Check out config/dbconf.yml, config/repoconf.yml.

Clone this repository:

git clone https://github.com/angdev/chocolat.git

Install go package dependencies:

go get .

or if you use godep,

godep restore

Build and Run:

go build && ./chocolat -r

If you want to install:

go install

but chocolat should be executed at chocolat directory, because of configuration files.

Database (Mysql, Postgres, ...) configuration is at config/dbdonf.yml. Repository (MongoDB, for event collections) configuration is at config/repoconf.yml. You can set config values directly, or using environment variable. (YAML files are preprocessed by golang template package)

CHOCOLAT_PORT=3000, CHOCOLAT_ENV=development, REPO_URL, DATABASE_DRIVER, DATABASE_URL are configurable. web.environment @ docker-compose.yml will be a help to you.

./chocolat -c

./chocolat -l

./chocolat -p {{.projectID}}

./chocolat -r

./chocolat -h

Create a new project:

./chocolat -c

Then chocolat prints PROJECT_ID, MASTER_KEY, READ_KEY, WRITE_KEY.

And you can use chocolat with keen.io sdk like below (Javascript client example):

<script src="//cdn.jsdelivr.net/keen.js/3.2.5/keen.min.js" type="text/javascript"></script>
<script type="text/javascript">
  var client = new Keen({
    projectId: "{{PROJECT_ID}}",
    writeKey: "{{WRITE_KEY}}",
    readKey: "{{READ_KEY}}",
    protocol: "http",
    host: "localhost:3000",
  });
</script>

If want to use with rails, then just use Ruby Client.

Follow instructions: Explorer Quick Setup

and then just add chocolat project id, api keys!

Build chocolat image:

docker build -t chocolat .

You can test chocolat by using docker compose:

docker-compose up

Chocolat is in active development.

Currently, it just works at local development environment. It uses MongoDB as event data store to implement aggregation features fast, MongoDB may be changed to another database. So far, I've concentrated on API specification, so chocolat just likes skeleton. From now, Data collecting and Aggregation feature should aim high performance, and scalability.

Chocolat will be multi-components service. Even if chocolat is just api server now, but a lot of components (event aggregation service, message queue, ...) will be built.

• Project API
• Multi-Analysis API
• Funnel API
• Testing (Unit test, Integration test)
• Mass event collecting
• Fast event aggregation
• Worker (e.g. Daily Report)
• Dockerize

MIT License. See LICENSE for details.

• Keen.io
• Keen.io open sources contributors