73 lines
2.2 KiB
Markdown
73 lines
2.2 KiB
Markdown
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
|
|
----------------
|
|
|
|
See: [converge.yml](molecule/default/converge.yml)
|
|
|
|
License
|
|
-------
|
|
|
|
BSD
|
|
|
|
Author Information
|
|
------------------
|
|
|
|
corvus-migratorius@proton.me
|