``profile::grafana``
====================

This module installs and configures Grafana server.
It requires a SSL cert/key since the server will be provided over HTTPS.

The system uses AD authentication for users and allows anonymous user
with view-only capabilities.


Parameters
----------

===============================  ========  ================================================
**Name**                         **Type**  **Default**
-------------------------------  --------  ------------------------------------------------
vhost                            string    hiera('grafana::vhost', FQDN)
servers                          array     hiera('grafana::influxdb_servers')
admin_groups                     array     hiera('grafana::admin_groups')
editor_groups                    array     hiera('grafana::editor_groups')
admin_pw                         string    hiera('grafana::admin_pw')
cert                             string    hiera('grafana::tls_cert')
key                              string    hiera('grafana::tls_key')
===============================  ========  ================================================


``vhost``
~~~~~~~~~

The hostname through which the server will provide http/https service.
By default it corresponds to the FQDN, but in case of aliases or Round-Robin DNS it can be different.

``servers``
~~~~~~~~~~~

A list of influx db servers url to query for data.
Each server should be specified with a URL like ``http://hostname:8086``.

The list of services will be queried to get the list of available databases and
the corresponding data sources will be automatically created.
The generation of the data sources happens when the list of server files or automatically every day.

``admin_groups``
~~~~~~~~~~~~~~~~

The list of unix groups that will have full (admin) rights when logging into the server.
See `this <http://docs.grafana.org/installation/ldap/>`_ for further details.ls.

``editor_groups``
~~~~~~~~~~~~~~~~~

The list of unix groups that will have editor rights when logging into the server.
See `this <http://docs.grafana.org/installation/ldap/>`_ for further details.

``admin_pw``

Password of the ``admin`` user.

``cert``

SSL public certificate of the HTTPS server.

``key``

Private key matching with the SSL certificate.
