x/fuel-plugin-lma-collector
Code Issues Proposed changes
bc2b258e5e
fuel-plugin-lma-collector/contrib/ui/README.md
Simon Pasquier 51f593692f s/ElasticSearch/Elasticsearch/ where appropriate 
Unlike OpenStack, there is no capital 'S' in Elasticsearch.

Change-Id: I6bd00983d2677a57c0ea080b2fd8226cef56f88f
2015-04-23 15:50:06 +02:00

1.6 KiB
Raw Blame History

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.