66 lines
2.2 KiB
ReStructuredText
66 lines
2.2 KiB
ReStructuredText
``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.
|