grafana
=========

This ansible role installs [Grafana](https://github.com/grafana/grafana) - the open-source platform for monitoring and observability. It can produce charts, graphs, and alerts for the web when connected to supported data sources.

This role installs and configures Grafana from a binary distribution. It also:

- Uploads custom dashboards

- Installs plugins

- Imports public dashboards and data sources

- Allows admin password changes

Supports user creation
 Grafana service requires an environment file at startup, where you can set custom paths for logs (`grafana_log_dir`), data (`grafana_data_dir`), and plugins (`grafana_plugins_dir`). This allows flexible control over Grafana's data storage.

 Requirements
------------

You need `community.grafana` module. 

Role Variables
--------------

```
grafana_user: "grafana"    # user name
grafana_group: "grafana"   # group name
grafana_version: 11.5.0    # version
grafana_port: 3000         # port

# Directory paths  
grafana_dashboard_dir: "/tmp/grafana/dashboards"          # where to copy dashboards from source  
grafana_plugins_dir: "/var/lib/grafana/plugins"           # where to store plugins on target  
grafana_datasource_dir: "/etc/grafana/provisioning/datasources"  # where to store data sources on target  
grafana_log_dir: "/var/log/grafana"                       # where to write logs  
grafana_data_dir: "/var/lib/grafana"                      # where to store Grafana DB  

# Optional configurations  
grafana_users: []                  # array of user names, passwords, and statuses  
grafana_plugins: []                # array of plugins to install  
grafana_public_dashboards: []      # array of public dashboards to import  

# Admin credentials  
admin_api_username: "secret"       # Grafana admin username  
admin_api_password: "secret"       # Grafana admin password  

# Source paths  
dashboard_source_path: "mydir/dashboards"         # path to dashboards on source server  
datasource_source_path: "mydir/datasources"       # path to data sources on source server  
```

Dependencies
------------

None

Example Playbook
----------------

```yaml
---
- name: Converge
  hosts: all
  vars:
    grafana_users:
      - name: "test"
        user_login: "test"
        user_password: "test"
        user_email: "test@mail.ru"
        is_admin: false
    grafana_plugins:
        version: 2.1.8
      - name: aceiot-svg-panel
        version: 0.1.5
    grafana_public_dashboards:
      - name: Node Full Exporter
        id: 1860
        revision: 36
  vars_files:
    - secrets/admin_cred.yml

  roles:
    - role: genlab.grafana
      grafana_version: 11.5.0
      admin_api_username: "{{ grafana.admin_api_username }}"
      admin_api_password: "{{ grafana.admin_api_password }}"
      users: "{{ grafana_users }}"
      plugins: "{{ grafana_plugins }}"
      public_dashboards: "{{ grafana_public_dashboards }}"
      dashboard_source_path: "molecule/default/dashboards"
      datasource_source_path: "molecule/default/datasources"
      grafana_log_dir: "/opt/grafana/data"
      grafana_data_dir: "/opt/grafana/lib"

```

License
-------

BSD

Author Information
------------------

corvus-migratorius@proton.me