/ansible-netdata

Ansible playbook to install netdata anywhere

Primary LanguageShellBSD 2-Clause "Simplified" LicenseBSD-2-Clause

netdata logo

Ansible Role: netdata

Build Status License Ansible Role GitHub tag

Description

Deploy netdata monitoring system using ansible.

Requirements

  • Ansible >= 2.4

Role Variables

All variables which can be overridden are stored in defaults/main.yml file as well as in table below.

Name Default Value Description
netdata_registry "" Use custom netdata registry
netdata_notifications True Enable email notifications. This feature uses sendmail command for sending emails which isn't configured by this role

Example

Playbook

---
- hosts: all
  roles:
  - jffz.netdata

Local Testing

The preferred way of locally testing the role is to use Docker and molecule (v2.x). You will have to install Docker on your system. See "Get started" for a Docker package suitable to for your system. We are using tox to simplify process of testing on multiple ansible versions. To install tox execute:

pip install tox

To run tests on all ansible versions (WARNING: this can take some time)

tox

To run a custom molecule command on custom environment with only default test scenario:

tox -e py27-ansible25 -- molecule test -s default

For more information about molecule go to their docs.

If you would like to run tests on remote docker host just specify DOCKER_HOST variable before running tox tests.

License

This project is licensed under BSD License. See LICENSE for more details.