11Fili Generic Loader Application
22==================================
33
4- This application will automatically configure fili to work with ** any** instance
4+ This application will automatically configure Fili to work with ** any** instance
55 of Druid and show the basic metrics and dimensions. This lets you test what it's
66 like using Fili without putting any effort into setting it up.
77
@@ -13,6 +13,15 @@ Note that this was last tested using [version 0.9.1](https://github.com/yahoo/fi
1313
1414## Setup and Launching
1515
16+ ### Docker
17+ There is a Fili Dockerfile which is available on Dockerhub. To start playing around with Fili, you can download and open Docker. Then
18+ run the command
19+ ``` bash
20+ docker run --name fili-generic-example -i --rm -p 3001:8081 -p 3000:8082 fili:1.0
21+ ```
22+ Once you run this command, please wait a few minutes for Druid and Fili to spin up.
23+
24+ ### Manual
16251 . Have a [ Druid] ( http://druid.io/docs/latest/tutorials/quickstart.html ) cluster running on your Unix based machine.
1726
18272 . Clone this repository to your computer.
@@ -58,26 +67,37 @@ Here are some sample queries that you can run to verify your server:
5867
5968# ## Specific to Wikipedia data
6069
61- - If everything is working, the [query below](http://localhost:9998/v1/data/wikiticker /day/? metrics=deleted& dateTime=2015-09-12/PT24H)
70+ - If everything is working, the [query below](http://localhost:9998/v1/data/wikipedia /day/? metrics=deleted& dateTime=2015-09-12/PT24H)
6271 ` ` ` bash
63- curl " http://localhost:9998/v1/data/wikiticker /day/?metrics=deleted&dateTime=2015-09-12 /PT24H" -H " Content-Type: application/json" | python -m json.tool
72+ curl " http://localhost:9998/v1/data/wikipedia /day/?metrics=deleted&dateTime=2013-08-01 /PT24H" -H " Content-Type: application/json" | python -m json.tool
6473 ` ` `
6574 should show something like:
6675 ` ` `
6776 {
6877 " rows" : [{
69- " dateTime" : " 2015-09-12 00:00:00.000" ,
70- " deleted" : 394298.0
78+ " dateTime" : " 2013-08-01 00:00:00.000" ,
79+ " deleted" : -39917308
7180 }]
7281 }
7382 ` ` `
7483
75- - Count of edits by hour for the last 72 hours:
76-
77- GET http://localhost:9998/v1/data/wikiticker/day/? metrics=count& dateTime=PT72H/current
78-
79- Note: this will should be something like the response below since the
80- wikiticker table doesn' t have data for the past 72 hours from now.
84+ If you see this message while running Docker it means that Druid isn' t ready yet:
85+
86+ ```json
87+ {
88+ "rows": [],
89+ "meta": {
90+ "missingIntervals": ["2013-08-01 00:00:00.000/2013-08-02 00:00:00.000"]
91+ }
92+ }
93+ ```
94+
95+ - Count of edits by hour for the last 72 hours:
96+
97+ GET http://localhost:9998/v1/data/wikipedia/day/?metrics=count&dateTime=PT72H/current
98+
99+ Note: this will should be something like the response below since the
100+ wikipedia table doesn' t have data for the past 72 hours from now.
81101 ` ` ` json
82102 {
83103 " rows" : [],
@@ -87,14 +107,14 @@ Here are some sample queries that you can run to verify your server:
87107 }
88108 ` ` `
89109
90- - Show [debug info](http://localhost:9998/v1/data/wikiticker /day/?format=debug&metrics=count&dateTime=PT72H/current),
110+ - Show [debug info](http://localhost:9998/v1/data/wikipedia /day/? format=debug& metrics=count& dateTime=PT72H/current),
91111 including the query sent to Druid:
92112
93- GET http://localhost:9998/v1/data/wikiticker /day/?format=debug&metrics=count&dateTime=PT72H/current
113+ GET http://localhost:9998/v1/data/wikipedia /day/? format=debug& metrics=count& dateTime=PT72H/current
94114
95115# # Notable Restrictions
96116
97- - Using this is great for testing out fili and druid, but it can' t do interesting things with metrics.
117+ - Using this is great for testing out Fili and druid, but it can' t do interesting things with metrics.
98118- This can only use 1 timegrain even though a datasource in druid *could* have more.
99119
100120## Importing and Running in IntelliJ
0 commit comments