x
/
fuel-plugin-lma-collector
Code Issues Proposed changes
fuel-plugin-lma-collector/contrib/ui
History
Simon Pasquier 830ad25364 Add contrib/ directory 
The contrib directory contains scripts to deploy ElasticSearch, InfluxDB
and the visualization dashboards as Docker containers.  Ultimately they
will be superseded by the elasticsearch-kibana and influxdb-grafana
plugins but for the short term, they are handy to validate the LMA
collector plugin itself.

Change-Id: If61b5193f12688974aa74994d967bc95e785d457
 		2015-02-26 15:53:21 +01:00
..
grafana Add contrib/ directory 2015-02-26 15:53:21 +01:00
kibana Add contrib/ directory 2015-02-26 15:53:21 +01:00
Dockerfile Add contrib/ directory 2015-02-26 15:53:21 +01:00
README.md Add contrib/ directory 2015-02-26 15:53:21 +01:00
run.sh Add contrib/ directory 2015-02-26 15:53:21 +01:00

README.md

LMA user interface

Docker container for running the LMA dashboards (Kibana and Grafana).

Build the image

From this directory:

docker build -t lma_ui .

Run the image

docker run -d -p 80:80 --name lma_ui lma_ui

You can pass environment variables to the docker run command to override the default parameters:

  • KIBANA_ENABLED, whether or not to enable the Kibana dashboard (default: "yes").

  • GRAFANA_ENABLED, whether or not to enable the Grafana dashboard (default: "yes").

  • ES_HOST, the address of the ElasticSearch server (default: same host).

  • INFLUXDB_HOST, the address of the InfluxDB server (default: same host).

  • INFLUXDB_DBNAME, the name of the InfluxDB database storing the metrics (default: "lma").

  • INFLUXDB_USER, the username for connecting to the InfluxDB databases (default: "lma").

  • INFLUXDB_PASS, the password for connecting to the InfluxDB databases (default: "lmapass").

If you want to save the Grafana dashboards into InfluxDB, you also need to create a database named 'grafana' on the InfluxDB server. This database needs to be accessible to the InfluxDB LMA user.

Accessing the UI

The dashboards are available at the following URLs:

  • http://<container host>:<public port>/kibana/
  • http://<container host>:<public port>/grafana/

Troubleshooting

If the dashboards fail to display the data or are unresponsive, run the docker logs lma_ui command and check that the ElasticSearch and InfluxDB servers are reachable from the machine running the web browser.