[elastic] update readme with info on modifying dashboard

1 files changed, 24 insertions, 0 deletions

diff --git a/elastic/README.md b/elastic/README.md
index fb91e1b..2898fcd 100644
--- a/elastic/README.md
+++ b/elastic/README.md
@@ -14,3 +14,27 @@ Then upload dashboard configs:
 ## Browse Dashboard
 
     https://moose.leap.se/app/kibana#/dashboard/soledad-benchmark
+
+## Changing the Dashboard
+
+Currently, the dashboard is generated from a series of template files that can
+be found in the `templates/` directory. Each graph is a "visualization" which
+is create from a search and different visualization states. Many graphs are
+combined in a "dashboard".
+
+In order to have a new graph in dashboard, you need to:
+
+* maybe create a new search.
+* create a new visualization.
+* add the new visualization to the dashboard.
+
+The way we have been doing is to first create temporary searches,
+visualizations and dashboards by hand in kibana, and then export them and use
+the exported data as a basis to modify the templates in this repository. To
+export these objects, go to the main kibana page, and then click Management ->
+Saved Objects -> Select the appropriate object -> Export.
+
+If you add or modify fields you might also have to update the index pattern. To
+export the index pattern, do the following:
+
+    curl --netrc -X GET https://moose.leap.se:9200/.kibana/dashboard#/benchmark*