allegro/turnilo

Name: turnilo

Owner: Allegro Tech

Description: Business intelligence, data exploration and visualization web application for Druid, formerly know as Pivot

Forked from: pguzik/swiv

Created: 2017-11-30 10:29:12.0

Updated: 2018-05-24 09:26:54.0

Pushed: 2018-05-24 09:26:53.0

Homepage:

Size: 48289

Language: TypeScript

GitHub Committers

User	Most Recent Commit	# Commits

Other Committers

User	Email	Most Recent Commit	# Commits

README

Turnilo

Turnilo is a business intelligence, data exploration and visualization web application for Druid. Turnilo is a fork of Pivot which is currently available under commercial licence only. This repository was forked from the stalled repository Swiv with the latest version of Pivot under Apache license.

Motivation

Druid is heavily used as business intelligence platform at Allegro. In order to gain wide adoption of non-technical users, Druid requires simple yet powerful user interface. In Allegro we have decided that we are going to continue Pivot development as an open source software, this is how Turnilo emerged.

Manifesto

• High usability for non-technical users over sophisticated but rarely used features.
• Focus on interactive data exploration over static predefined dashboards.
• Outstanding integration with Druid over support for other data sources like SQL databases.
• Focus on data visualizations over Druid cluster or data ingestion management.
• Data cubes configuration as a code over UI editor backed by non-versioned database.
• Stateless over stateful server-side architecture.
• Support for most recent versions of standards compliant browsers.

Features

• Intuitive, drag and drop, gorgeous user interface to visualize Druid datasets
• Fully dedicated to low latency Druid Timeseries, TopN and GroupBy queries.
• Unified view for historical and real-time data
• Blazingly fast

Pre-requisites

• Node.js - LTS version.

:warning: Do not use yarn command for dependency managment and project build, use npm instead. With npm builds are reproducible (thanks to package-lock.json) and even faster than with yarn.

Usage

Install Turnilo distribution using npm.

install -g turnilo

Start off by running an example with Wikipedia page editions dataset and open http://localhost:9090/.

ilo --examples

Or connect to the existing Druid cluster using --druid command line option. Turnilo will automatically introspect your Druid cluster and figure out available datasets.

ilo --druid broker_host:broker_port

Documentation

• Configuration
• Generating Links
• Health checking

Development

Install project dependencies.

install

Build the project.

run build:dev

Run Wikipedia examples.

run start:dev -- --examples

Connect to the existing Druid cluster.

run start:dev -- --druid broker_host:broker_port

Testing

Run all unit tests.

run test

Or run tests separately for common, client and server modules.

run test:common
run test:client
run test:server

Debugging

Client module

In WebStorm\IntelliJ open “Run/Debug Configurations”, click “Add New Configuration”. Next choose “JavaScript Debug” and set URL property to “localhost:9090”.

You can find more information here

Server module

In WebStorm\IntelliJ open “Run/Debug Configurations”, click “Add New Configuration”. Next choose “Node.JS”, set “JavaScript file” to “./bin/turnilo” and “Application parameters” to “–examples”.

You can find more infrmation here

License

Turnilo is published under Apache License 2.0.