ansible.netdata/README.md

Netdata

1. Overview
2. Role Variables
3. Example Playbook
4. Configuration
5. Development
6. License
7. Author Information

Overview

A role to manage Netdata installation and configuration.

Role Variables

• netdata__base_packages : List of base packages in order to provide Netdata [default : netdata].
• netdata__install_recommends : If recommends packages should be install [default : True].
• netdata__deploy_state : The desired state this role should achieve. [default : present].
• netdata__etc_src : Directory used as source to templating /etc/netdata configuration content [default : ../templates/etc/netdata].

Example Playbook

• Use defaults vars :

- hosts: mynode.DOMAIN
  roles:
    - role: ipr-cnrs.netdata
      tags: ['role::netdata', 'ipr']

• Use your own Netdata's configuration as source :

- hosts: mynode.DOMAIN
  roles:
    - role: ipr-cnrs.netdata
      netdata__etc_src: '{{ inventory_dir + "/../resources/host/mynode.DOMAIN/etc/netdata/" }}'

• Ensure your directory contains only templates or sub-directories, such as :

mynode.DOMAIN
└── etc
    └── netdata
        ├── fping.conf.j2
        ├── health_alarm_notify.conf.j2
        ├── netdata.conf.j2
        └── node.d
            ├── named.conf.md.j2
            ├── README.md.j2
            ├── sma_webbox.conf.md.j2
            └── snmp.conf.md.j2

Configuration

This role will :

• Install needed packages to provide netdata service.
• Manage Netdata configuration (/etc/netdata).

Development

This source code comes from our Gogs instance and the Github repo exist just to be able to send the role to Ansible Galaxy…

But feel free to send issue/PR here :)

Thanks to this hook, Github automatically got updates from our Gogs instance :)

License

WTFPL

Author Information

Jérémy Gardais

• Source : on IPR's Gogs
• IPR (Institut de Physique de Rennes)