*************************
Configuration for Grafana
*************************

.. image:: ../images/grafana-logo.png
  :width: 300
  :alt: Grafana logo

With Grafana and InfluxDB you can log data from the Gataway and make beautiful graphs and nice dashboards.

The Gateway communicates via MQTT and publishes and listens to a number of topics.
You can integrate this into InfluxDB with Telegraf.

https://docs.influxdata.com/influxdb/v2.1/tools/grafana/

See the topic on the `Grafana example`_ for a simple configuration example.

.. image:: ../images/firmware/grafana/grafana-dashboard-1.png
  :width: 100%
  :alt: Grafana example


You need to add the following in the Telegraf config:

..  code-block:: none

  Topics = [
      “ems-esp/#,
  ]



And tell it that data is set to json;

..  code-block:: none

  Data_format = “json” 


MQTT structure
==============

See `Proddy's EMS-ESP Wiki`_ for all the details on MQTT.


Rest API and Prometheus
=======================

Another way to make Grafana dashboards is with Promotheus and API calls instead of MQTT.
See the other article :ref:`HERE <Configuration for Prometheus>`.



.. target-notes::

.. _`Grafana example`: https://grafana.com/grafana/dashboards/15940

.. _`Proddy's EMS-ESP Wiki`: https://emsesp.github.io/docs/MQTT/