Prometheus Grafana Ansible Role

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

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

Getting Started

Follow these instructions to add the role to your Ansible playbook. After running it, you'll have a Grafana server on a Debian system.

Prerequisites

You need to have Ansible version 2.8.x.x installed. Make sure your server is running a Debian environment.

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

Installation

To add the role to your dependencies (e.g., in requirements.yml), use the following from GitHub:

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

Alternatively, you can use Ansible Galaxy like this:

- src: idealista.grafana_role

Install the role using the Ansible Galaxy command:

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

To use the role in a playbook:

---
- hosts: someserver
  roles:
    - grafana

Usage

Check the defaults file for the configuration options available.

You can configure Grafana and its dashboards using templates or the web interface.

Testing

To test the role, run:

pipenv shell
pipenv sync
molecule test

Built With

Versioning

For available versions, see the tags on this repository.

You can find the changes made in each version in the CHANGELOG.md file.

Authors

• Idealista - Contributors - idealista

Check out the list of contributors who helped with this project.

License

This project uses the Apache 2.0 license. See the LICENSE.txt for more details.

Contributing

Please read CONTRIBUTING.md for our code of conduct and how to submit pull requests.