Skip to content

idealista/prometheus_alertmanager_role

Repository files navigation

Logo

Build Status

Prometheus Alert Manager Ansible role

This ansible role installs an Alert Manager server in a debian environment. The server is installed using the sources.

Getting Started

These instructions will get you a copy of the role for your ansible playbook. Once launched, it will install an Alert Manager server in a Debian system. The role is only compatible with Alert Manager versions greater than 0.13.0.

Prerequisities

Ansible 2.9.x.x version installed. Inventory destination should be a Debian environment.

For testing purposes, Molecule with Docker as driver. Pipenv 2018.11.26 and Python 3 recommended.

Installing

Create or add to your roles dependency file (e.g requirements.yml):

- src: idealista.prometheus_alertmanager_role
  version: 3.0.0
  name: alertmanager

Install the role with ansible-galaxy command:

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

Use in a playbook:

---
- hosts: someserver
  roles:
    - role: alertmanager

Usage

Look to the defaults properties file to see the possible configuration properties.

Alert Manager configuration is separated in 4 blocks (see https://prometheus.io/docs/alerting/configuration/). First one, global configuration, is provided setting the properties for the role. The other ones: routes, inhibit roles and receivers must be provided in 3 separated files. By default this files must be stored in the path defined by this parameter alertmanager_config_parts_path and the filename headed with the position of the block in the final config file. See this folder for example.

Testing

pipenv shell
pipenv sync
molecule test

Built With

Ansible Molecule

Versioning

For the versions available, see the tags on this repository.

Additionaly you can see what change in each version in the CHANGELOG.md file.

Authors

See also the list of contributors who participated in this project.

License

Apache 2.0 Licence

This project is licensed under the Apache 2.0 license - see the LICENSE file for details.

Contributing

Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.