Prometheus Grafana Ansible Role

This Ansible role sets up a Grafana server on a Debian system.

• Getting Started
  • Prerequisites
  • Installing
• Usage
• Testing
• Built With
• Versioning
• Authors
• License
• Contributing

Getting Started

Follow these instructions to use the role in your Ansible playbook. It will install a Grafana server on a Debian system.

Prerequisites

Make sure you have Ansible version 2.8.x.x installed. The target system should be a Debian environment.

For testing, it's recommended to use Molecule with Docker as the driver. Use Pipenv version 2018.11.26 and Python 3.

Installing

Add the following to your roles dependency file (e.g., requirements.yml) from GitHub:

- src: http://github.com/idealista/grafana_role.git
  scm: git
  version: 1.6.0
  name: grafana

Or if you prefer, use Ansible Galaxy as the source:

- src: idealista.grafana_role

Then install the role with the ansible-galaxy command:

ansible-galaxy install -p roles -r requirements.yml -f

Use it in your playbook like this:

---
- hosts: someserver
  roles:
    - grafana

Usage

Check the defaults properties file to see the different configuration options available.

You can edit the Grafana configuration and dashboards using either templates or the web interface.

Testing

To test the setup, run the following commands:

pipenv shell
pipenv sync
molecule test

Built With

Versioning

For a list of available versions, see the tags on this repository. You can also check the CHANGELOG.md file to see changes in each version.

Authors

• Idealista - Contributors - idealista

You can view the list of contributors for this project.

License

This project operates under the Apache 2.0 license. See the LICENSE.txt file for more details.

Contributing

If you'd like to contribute, please read CONTRIBUTING.md for our guidelines and the process for submitting pull requests.