x
/
fuel-plugin-lma-collector
Code Issues Proposed changes
fuel-plugin-lma-collector/contrib/ui
History
Simon Pasquier d7c011d613 Fix ShellCheck warnings 
This change fixes all problems reported by ShellCheck [1] which is a
nice linting tool for sh/bash scripts.

[1] http://www.shellcheck.net/about.html

Change-Id: I7104597e309fed5a4d52f5fc39ab0f4350fb3217
 		2015-05-07 10:11:02 +02: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 s/ElasticSearch/Elasticsearch/ where appropriate 2015-04-23 15:50:06 +02:00
run.sh Fix ShellCheck warnings 2015-05-07 10:11:02 +02: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.